Monitoring & troubleshooting¶
The dashboard¶
The Data Enrichment Dashboard shows runs over time, the success rate, People
Searches, enriched fields and a list of problem runs. Every run is an
EnrichmentRun__c record with status, phase, timestamps and error message.
When a run fails¶
- Check the failed-runs list on the dashboard.
- Open the run record and read the error message and HTTP status.
- Fix the cause and press Retry on the record.
Missing minimum data is the most common cause (for a Lead: first name, last name, company).
Slack alerts
On agent failures the team also gets a Slack alert with a link to the failing workflow execution, so problems surface without watching the dashboard.
Common issues¶
People search failed (HTTP 400)¶
The n8n workflow could not complete the people search. The usual cause is a community node (Apify, SerpAPI, OpenRegister) being unavailable on the n8n instance, for example after a restart. The workflow is built to return a clean message instead of a raw error, so if you see "people search is temporarily unavailable" try again shortly. If it persists, an admin should check that the community nodes are installed on the n8n instance.
The contact support form could not be sent¶
The help center's Contact Support form emails the Aviando team. If sending fails, the most common cause is org Email Deliverability being set below All email (a common sandbox default). Set Setup → Deliverability → Access level = All email and try again. The error message now includes the underlying platform reason.
Values arrive but a picklist field stays empty¶
The source value doesn't match a picklist value in your org. Add a value mapping from the source value to your picklist value.
Nothing happens on a new record¶
Check that enrich-on-creation is enabled for that object and that neither the global pause nor the per-object pause is on. See Configuration.
Where to look¶
| Symptom | Where |
|---|---|
| Run failed or timed out | Dashboard → failed runs, then the EnrichmentRun__c record |
| Field not filled | The record's Enrichment tab and value mappings |
| Webhook rejected (403) | The webhook secret on both sides |
| People search errors | Community nodes on the n8n instance |