The Twilio Voice integration allows you to talk to your bot on a phone call. [](https://youtu.be/5w_qRxuTLAM) ## Prerequisites - A [Twilio](https://www.twilio.com/) account. - A Twilio phone number. Refer to [this article](https://support.twilio.com/hc/en-us/articles/223135247-How-to-Search-for-and-Buy-a-Twilio-Phone-Number-from-Console) to learn how to get one. - A [Botpress Cloud account](https://app.botpress.cloud) and a [Botpress Bot](https://botpress.com/docs/cloud/getting-started/create-and-publish-your-chatbot/). ## 1. Add Twillio authentication to Botpress 1. Go to the Twilio [console dashboard](https://console.twilio.com/?frameUrl=/console). 2. Scroll down and copy your **Account SID** and **Auth Token** from the **Account Info** section. Then, paste them into the **Account SID** and **Auth Token** fields in the integration configuration on Botpress. ## 2. Add Botpress Webhook URL to Twillio 1. In the Develop tab on the left, navigate to Phone Numbers -> Manage -> Active Numbers. Click on the phone number you would like to integrate. 2. Copy the webhook URL from the integration configuration page and paste it into the **A Call Comes In** field. ## Important Things to Keep in Mind - Bot should only send one message per turn. - To hang up the call, you should add `<hangup/>` at the end of the message. For example, if a bot sends `Bye!<hangup/>`, the caller will hear "Bye!" and the call will be disconnected immediately afterward. ## Integration Configuration - Enabled: Whether Botpress will communicate with Twilio. - Webhook URL: The URL for receiving data in Botpress. - Account SID: Your Twilio Account SID. - Auth Token: Your Twilio Auth Token. - Reprompt Phrase: Phrase played if the caller doesn't respond - Voice: Voice used to pronounce bot's responses. Full list of voices can be found [here](https://www.twilio.com/docs/voice/twiml/say/text-speech#available-voices-and-languages). - Language: Language in which bot communicates. Full list of languages can be found [here](https://www.twilio.com/docs/voice/twiml/say/text-speech#available-voices-and-languages). - Timeout: Sets the limit (in seconds) that Twilio will wait for the caller to say another word before it sends data to the integration. - Speech Timeout: Sets the limit (in seconds) that Twilio will wait after a pause in speech before it stops its recognition. After this timeout is reached, Twilio will send the data to the integration.
