Skip to content

WhatsApp troubleshooting

Fix Meta WhatsApp connection, template, and messaging window issues.

Problem

WhatsApp cannot connect, template sends fail, or customer replies do not appear in Messages.

Cause

  • Meta WhatsApp not connected or webhook verify token mismatch
  • Template not approved or not mapped for use
  • Messaging outside an allowed customer care window without a template
  • Provider / business verification still pending

Solution

  • Re-check Settings → Messaging & Delivery → WhatsApp against the Meta guide
  • Use an approved template when required
  • Confirm inbound webhooks reach Zyelra
  • Retry after Meta verification or template approval completes

When to contact support

Contact support if Meta shows delivered webhooks but Zyelra never receives inbound WhatsApp messages with a verified callback configuration.

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.

  • Meta WhatsApp

    Connect WhatsApp Business via Meta Embedded Signup in Zyelra, map Meta-approved templates, and receive signed webhooks.

  • Message templates

    Create and manage reusable message templates for faster, consistent outreach.

  • Delivery statuses

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