# Integrate BotPenguin with Twilio

### Why use Twilio?

Integrate Twilio with your BotPenguin chatbot to enable seamless SMS and WhatsApp messaging. This allows your chatbot to reach users directly on their phones, improving engagement, outreach, and customer satisfaction. Whether you're sending order updates or automating lead follow-ups, Twilio ensures reliable delivery.

***

### Prerequisites

Before you begin, ensure the following:

* You have an active **Twilio account** with a verified phone number or WhatsApp Business number.
* You have access to your **Twilio Account SID** and **Auth Token**.
* Your BotPenguin chatbot is published and assigned to a valid channel.

***

### Steps to Integrate BotPenguin with Twilio:

#### Step 1: Going to Integration on BotPenguin

1. Sign into your BotPenguin account and choose the chatbot. Go to "Third Party Apps Integrations"

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F4cAMrxZfwBcLJ2ZlilWG%2Fimage.png?alt=media&#x26;token=2600a7b9-2ff2-46f4-8c5e-e770cbd55002" alt=""><figcaption></figcaption></figure>

2. Go to **Twilio integration** either by:
   * Searching for **Twilio** on the search bar available, or
   * Scrolling down to **Twilio** under the list of integrations

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FuEnjFaGu1Ei5KeNuF47m%2Fimage.png?alt=media&#x26;token=61c42130-2ab2-481f-85ad-6559e0fe0be4" alt=""><figcaption></figcaption></figure>

3. Click on the connect button to make the connection.
4. Click on the connect button again on the integration screen, and we'll be at the integration.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FJ139Qj27n6JFywXGgpUL%2Fimage.png?alt=media&#x26;token=6bf49d0a-f7c1-459b-b32a-9daff0b0872a" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Getting the Information from Twilio.

1. Go to [Twilio](https://www.twilio.com/en-us/messaging?cq_plac=\&cq_net=g\&cq_pos=\&cq_med=\&cq_plt=gp\&utm_source=google\&utm_medium=cpc\&utm_term=twilio\&utm_campaign=G_S_APAC_Brand_Brand_EN_NZ_All-175766865754\&gad_source=1\&gad_campaignid=22072023754\&gbraid=0AAAAADcHgwV1of7g1Pqst0ZvCIN5Hsnyv\&gclid=CjwKCAjw6NrBBhB6EiwAvnT_rtLC6d66Fiq2y1_9fZbcLTd11VNqi6fBUlJa7MoAbbUPceiWzGUf7xoCaEcQAvD_BwE) and sign into your account. Make an account if you don't have one.
2. You will land on your dashboard, as shown in the picture below.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FJdrBvTsdrIvArvh9Kkx7%2Fimage.png?alt=media&#x26;token=e53a47a8-7e79-4f72-995a-2475aa98dc0f" alt=""><figcaption></figcaption></figure>

3. If you do not have a Twilio number, then the same will need to be created for us to proceed forward. For getting a Twilio number, simply click on the "Get a number" present on the screen, and Twilio will assign you a 10 digit number.
4. Now, scroll down to the bottom of the Dashboard, where you will find the "**Account SID**", "**Auth Token**", and your **Twilio Phone Number**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F1nUdi4q4fAWodGGsP6RT%2Fimage.png?alt=media&#x26;token=4cd90796-8914-4f5a-a9fd-71ea318527fd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FInbwQP4psuzeJIaripad%2F89fc76ea-3192-4c15-abee-62778495ba20.png?alt=media&#x26;token=1e86b923-1bac-4ed1-83fd-2520ada0eb45" alt=""><figcaption></figcaption></figure>

5. Copy and paste the same tokens in the BotPenguin Applciation.
6. Next, click on Phone Number -> Manage -> TwiLM apps. Here, click on "**Create new TwiML App**".

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FjHHp14Ynhs7P800CkK1R%2Fimage.png?alt=media&#x26;token=3a6d68b2-ed2f-4847-929c-2dc42bf419a7" alt=""><figcaption></figcaption></figure>

7. Fill the Name and Request URL which is under "Voice Configuration".
   1. Set the name as "BotPenguin".
   2. Copy the code in BotPenguin Twilio Integration Screen, and paste it in the Request URL box.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FZCchKZk4ZS0v4RuyUGXc%2Fimage.png?alt=media&#x26;token=a9f9e3cf-0445-4f36-9e5e-70ab4d30b311" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F1xJsBzI9sp0ssd3yFMsQ%2Fimage.png?alt=media&#x26;token=30442c27-252e-4ac1-9062-24284e2ad672" alt=""><figcaption></figcaption></figure>

8. This will create a new application.
9. Click on the application to see the **TwiLM App SID**. Copy the ID over to the botpenguin platform.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FDB850FcbVm8JXj9p0ki4%2Fimage.png?alt=media&#x26;token=dea2473c-c173-4ddc-b812-345af21602ca" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FqKkocm3o1HeinIeswAP7%2F5345262e-c331-48e8-b654-35e502ec9d67.png?alt=media&#x26;token=9880b132-5565-4e6f-82db-ebcbf9a199dd" alt=""><figcaption></figcaption></figure>

10. Lastly, for the API Key and for the API Secret, click on the top right ""**Admin**" icon, and then click on "Account Management"

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F5sHIffpP0i45IAI4XhJy%2Fimage.png?alt=media&#x26;token=94b76c0a-1e60-4cd4-9d16-33e9413c8667" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You may be asked to verify your identity. Please do so.
{% endhint %}

11. Click on "API Keys & Tokens", and then click on "**Create API Key**".

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FtsyRGHJ6wtSJq75V104p%2Fimage.png?alt=media&#x26;token=846e5895-666f-4a93-ad71-ff24eb9bb1a8" alt=""><figcaption></figcaption></figure>

12. Enter a name for the API Key, as demonstrated below, and then click on create.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FcHjm4cGZ5aNP0ECKbzsr%2Fimage.png?alt=media&#x26;token=18a188e0-c25a-41db-b0c2-23dc35de7f85" alt=""><figcaption></figcaption></figure>

12. Note the secret keys that come up.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FErAWAsEQPHKGqjfvTYAI%2Fdf5a1141-adc2-42f9-b053-a67f85f60ca0.png?alt=media&#x26;token=cdac2b72-84f7-4483-8077-da673254af46" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Make sure to copy the keys as they will not appear again. Store them in a safe place
{% endhint %}

13. Copy the same in your BotPenguin Account.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FQPVWRDm9Zyk2XACmVs0I%2F2f867050-5ca7-44c6-b1d2-7f9c08ed7220.png?alt=media&#x26;token=54113e82-f2b5-4647-a3ba-d26095337dfd" alt=""><figcaption></figcaption></figure>

14. Click on update to update the integration.
15. For the final changes, go to Phone Number -> Active Numbers, and click on the same.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FSQCU4mrd1KT24Q5I8JgE%2Fimage.png?alt=media&#x26;token=95ab9bd3-f0b5-4590-b046-64c12044147a" alt=""><figcaption></figcaption></figure>

16. Make sure both the "Voice Configuration", and scrolling down, the Messaging Configuration have the URL as copied from BotPenguin.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FpMryYGqNCMZ6ej1f9AzE%2Fimage.png?alt=media&#x26;token=c64ade37-d26e-44b9-893b-882e07f8ea79" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FGCUDyuNCFOOQPlbuAAfg%2Fimage.png?alt=media&#x26;token=e2d0787c-c9f2-4344-91b8-b398f45aa762" alt=""><figcaption></figcaption></figure>

17. Click on "**Save Configuration**".

And you're done! You're now free to use the Twilio Integrations with your bots!

***

### FAQ's:

Here are some common FAQ's regarding Twilio Integration

<details>

<summary>Does BotPenguin offer SMS services with Twilio?</summary>

No, BotPenguin only offers Twilio with Voice calling configuration.

</details>

<details>

<summary>Which bots are available for integration with Twilio?</summary>

WhatsApp bots are the only bots that can be integrated with Twilio.

</details>

***

If everything is correct and you are still unable to move forward, write to us at [support@BotPenguin.com](mailto:support@botpenguin.com). We will respond back within 48 business hours.