Welcome to the Botium Knowledge Center

When testing a voice enabled chatbot, Botium offers the option of using a Twilio Voice Gateway to send voice utterances to your voice enabled chatbot. A quick way to get started with voice testing in Botium can be found here

To utilize a Twilio Outbound SIP gateway for Botium voice testing, two configuration steps are required. First you must configure the Twilio Gateway, then setup the VOIP Connector in Botium, see below for more information on each step.

Before you begin with configuring Twilio, ensure that your Twilio account has a phone number available for this project that has voice capability, you can purchase additional phone numbers via Twilio as required.

1. Add TwiML Bin
   1. Access the TwiML Bins page via the Twilio Console

      

   2. Enter the name of the TwiML Bin, this is only used for your own reference purposes. Botium recommends naming this as "SipClientOutbound"
   3. Enter the following TwiML code in XML format.

      <?xml version="1.0" encoding="UTF-8"?>
      <Response>
          <Dial answerOnBridge="true" callerId="{{#e164}}{{From}}{{/e164}}">{{#e164}}{{To}}{{/e164}}</Dial>
      </Response>

   4. When this code is added, Twilio will confirm that it is valid and display a green checkmark at the bottom of the code box. Click Create to create the TwiML Bin.
2. Add the Credential List
   1. While logged into your Twilio Account, go to Programmable Voice
   2. Select Credential Lists
   3. Click the + icon to create a new credential list with the following information
   4. Username <Phone Number> (this is the phone number being used for this Twilio project)
   5. Password <Any password string> (record these as they will be used later in Botium)
3. Add IP / CIDR Access Control List
   1. Inside the Twilio Console, open the SIP Trunking menu
   2. Click on Authentication and IP Access Control Lists
   3. Add a new IP range as follows
   4. CIDR Network Address: <IP address of VOIP worker, provided by Botium/Cyara>
   5. Range: 32
4. Add a SIP Domain
   1. Select Domains and click the + Icon to create a new SIP Domain with the following details
   2. Friendly Name: <Any name for your reference>
   3. SIP URI: <Any valid SIP URI, this will be used later in the Botium Voip Connector Settings>
   4. IP Access Control Lists: <The list that was created in Step3>
   5. A Call Comes In: SipClientOutbound <The TwiML Bin created in Step1>
   6. SIP Registration: Enable
   7. Credential Lists: <Select the list created in step2>
5. (Optional) Enable Geo-Permissions
   1. Some phone numbers within different regions are blocked by default, this means that you won't be able to make calls to such numbers. For these blocked numbers you will need to specifically enable these in the Geo-Permissions page.

Now that the VOIP Gateway is available via Twilio, you can configure Botium to connect to it. Follow the steps below.

1. From the Chatbots menu, create a new chatbot
2. Select the Voice over IP Chatbot Technology and enter the following details;
   1. Websocket endpoint of VOIP Worker: <VOIP worker endpoint provided by Botium/Cyara>
   2. VOIP worker API Key: <API Key provided by Botium/Cyara>
   3. SIP Address to call: sip<number to call>@<sip domain>
   4. Speech Recognition Profile: Azure STT EN
   5. Speech Synthesis Profile (Optional): Azure TTS EN(Note: these Asure STT/TTS are for English speech recognition and synthesis, select an appropriate speech profiles for languages other than English)
3. In the SIP Configuration section enter the following details;
   1. SIP Registrar URI: sip:<sip domain>
   2. SIP Address: sip:<Twilio Phone Number>@<sip domain>
   3. SIP Username: <Twilio Phone Number, username from credential list>
   4. SIP Password: <set password from credential list>

   A successful configuration will look as follows;