If you encounter issues while setting up your automation, use this guide to identify the cause and apply the fix.
❌ Flow Issues
Error: Flow is not triggering when the keyword is sent
- Cause: The keyword might not be properly assigned or matched to the bot flow.
- Fix: Go to Bot Manager → Bot Reply. Edit the relevant reply and ensure the correct flow is mapped to the keyword. Also, ensure the keyword exactly matches your trigger phrase.
Error: User receives a template message, but the button does not trigger the flow
- Cause: The CTA button in the template is not linked to a bot flow.
- Fix: Go to WhatsApp Webhook Workflow → Template Mapping and ensure the button is linked to the correct Bot Flow ID.
Error: Flow is not appearing in Live Chat for a manual trigger
- Cause: The flow may not be published or belongs to a different bot.
- Fix: Go to WhatsApp Flows and confirm the flow is published, saved, and assigned to the correct bot.
❌ Webhook & Integration Issues (e.g., Elementor)
Error: WhatsApp Flow not received after form submission
- Cause: Webhook not configured in your form settings, incorrect field mapping, or wrong phone format.
- Fix: Double-check that the Webhook URL is added under “Actions After Submit” in your form settings. Confirm phone numbers use the full international format (e.g., +1XXXXXXXXXX).
Error: Webhook data not captured in Zoe Agent
- Cause: Form submitted with invalid data or you skipped the test submission.
- Fix: Submit the form once with test values to populate raw data. Ensure form field labels match your expected inputs (e.g., name, phone) and click “Capture Webhook Response” again.
❌ Template & Delivery Issues
Error: WhatsApp template not triggered
- Cause: Using an unapproved template or it lacks a CTA/Quick Reply button.
- Fix: Check the Template Manager to ensure the template is approved and active. Confirm it includes at least one button.
Error: Flow triggered, but no messages were sent
- Cause: Trying to send a standard message outside the 24-hour window or the user isn’t subscribed.
- Fix: Use a template message to initiate conversations for users outside the 24-hour window.
Error: Delay not working
- Cause: Delay block is missing or misplaced in the flow builder.
- Fix: Edit the flow and insert a Delay Element before the trigger. Configure the time (e.g., 5 seconds) and save.
✅ Pro Tip: Use Zoe Agent Logs
Navigate to Webhook Logs under the Webhook Workflow dashboard to verify:
- If the webhook was received.
- The exact timestamp of delivery.
- A preview of the data payload.
- Any specific failures in field mapping or delivery.
