⚠️Possible Errors & Troubleshooting Guide for whatsapp flow setup in BotSailor

❌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 that the button is linked to the right Bot Flow ID.

❌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

●       Assigned to the correct bot.

●       It must be saved and active to show 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 full international format (e.g., +8801xxxxxxxxx).
• 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 BotSailor

Cause:

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

Fix:

• Submit the form once with test values to populate raw data in BotSailor.
• Ensure the form field labels match the expected input for the WhatsApp flow (e.g., name, phone).
• Refresh the webhook workflow panel in BotSailor and click “Capture Webhook Response” again.

❌ Error: WhatsApp Template Not Triggered

Cause:

• You used an unapproved or inactive template
• 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 sent during an inactive 24-hour window without template
• WhatsApp number is not yet subscribed

Fix:

• Use a template message to initiate conversation for users 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 (e.g., 5 seconds, 1 minute) properly.
• Save and test again.

✅ Tip: Use BotSailor 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