Skip to content

SMS troubleshooting

Resolve Twilio or Termii SMS delivery and configuration problems.

Problem

SMS messages fail to send or never show delivery progress.

Cause

  • Twilio or Termii not connected / missing webhook
  • Provider account lacks credit, sender ID, or geographic permissions
  • Destination number format invalid for the provider
  • Provider requirements (verification) not completed

Solution

  • Open Settings → Messaging & Delivery → SMS and verify the connection
  • Confirm webhooks match the Zyelra communications webhook paths in the provider guide
  • Test with a known-good number in the correct country format
  • Check Twilio or Termii consoles for rejects, then fix sender configuration

When to contact support

Contact support after the provider console shows accepted messages but Zyelra never updates delivery status despite a correct webhook.

Next step

Jump to another problem area if this guide did not resolve the issue.

Browse troubleshooting topics →

Related guides

  • Messaging troubleshooting

    Diagnose unified inbox send/receive problems before diving into email, SMS, or WhatsApp specifics.

  • Twilio SMS

    Connect Twilio Account SID, Auth Token, and an SMS-capable number or Messaging Service so Zyelra can send SMS and receive delivery status webhooks.

  • Termii SMS

    Connect a Termii API key, regional base URL, and approved sender ID for SMS — common for Nigeria and other Termii-supported regions.

  • Delivery statuses

    Understand message delivery statuses from queued through delivered, read, failed, or bounced.