Overview
Use an SMS-capable Twilio number with Voiceflow’s managed SMS channel. Twilio receives the customer text and delivers the agent’s reply; Voiceflow hosts the webhook and runs the assigned Chat agent. This manual prepares and checks the Twilio side, then follows the canonical Voiceflow SMS installation.
Other Twilio jobs: Deploy a Voice agent for calls, or send one text follow-up with the Twilio tool. Those connections have separate credentials and do not create an SMS agent channel.
Prepare Twilio
Use a reply-capable number in the account you will connect.
In Twilio Console, open Phone Numbers → Manage → Active numbers, select the number and confirm its SMS capability. Obtain the credentials from its owning account’s dashboard. An alphanumeric sender cannot stand in for a number customers can text back. The Send SMS tool uses Account SID plus API Key SID/Secret instead; do not paste that pair into number setup.
Route incoming SMS
Make the Voiceflow number webhook the effective inbound handler.
Connect and assign in Voiceflow
Complete Voiceflow SMS → Connect and assign using Studio or Code. That procedure imports the owned number, assigns its Chat project and test Environment, and writes a POST messaging webhook on Twilio’s IncomingPhoneNumber resource.
Inspect the resulting messaging URL
Return to the Twilio number’s Messaging configuration. Confirm its A message comes in route uses the webhook Voiceflow wrote. Its shape is https://runtime-api.voiceflow.com/v1/twilio/webhooks/PHONE_NUMBER_ID/sms; retain the actual saved host and ID rather than reconstructing a URL from the phone’s digits. Voiceflow validates X-Twilio-Signature against that URL and the stored Auth Token.
Resolve Messaging Service routing
If the number belongs to a Messaging Service, open that service’s Integration settings. Select Defer to sender’s webhook when this number should use its Voiceflow number-level route. If the service must keep another handler, have its administrator arrange a separate number for Voiceflow. Changing the number URL alone does not override a service configured to handle incoming messages. See Messaging Service incoming-message handling.
Save the provider settings. Voiceflow returns an empty TwiML acknowledgment and sends the eventual agent answer through Twilio’s Messages API, rather than returning the answer in webhook TwiML.
Test the Twilio conversation
Compare incoming and outgoing provider records with the customer exchange.
Send the known question and follow-up
Perform the Voiceflow SMS customer test from your separate phone. Check the expected answer and continuity in the intended Chat project’s Transcript.
Inspect both message directions
In Twilio Console Monitor → Logs → Messaging, locate the inbound Message SID and the outgoing reply SID. Confirm From/To reverse correctly and inspect each outgoing status/error. queued and sent are intermediate evidence; compare the eventual receipt with the handset. Use Twilio message statuses.
Twilio receives the text but Voiceflow does not
Check the effective messaging handler and webhook request result.
Check the number’s webhook, Messaging Service inbound handling and Twilio’s request error. A signature error usually requires checking the connected account credentials and actual saved URL. Keep the provider’s error details and timestamp. Do not switch the voice webhook while diagnosing SMS.
The reply is queued, rejected or undelivered
Inspect sender registration, destination permissions and opt-out state.
Check the outgoing SID’s error against Twilio’s documentation, account balance, approved sender, geographic permissions, trial-recipient verification and opt-out configuration. If the send result is uncertain, inspect the SID before repeating the customer action. Replaying an inbound webhook can produce another turn and another reply.
Release and maintain SMS
Keep the provider route and Voiceflow release aligned.
- Complete Voiceflow SMS → Release: publish the Chat Environment and select its Published version in the SMS assignment.
- In Twilio’s Messaging configuration, confirm the number still uses the Voiceflow webhook and any Messaging Service defers to it.
- Repeat the customer test through the final number and inspect the outgoing SID’s delivery result.
Keep replies concise. Encoding, message length, segmentation and destination rules affect delivery and cost; check Twilio SMS character limits before introducing long or Unicode answers. Configure opt-out handling for this sender and test it on the controlled line.
For credential rotation, unassignment and restoration of the prior handler, use Voiceflow SMS maintenance. Changing an API key used by the notification tool does not rotate the stored number Auth Token. Retest voice separately if this number also takes calls.