Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?


Limited Availability

In order to move into production using the Twilio API for WhatsApp, you need a WhatsApp Business Profile. WhatsApp is currently limiting access to profiles during their API’s limited availability stage. Business Profiles must be associated with a Twilio number. You can request to enable your Twilio numbers for WhatsApp here. That being said, you can start building your bot with the WhatsApp Sandbox and move it over to a WhatsApp Business Profile when you receive access.

With Twilio Autopilot, you can build Whatsapp bots. On this page, we'll walk you through how to connect your Whatsapp Sandbox to Autopilot so you can get started building your bot.

Set up the Sandbox

  1. Sign up for a Twilio account here if you don't already have one.
  2. Follow these step-by-step instructions for setting up your Sandbox in the Learn page of the WhatsApp console menu.
  3. Once configured, you can see all the configuration details in the Sandbox page of the WhatsApp menu. You'll need these for the next set of steps.

Connect Autopilot to the Sandbox

Once you have successfully configured your Sandbox, you'll need to connect it to your Autopilot Assistant.

  1. Go to the Autopilot menu in the console and click into the Assistant you want to connect to WhatsApp.
  2. Go to the Channels tab in the Assistant Menu and select WhatsApp.
  3. Copy the URL displayed in the Configuration tab. This is the callback URL used to send incoming messages to your Assistant.
  4. Go back to the Sandbox page in the WhatsApp console menu. Paste the callback URL where it says 'When a message comes in'.
  5. Click Save and you're all set!


Now that you have WhatsApp configured it's time to test!

  • Open the WhatsApp app
  • Tap into the chat window with your WhatsApp bot
  • Send your first message, you should get a response from Autopilot
  • Check the Autopilot Query logs

Setting up Whatsapp with Flex and Autopilot

First, you need make sure that your Whatsapp Sandbox is setup correctly and that Flex us receiving the messages. Youo can follow the instructions below:

Autopilot URL Parameters

Parameter Description

A string representing the unique name of the destination Task. If no TargetTask is provided, the destination task is determined by the natural language understanding.

TargetTask is useful when you want to control what task a user is routed to.

For Example: Note the TargetTask parameter at the end of the URL


Any message sent to number or messaging service configured with this URL will land in the handle_appointment_confirmation task.

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 browsing the Twilio tag on Stack Overflow.