# Conversational Components

Endpoints for conversational automation

## Get Conversational Automation

> Retrieve conversational automation fields and configuration for a phone number.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.38.1"},"tags":[{"name":"Conversational Components","description":"Endpoints for conversational automation"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"conversational_components.GetConversationalAutomationResponse":{"description":"Response payload containing conversational automation configuration for a phone number","properties":{"conversational_automation":{"$ref":"#/components/schemas/conversational_components.ConversationalAutomation"},"id":{"type":"string"}},"type":"object"},"conversational_components.ConversationalAutomation":{"properties":{"commands":{"items":{"$ref":"#/components/schemas/conversational_components.Command"},"type":"array","uniqueItems":false},"enable_welcome_message":{"type":"boolean"},"id":{"type":"string"},"prompts":{"items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"conversational_components.Command":{"properties":{"command_description":{"type":"string"},"command_name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/conversational_automation":{"get":{"description":"Retrieve conversational automation fields and configuration for a phone number.","operationId":"get-conversational-automation","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/conversational_components.GetConversationalAutomationResponse"}}},"description":"Conversational automation retrieved successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Get Conversational Automation","tags":["Conversational Components"]}}}}
```

## Configure Conversational Automation

> Configure conversational automation settings for a phone number.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.38.1"},"tags":[{"name":"Conversational Components","description":"Endpoints for conversational automation"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"conversational_components.ConfigureConversationalAutomationRequest":{"description":"Request payload to configure conversational automation settings","properties":{"commands":{"items":{"$ref":"#/components/schemas/conversational_components.Command"},"type":"array","uniqueItems":false},"enable_welcome_message":{"type":"boolean"},"prompts":{"items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"conversational_components.Command":{"properties":{"command_description":{"type":"string"},"command_name":{"type":"string"}},"type":"object"},"conversational_components.ConfigureConversationalAutomationResponse":{"description":"Response payload for successful conversational automation configuration","properties":{"success":{"type":"boolean"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/conversational_automation":{"post":{"description":"Configure conversational automation settings for a phone number.","operationId":"configure-conversational-automation","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"$ref":"#/components/schemas/conversational_components.ConfigureConversationalAutomationRequest","summary":"requestBody","description":"Conversational automation configuration"}]}}},"description":"Conversational automation configuration","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/conversational_components.ConfigureConversationalAutomationResponse"}}},"description":"Conversational automation configured successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Configure Conversational Automation","tags":["Conversational Components"]}}}}
```