Rate this page:

Send Message

Send Message Widget


Send Message allows you to send a message to a user. Use this Widget to send messages to the user before any other action. If you want to request a user’s input after a message, use the Send & Wait For Reply Widget instead.

Required Configuration




Message Body

The text of the message to send.

Send Message From

The “from” number -- choose one from Phone Number, MessagingServiceSid, OTT Id

Flow Default

Send Message To

The "to" number, or recipient of the message

Flow Default

Optional Configuration




Media URL

The URL of the media you wish you send out with the message (i.e.

Programmable Chat Service

Only applies for Flows working with Twilio Programmable Chat. A Chat service is where all the Channels, Messages, Users and other resources within a Chat deployment live. See the Chat Services REST API docs for more information.


Programmable Chat Channel

Only applies for Flows working with Twilio Programmable Chat. Channels are the center of all chat activity within a Chat Service. Chat messages are sent to a particular channel. See the Chat Channels REST API docs for more information.


Message Attributes

Only applies for Flows working with Twilio Programmable Chat. An optional string metadata field you can use to store any data you wish along with the sent message. The string value must contain structurally valid JSON if specified. See the Chat Mesages REST API docs for more information.

Using Programmable Chat:

Messages from a user in a Programmable Chat Channel can be received by Studio and responded to using the Send Message widget. To enable incoming Chat messages, add the Studio Flow's webhook URL as a Chat Channel webhook.



New messages posted in the Chat Channel will create a new Studio Execution, enabling the Studio Flow to interact with the Chat user.



SID widgets.MY_WIDGET_NAME.outbound.Sid
To widgets.MY_WIDGET_NAME.outbound.To
From widgets.MY_WIDGET_NAME.outbound.From
Body widgets.MY_WIDGET_NAME.outbound.Body
Status widgets.MY_WIDGET_NAME.outbound.Status
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more