---
title: "Configure Conversational Automation"
method: POST
path: "/{Version}/{Phone-Number-ID}/conversational_automation"
tags: ["Conversational Automation"]
---

# Configure Conversational Automation

`POST /{Version}/{Phone-Number-ID}/conversational_automation`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Phone-Number-ID}/conversational_automation`
- Auth: HTTP bearer

Configure conversational automation settings for a WhatsApp Business Account phone number,
including welcome messages, conversation prompts (ice breakers), and bot commands.


**Use Cases:**
- Set up automated welcome messages for new customer conversations
- Configure conversation prompts to guide customer interactions
- Define bot commands for common customer service scenarios
- Update existing automation settings
- Enable or disable specific automation features


**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.


**Validation:**
- Command names must be unique within the same phone number
- Prompts and command descriptions must comply with WhatsApp Business policies
- Maximum limits are enforced for prompts and commands

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- ConversationalAutomationRequest: Request payload for configuring conversational automation settings
  - `enable_welcome_message` boolean: Whether to enable welcome messages for new conversations
  - `prompts` string[]: List of conversation prompts (ice breakers) to help guide customer interactions
  - `commands` BotCommand[]: List of bot commands for automated responses
    - `command_name` string, required: Name of the bot command (without leading slash)
    - `command_description` string, required: Description of what the command does

## Response `200`

Successfully configured conversational automation settings

- ConversationalAutomationResponse: Response after successfully configuring conversational automation
  - `success` boolean, required: Indicates whether the automation configuration was successful

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Phone number ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)