​
Preview

You can preview and test your bot by clicking the Preview button in the editor and changing the runtime to “WhatsApp”.

​
WhatsApp Preview Dropdown

  • Select “WhatsApp” from the runtime options to simulate the bot’s behavior in the WhatsApp environment.

​
Limitations

When building your bot for WhatsApp, consider the following restrictions:

  • Unsupported Media:

    • GIF and SVG image files are not supported.
    • Only .mp4 videos are supported. Refer to the Supported Media Types for more details.

  • Button Limitations:

    • Button content cannot exceed 20 characters. Content exceeding this limit will be truncated.
    • WhatsApp displays only 3 buttons at a time. To include more buttons, the system adds ”…” messages to show additional options.

  • Skipped Blocks: Certain blocks are incompatible with WhatsApp and will be ignored:

    • Payment input block
    • Chatwoot block
    • Script or Set Variable block with Execute on client option enabled
    • Google Analytics block
    • Meta Pixel block
    • Cal.com block

​
Contact Information

To assign contact details such as name and phone number to variables, use a Set Variable block with dedicated system values. These variables can automatically store:

  • Contact name
  • Phone number

​
Deploy on Your Phone Number

To integrate your agent with WhatsApp:

  1. Go to the Integrations tab of your agent’s flow editor.
  2. Click the WhatsApp button.
  3. Follow the provided instructions to complete the integration.

​
Configuration

​
Session Expiration Timeout

  • Define a timeout value (from 0 to 48 hours) for the session.
  • If a user remains inactive beyond this timeout, their session expires, and a new conversation starts upon their next message.
  • Default: 4 hours.

​
Start Bot Condition

  • Configure a condition to trigger the bot when a user starts a conversation.
  • If the condition is unmet, the bot will not be activated.

​
Collect Position

You can request the user’s location with a basic Text input block. The collected position will be saved as a variable in the format:

<LAT>, <LONG>

​
Example Flow

User > Bot > Position Collection

​
Validation and Testing

Before deployment, ensure:

  1. All limitations are addressed (e.g., button length, media types).
  2. The Set Variable block is properly configured for contact details.
  3. The bot operates seamlessly in WhatsApp’s runtime environment.

Note: Always test your bot thoroughly in the WhatsApp Preview mode to verify compatibility and performance.

​
FAQ