Prerequisites
Before configuration:
- Phone number is active on your WABA
- You have admin access to WhatsApp Manager for that number
- Your webhook endpoint is reachable and returning
HTTP 200quickly
Configure in WhatsApp Manager
- Open WhatsApp Manager in Meta Business Manager.
- Go to Account Tools → Phone Numbers.
- Click Settings (gear icon) for the target phone number.
- Under Automations, open Conversational Components.
- Add/update Ice Breakers (up to 4 items).
- Add/update Commands (up to 30 items).
- Save changes.
If Conversational Components are not editable, ask the Business Portfolio/WABA admin to grant the required access.
Test Procedure
After configuration, test in the WhatsApp mobile app:
- Open chat with your business number.
- For ice-breaker tests, clear the existing thread first: open the chat, tap the business profile, select Clear Chat → Clear All Messages, then delete the chat.
- Start a new chat thread with the business number.
- Send a message to the business number to test.
Expected Test Results
Ice Breaker Tap
Standard inbound text message with messages[].text.body equal to the selected prompt text.
Command Usage
Standard inbound text message with messages[].text.body starting with /.
Troubleshooting
If tests do not behave as expected:
- Confirm the webhook verify token and inbound webhook POST payload validation are correct.
- Confirm callback URL is reachable over HTTPS and returns
HTTP 200. - Confirm no old chat thread remains when testing ice breakers.
- Confirm command/ice-breaker limits are respected (length and count).
- Re-open Conversational Components in WhatsApp Manager and verify the saved values.
Meta no longer supports Welcome Messages or the request_welcome webhook. Opening a chat without sending a message does not generate an event.
Dualhook Boundary
Dualhook has no setting for conversational components and no Runtime API route for conversational_automation. Configure them in WhatsApp Manager as above, or through Meta's API from your own Meta app (see Ice Breakers & Commands). Dualhook does not read the resulting inbound messages; they reach your endpoint through Webhook Override.