---
title: "⚠️Possible Errors & Troubleshooting Guide for whatsapp flow setup in waatee"
description: "## **❌****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…"
url: "https://docs.waatee.com/docs/%e2%9a%a0%ef%b8%8fpossible-errors-troubleshooting-guide-for-whatsapp-flow-setup-in-waatee/"
updated: "2025-06-10"
category: Bot Channel / WhatsApp Advanced
---

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

## **❌****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 waatee**

**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 waatee.
- Ensure the form field labels match the expected input for the WhatsApp flow (e.g., ***name, phone***).
- Refresh the webhook workflow panel in waatee 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 waatee 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