Quick diagnosis flowchart
Before going through each issue in detail, run through this quick checklist:| Symptom | Most likely cause | Where to check |
|---|---|---|
| No text-back after a missed call | Phone setup incomplete | Phone Setup |
| Leads not appearing | Forwarding not active at carrier | Phone Setup |
| AI not replying | Billing inactive or plan mismatch | Billing and Plan |
| SMS sending but no AI conversation | Plan does not include AI SMS | Usage and Limits |
| Features locked or redirecting | Billing blocked | Billing and Plan |
| Setup prompts still showing | Onboarding incomplete | Onboarding |
Common issues
Missed calls are not triggering text-back
Missed calls are not triggering text-back
This is the most common issue. Check the following in order:
- Is your Avidra number active? Go to Phone Setup and verify the Twilio-backed number exists.
- Is the number mapped to your workspace? The called number must be linked to your active workspace.
- Is forwarding enabled? If using forwarding mode, confirm forwarding is active at your phone carrier — not just in Avidra settings.
- Did the call reach a final missed state? If you picked up and then hung up, that may not register as a missed call.
- Was the call already processed? Avidra skips duplicate calls from the same number within a short window.
- Did voice recovery handle the call? If voice recovery answered, SMS text-back is skipped.
No SMS is being sent
No SMS is being sent
If no SMS is going out at all, check in this order:
- Billing status — is it active? → Billing and Plan
- Plan support — does your plan include the messaging type you expect?
- Daily SMS cap — have you hit the daily limit? → Usage and Limits
- Twilio number — is it provisioned correctly in Phone Setup?
- AI toggle — is AI globally disabled? → AI Behavior
- Recovery channels — is text-back enabled? → Recovery Channels
Twilio or phone number setup issues
Twilio or phone number setup issues
Common signs:
- Missed calls do not generate leads
- Inbound SMS does not attach to the workspace
- Test calls do not behave like live calls
- Dashboard shows setup incomplete or unresolved checks
- Business phone number is correct in settings
- Avidra/Twilio number is active and provisioned
- Routing mode matches your actual setup (forwarding vs. Avidra number)
- Forwarding is configured at the carrier level (not just in Avidra)
- Verification checks in Phone Setup are all green
Lead does not appear in dashboard
Lead does not appear in dashboard
Check whether:
- The missed call actually triggered recovery — did the caller’s phone receive a text?
- The number belongs to the expected workspace
- The lead is stored but filtered out in the Leads view — try clearing filters
- Onboarding or setup is still incomplete
- The call was skipped due to an already-processed or duplicate state
- The monthly lead cap has been reached
Conversation is not continuing
Conversation is not continuing
If a customer replies but the thread does not continue:
- Did the inbound message attach to an existing lead? Check for unmatched replies in the Conversations view.
- Is the conversation auto-closed? Stale conversations are closed after inactivity.
- Has the AI turn limit been reached? Avidra caps the number of AI turns per thread.
- Is AI enabled? Check both globally and for this specific conversation → AI Behavior
- Is billing active? → Billing and Plan
- Is the daily SMS cap reached? → Usage and Limits
Billing or plan restrictions
Billing or plan restrictions
Billing and plan restrictions can look like product failures. Look for:
- Redirects to pricing page when opening tabs
- Locked Conversations or Booking tabs
- Inability to send manual follow-up
- AI reply skipped behavior
- Usage warnings in the dashboard
Notifications not arriving
Notifications not arriving
If you expect alerts but are not receiving them:
- Check the notification email/phone number in Notifications — is it correct?
- Check your email spam folder
- Verify the notification type is enabled (email, SMS, emergency, daily summary)
- Test with a real missed call and verify the alert fires
- If using SMS alerts, confirm the destination phone number is valid and can receive SMS
When to escalate to support
Escalate when you have verified setup, billing, and plan state, but the problem persists:- Twilio routing looks correct but missed-call recovery never starts
- Inbound SMS is received by Twilio but never appears in Avidra
- A workspace number appears mismapped to the wrong workspace
- Repeated delivery or webhook failures that cannot be explained by settings
- Production conversations failing in a pattern operators cannot resolve
What to include when escalating
Including these details helps the support team diagnose your issue faster.
- Workspace name
- Affected phone number (both your business number and Avidra number)
- Approximate time of the call or SMS
- Whether the issue affects all calls or only some
- What you have already checked (phone setup, billing, plan limits)
- Screenshots of the relevant dashboard, leads, or settings state
