# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Twilio Configuration API version: 1.0.0 extends: openapi/twilio-configuration-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 11 - target: $.paths['/v1/Configuration'].get update: x-apievangelist-phrasing: intent: Get account-wide Conversations settings effect: read questions: - What are the default Conversations settings on my account? - Which conversation service and inactivity timers are my conversations using by default? instructions: - text: Show my account's global Conversations configuration. - text: Get the default conversation service and timers for Conversations. method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration'].post update: x-apievangelist-phrasing: intent: Change default Conversations settings effect: write questions: - Can I make conversations go inactive automatically after a period of silence? - How do I change which conversation service new conversations are created in by default? - Is there a minimum time before a conversation can be closed automatically? instructions: - text: Set the default Conversations service to {default_chat_service_sid}. slots: default_chat_service_sid: requestBody.DefaultChatServiceSid - text: Mark conversations inactive after {default_inactive_timer} and close them after {default_closed_timer}. slots: default_inactive_timer: requestBody.DefaultInactiveTimer default_closed_timer: requestBody.DefaultClosedTimer - text: Use messaging service {default_messaging_service_sid} as the Conversations default. slots: default_messaging_service_sid: requestBody.DefaultMessagingServiceSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Addresses'].get update: x-apievangelist-phrasing: intent: List Conversations address configurations effect: read questions: - Which phone numbers and WhatsApp addresses are set up to auto-create conversations? - Can I list only my WhatsApp address configurations? instructions: - text: List all my Conversations address configurations. - text: Show address configurations of type {type}. slots: type: query.Type method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Addresses'].post update: x-apievangelist-phrasing: intent: Configure an address for Conversations effect: write questions: - How do I make incoming SMS to a number start a new conversation automatically? - Can new messages to a WhatsApp address trigger a Studio flow or webhook? instructions: - text: Configure {type} address {address} for Conversations. slots: type: requestBody.Type address: requestBody.Address - text: Set up {type} address {address} to auto-create conversations and post to webhook {webhook_url}. slots: type: requestBody.Type address: requestBody.Address webhook_url: requestBody.AutoCreation.WebhookUrl - text: Route new messages on {type} address {address} to Studio flow {studio_flow_sid}. slots: type: requestBody.Type address: requestBody.Address studio_flow_sid: requestBody.AutoCreation.StudioFlowSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Addresses/{Sid}'].get update: x-apievangelist-phrasing: intent: Get one address configuration effect: read questions: - How is auto-creation set up for one particular phone number or WhatsApp address? - Can I look up an address configuration by the address itself instead of its SID? instructions: - text: Get address configuration {sid}. slots: sid: path.Sid - text: Show the Conversations setup for address {sid}. slots: sid: path.Sid method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Addresses/{Sid}'].post update: x-apievangelist-phrasing: intent: Update an address configuration effect: write questions: - Can I turn off automatic conversation creation for an address I already configured? - How do I point an existing address configuration at a different webhook URL? instructions: - text: Set auto-creation enabled to {enabled} on address configuration {sid}. slots: enabled: requestBody.AutoCreation.Enabled sid: path.Sid - text: Change the auto-creation webhook on existing address configuration {sid} to {webhook_url}. slots: sid: path.Sid webhook_url: requestBody.AutoCreation.WebhookUrl - text: Rename address configuration {sid} to {friendly_name}. slots: sid: path.Sid friendly_name: requestBody.FriendlyName method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Addresses/{Sid}'].delete update: x-apievangelist-phrasing: intent: Remove an address configuration effect: destructive questions: - Can I stop an address from being handled by Conversations by deleting its configuration? - Is removing an address configuration permanent? instructions: - text: Delete address configuration {sid}. slots: sid: path.Sid - text: Remove the Conversations setup for address {sid}. slots: sid: path.Sid method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Webhooks'].get update: x-apievangelist-phrasing: intent: Get account-level Conversations webhooks effect: read questions: - Where are my Conversations pre-event and post-event webhooks currently pointed? - Which conversation events are firing my account-level webhook? instructions: - text: Show my Conversations webhook configuration. - text: Get the current pre- and post-event webhook URLs for Conversations. method: generated generated: '2026-09-26' - target: $.paths['/v1/Configuration/Webhooks'].post update: x-apievangelist-phrasing: intent: Set account-level Conversations webhooks effect: write questions: - How do I get notified whenever a message is added to any conversation? - Can I choose which conversation events trigger my webhook? instructions: - text: Send Conversations post-event webhooks to {post_webhook_url}. slots: post_webhook_url: requestBody.PostWebhookUrl - text: Set the Conversations pre-event webhook to {pre_webhook_url} using {method}. slots: pre_webhook_url: requestBody.PreWebhookUrl method: requestBody.Method - text: Only fire Conversations webhooks for events {filters}. slots: filters: requestBody.Filters method: generated generated: '2026-09-26' - target: $.paths['/Configuration'].get update: x-apievangelist-phrasing: intent: Get the Flex configuration effect: read questions: - What UI attributes and enabled channels does my Flex contact center have? - Can I see the Flex configuration for a specific UI version? instructions: - text: Show my Flex configuration. - text: Get the Flex configuration for UI version {ui_version}. slots: ui_version: query.UiVersion method: generated generated: '2026-09-26' - target: $.paths['/Configuration'].post update: x-apievangelist-phrasing: intent: Update the Flex configuration effect: write questions: - How do I change the language of the Flex agent interface? - Can I pin my Flex UI to a particular version? instructions: - text: Set the Flex UI language to {ui_language}. slots: ui_language: requestBody.ui_language - text: Update Flex to UI version {ui_version} with attributes {ui_attributes}. slots: ui_version: requestBody.ui_version ui_attributes: requestBody.ui_attributes - text: Change the Flex runtime domain to {runtime_domain}. slots: runtime_domain: requestBody.runtime_domain method: generated generated: '2026-09-26'