> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio SMS conversations

> Prepare message routing, identity, retries, and delivery handling for a future SMS channel without enabling unsupported workspace routing.

Workspace SMS conversations are not enabled by phone import. The current Twilio validator requires `enable_sms: false`. This guide describes the decisions needed for a future channel; it does not provide an active Threetone messaging webhook.

## Before you begin

Identify the sending number or Messaging Service, intended audience, application owner, and the policy for consent and opt-out requests. Confirm the provider requirements for your destinations with the account owner. A voice number and a verified phone number do not by themselves establish permission to send messages.

## Prepare the message flow

<Steps>
  <Step title="Define the incoming contract">Twilio sends form-encoded webhook data, including MessageSid, From, To, and Body. Plan provider signature validation using the provider's supported library and keep the external request separate from your internal conversation record.</Step>
  <Step title="Define conversation identity">Choose how workspace, receiving number, sender, and inactivity affect conversation boundaries. Use MessageSid to identify duplicate delivery rather than creating a second assistant reply.</Step>
  <Step title="Separate receipt from delivery">Specify the webhook response and the outbound sending workflow independently. Twilio expects TwiML for its incoming message webhook. A received webhook does not prove that a reply reached the handset.</Step>
  <Step title="Prepare release tests">Include duplicate messages, delayed status callbacks, unsupported attachments, opt-out requests, provider rejection, and an unavailable agent. Keep provider routing on its existing destination until a supported receiver is released.</Step>
</Steps>

See [Twilio's incoming message webhook reference](https://www.twilio.com/docs/messaging/guides/webhook-request) for the provider request and response contract.

## Failure handling

Record message identifiers and delivery states without putting message bodies or secrets in routine logs. Bound retries and check the original send result before attempting another reply. An unknown delivery result should not trigger an unlimited resend loop.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I enable SMS by changing the import flag?" id="twilio-sms-conversations-faq-flag">No. Setting enable\_sms to true is rejected by the current API.</Accordion>
  <Accordion title="Does the demo verification flow provide an SMS agent?" id="twilio-sms-conversations-faq-verify">No. [SMS verification](/agents-platform/deploy/telephony/twilio/sms-verification) checks a code for a specific demo flow; it is separate from conversational messaging.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.