SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Troubleshooting Twilio Studio Flow Failures

Issue 

If a flow is not working as anticipated, there are a number of possibilities why the desired behavior is not occurring. Check these options to make sure flows work as intended.

 

Product 

Studio

 

Environment 

legacy Twilio Console 

 

Resolution

Verify the Flow is Configured on a Twilio Number

Once a Flow is published, it needs to be configured on a Twilio phone number. Here are the steps for adding a flow to a Twilio line:

  1. Login to your account at Twilio Console.
  2. Click Phone Numbers # from the left-side navigation bar.
  3. Click the desired phone number to modify.
  4. Add the desired Studio flow:
    • Voice: 
      • ACCEPT INCOMING: Voice Calls
      • CONFIGURE WITH: Webhooks, TwiML Bins, Functions, Studio, or Proxy
      • A CALL COMES IN: Studio Flow
        • Select the desired flow.
    • Messaging: 
      • CONFIGURE WITH: Webhooks, TwiML Bins, Functions, Studio, or Proxy
      • A MESSAGE COMES IN: Studio Flow
        • Select the desired flow.
  5. Click Save.

NOTE: If Phone Numbers is not visible, you may first need to access the Explore Products page.

 

Validate the Flow’s Design is Correct

  • Verify the correct Trigger widget lead is connected to desired next step widget.
  • Verify the desired widget is being used: 
    • Send Message vs. Send & Wait for Reply
    • Connect Call to vs. Make Outgoing Call
  • Verify the widget is correctly configured, and has the right transitions.
  • Verify variable syntax is used correctly - for example, {{widget.widget_name.message.Inbound}}. Twilio Studio supports the Liquid Template language. For more information, please see our Liquid Template Language docs.
  • Verify flow changes are published.

NOTE: Widget names must start with a letter to be successfully used as Liquid variables.

 

Additional Information

Check for Test Users

  1. Login to your account at Twilio Console 
  2. Click Studio from the left-side navigation bar.
    NOTE: If Studio is not visible, you may first need to access the Explore Products page.
  3. Click the desired Flow to check.
  4. Click the Trigger widget, and then select the Config tab.
  5. Verify the phone number experiencing issues is not found in the TEST USERS field.
  6. If the number is present here, remove it, and then click Save.

 

User Stuck in the Flow Execution

If a user gets stuck in the middle of a flow, stop the execution from Twilio Console (or via the API).

  1. Login to your account at Twilio Console.
  2. Click Studio from the left-side navigation bar.
    NOTE: If Studio is not visible, you may first need to access the Explore Products page.
  3. Click Logs next to the flow being used. If your flow is not in view, click View all Flows, and then select Logs next to the desired flow.
  4. Find the Contact number, and then click Stop Execution.
Have more questions? Submit a request
Powered by Zendesk