Skip to main content
Before debugging, have these ready: your phone number, the channel status in your OpenCX dashboard, and a recent message if available.
Looking for setup steps? See Create SMS Agent. For routing logic, see SMS Flow. For US number registration, see US Number Compliance.

Common Troubleshooting Scenarios

SymptomLikely causeWhat to do
No AI replyAutopilot disabled for SMSEnable under your org’s Autopilot settings.
Message not in inboxSMS delivery not configured correctlyRe-enable SMS on the number under Channels → SMS and save.
”Phone number not found or not verified”Number not in verified-numbers listVerify the number under Settings → Phone Numbers first.
Outbound texts blocked by carrierMissing 10DLC registration (US local numbers)Complete 10DLC brand and campaign registration. See US Number Compliance.
Reply contains raw HTMLUnusual AI outputThis should not happen — contact support.
None of the aboveContact support via your OpenCX dashboard. Include your number, channel status, and a recent message.
If texts are not arriving in your OpenCX dashboard, the problem is almost always the number configuration — not a platform outage.

Limits

AreaDetail
Inbound deliveryNear-instant once the carrier delivers.
AI processingTypically seconds — depends on complexity and knowledge lookups.
Session auto-resolutionApproximately 3 hours of inactivity (org-level overrides possible).
Concurrent AI repliesOne reply processed per session at a time.

Create SMS Agent

Re-check number verification and channel setup.

SMS Flow

Re-check session matching and delivery path.

US Number Compliance

Carrier blocking? Check 10DLC and toll-free registration.

Autopilot And Topics

Verify channel-level Autopilot and topic rules.