⚠️ Common Errors & Troubleshooting Guide for WhatsApp Flow Setup in XpressBot
Set up issues with WhatsApp Flows in XpressBot can often be traced to simple configuration errors. This guide helps you identify the root causes and apply the correct fixes quickly to keep your automation running smoothly. Below are the most common errors and their solutions.
❌ Error 1: Flow Not Triggering When Keyword Is Sent
Cause:
The keyword is not correctly mapped to the assigned bot flow.
Fix:
- Go to Bot Manager → Bot Reply
- Edit the response and link the correct WhatsApp Flow
- Ensure the keyword exactly matches the trigger phrase (case-sensitive)
❌ Error 2: Template Message Received, But Button Doesn’t Trigger the Flow
Cause:
The CTA button in the template is not mapped to any bot flow.
Fix:
- Navigate to WhatsApp Webhook Workflow → Template Mapping
- Link the button to the correct Bot Flow ID
❌ Error 3: Flow Not Appearing in Live Chat for Manual Trigger
Cause:
The flow is not published or is assigned to a different bot.
Fix:
- Go to WhatsApp Flows
- Confirm the flow is published, active, and assigned to the right bot
- Only published and assigned flows will appear in the Live Chat interface
❌ Error 4: WhatsApp Flow Not Received After Form Submission
Cause:
- Webhook not configured correctly in Elementor
- Field mapping errors
- Phone number format is invalid
Fix:
- Under Actions After Submit in Elementor, add the correct Webhook URL
- Use full phone format (e.g.,
+91xxxxxxxxxx) - Make sure the template button action is set to Start Bot Flow
❌ Error 5: Webhook Data Not Captured in XpressBot
Cause:
- No test submission
- Form field labels do not match expected inputs
- Workflow not updated
Fix:
- Submit a form with test values to populate data
- Match all field labels (e.g.,
name,phone) as per flow expectations - Click “Capture Webhook Response” in the Webhook panel after refreshing
❌ Error 6: WhatsApp Template Not Triggered
Cause:
- Unapproved or inactive template
- Missing CTA/Quick Reply buttons
Fix:
- Go to Template Manager and check template status
- Ensure the template includes at least one CTA or Quick Reply button
- Reconnect the correct template in the webhook settings
❌ Error 7: WhatsApp Flow Triggered, But No Messages Sent
Cause:
- Triggered outside of WhatsApp’s 24-hour rule without a template
- The user’s number is not subscribed to your WhatsApp Business
Fix:
- Use a template message to start conversations outside 24-hour window
- Confirm user number is subscribed and valid
❌ Error 8: Delay Function Not Working
Cause:
- Delay block is missing or incorrectly placed
- Delay time not configured properly
Fix:
- Add a Delay Element before the action in your bot flow
- Set a valid delay time (e.g., 5 seconds, 1 minute)
- Save changes and test thoroughly
✅ Pro Tip: Monitor Issues Using Bot Logs
Use Webhook Logs in the Webhook Workflow section to:
- Check if the webhook was received
- View the exact timestamp
- Review payload data
- Spot issues in field mapping or delivery failures