Configure Ice Breakers & Commands

Step-by-step setup and testing of ice breakers and commands.

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 200 quickly

Configure in WhatsApp Manager

  1. Open WhatsApp Manager in Meta Business Manager.
  2. Go to Account Tools → Phone Numbers.
  3. Click Settings (gear icon) for the target phone number.
  4. Under Automations, open Conversational Components.
  5. Add/update Ice Breakers (up to 4 items).
  6. Add/update Commands (up to 30 items).
  7. 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:

  1. Open chat with your business number.
  2. 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.
  3. Start a new chat thread with the business number.
  4. 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:

  1. Confirm the webhook verify token and inbound webhook POST payload validation are correct.
  2. Confirm callback URL is reachable over HTTPS and returns HTTP 200.
  3. Confirm no old chat thread remains when testing ice breakers.
  4. Confirm command/ice-breaker limits are respected (length and count).
  5. 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.

Related

  • Ice Breakers & CommandsIce breakers and slash commands for WhatsApp business numbers, plus the removal of request_welcome. (Note: for interactive buttons/lists/carousels, see Interactive Service Messages.)
  • Messaging WebhookReal-time webhook events for inbound messages, delivery statuses, and errors.
Browse more docsStart Free Trial