⚠️ Possible Errors & Troubleshooting Guide for WhatsApp Flow Setup in Acele

---

❌ Error: Flow is not triggering when the keyword is sent

Cause:
The keyword might not be properly assigned to the bot flow.

Fix:

• Go to Bot Manager → Bot Reply
• Edit the relevant reply and ensure the correct WhatsApp Flow is mapped to the keyword
• Also, ensure the keyword exactly matches the trigger phrase

---

❌ Error: User receives template message, but 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
• Ensure the button is linked to the right Bot Flow ID

---

❌ Error: Flow is not appearing in Live Chat for manual trigger

Cause:

• Flow may not be published or may belong to another bot

Fix:

• Go to WhatsApp Flows, confirm the flow is published
• Ensure it’s assigned to the correct bot
• It must be saved and active to appear in the Live Chat panel

---

❌ Error: WhatsApp Flow Not Received After Form Submission

Cause:

• Webhook not configured properly in Elementor
• Incorrect mapping of fields
• WhatsApp number not in correct format (e.g., missing country code)

Fix:

• Double-check that the Webhook URL is added under “Actions After Submit” in Elementor form settings
• Confirm that the phone number field includes the full international format (e.g., +91XXXXXXXXXX)
• Verify that the WhatsApp Flow is properly attached to the Bot Flow and that the template button action is set to “Start Bot Flow”

---

❌ Error: Webhook Data Not Captured in Acele

Cause:

• Form not submitted with valid data
• Incorrect field labels or structure in Elementor form
• Skipped test submission to pull raw data

Fix:

• Submit the form once with test values to populate raw data in Acele
• Ensure form field labels match expected inputs (e.g., name, phone)
• Refresh the Webhook Workflow panel in Acele and click “Capture Webhook Response” again

---

❌ Error: WhatsApp Template Not Triggered

Cause:

• Template is unapproved or inactive
• Template lacks CTA/Quick Reply button

Fix:

• Go to WhatsApp Template Manager and ensure the selected template is approved and active
• Confirm it includes at least one CTA or Quick Reply button
• Re-map the webhook with the correct template selection

---

❌ Error: WhatsApp Flow Triggered, But No Messages Sent

Cause:

• Flow was triggered during an inactive 24-hour window without a template
• WhatsApp number is not yet subscribed

Fix:

• Use a template message to initiate conversations outside the 24-hour window
• Ensure the number is subscribed to your WhatsApp Business Account

---

❌ Error: Delay Not Working

Cause:

• Delay setting not configured in bot flow
• Misplaced Delay Block in flow builder

Fix:

• Edit the WhatsApp Bot Flow and insert a Delay Element before the WhatsApp Flow trigger
• Configure delay time properly (e.g., 5 seconds, 1 minute)
• Save and test again

---

✅ Tip: Use Acele Logs

Navigate to Webhook Logs under the Webhook Workflow dashboard to check:

• Whether the webhook was received
• Timestamp of delivery
• Payload preview
• Any failures in field mapping or delivery