Integration troubleshooting
| Symptom | Check first | Next action |
|---|---|---|
| Telephony credentials rejected | Account ID, key/secret, provider region | Regenerate credentials and validate again |
| Outbound call does not start | Number ownership, balance, destination permission, active agent | Place one provider-console test |
| Google Sheet imports zero rows | Sharing mode, tab, phone-column mapping | Preview and validate phone numbers |
| Google sync is rate limited | Last sync and configured frequency | Wait, then use one manual sync |
| IndiaMART has no new leads | Seller API key and last-sync message | Verify the key in the seller portal |
| Meta assets missing | OAuth user permissions and selected Business | Reconnect and reselect assets |
| Meta test lead missing | Page/form subscription and leadgen webhook | Create a fresh test lead |
| WhatsApp inbound missing | Number, webhook verify token, subscription | Re-run Meta webhook validation |
| Webhook signature fails | Raw body, secret, hex comparison | Log body hash, not the secret |
| Webhook becomes degraded | Delivery log status/timeout | Fix receiver, test, then re-enable |
When escalating, include integration type, approximate time and timezone, affected record ID, visible status/error, and whether a controlled retry reproduced it. Never include API keys, secrets, or access tokens.