# Bot Setup and Installation

### What is the SMS Bot?

The SMS Bot enables businesses to connect an SMS service provider, such as Twilio, and automate two-way conversations with users through text messages. It allows you to send and receive SMS messages directly from the platform, making SMS a fully functional communication channel for customer engagement, notifications, and support.

By combining automated chatflows with SMS delivery, the SMS Bot helps teams scale communication, ensure timely message delivery, and manage all SMS-based conversations from a single dashboard—without manual intervention.

***

### Benefits of Twilio SMS Integration

* 🚀 Accelerates customer communication with instant, automated message delivery at scale.
* ⏱️ Reduces operational overhead by automating repetitive notifications and responses.
* 🔒 Improves reliability and trust through timely OTPs, alerts, and transactional messages.
* 📈 Boosts engagement and conversions with targeted campaigns and real-time updates.

***

### How to Set Up the SMS Bot

#### 1. Create the SMS Bot

1. Log in to your dashboard.
2. Click on **Create Bot**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FXseQaJecPoTpdJRwKt8M%2Fimage.png?alt=media&#x26;token=683aeb7c-3bea-4fae-8b7a-b2585348bad5" alt=""><figcaption></figcaption></figure>

3. Select **SMS Bot**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Faq0y4gMa4xcROxZCUhV4%2Fimage.png?alt=media&#x26;token=49f5bc9a-6e1e-490b-97d1-13f48e2d51ef" alt=""><figcaption></figcaption></figure>

4. Choose your business goal, and then click on "**Proceed to Next Step**".

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FNwLpmF7dGLAV4CPpHGdT%2Fimage.png?alt=media&#x26;token=d7de65c9-6b57-4fce-af84-b9691e7064cb" alt=""><figcaption></figcaption></figure>

5. Your SMS Bot will be created automatically!

***

#### 2. Editing your SMS Bot Chatflow

1. Open the newly created SMS Bot.
2. Go to the "**Chatflow**"

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fz3ObqLqNSlrDZsGLAuyF%2Fimage.png?alt=media&#x26;token=6bf8fc6e-69da-42ea-b29d-39477797e0d5" alt=""><figcaption></figcaption></figure>

3. Create a new flow or edit the existing.

{% hint style="info" %}
**Want to learn how to create a chatflow? Check out the following article:** [edit-and-manage-chatflow](https://help.botpenguin.com/bots/sms-bot/edit-and-manage-chatflow "mention")
{% endhint %}

***

### Installing SMS Bot via Twilio

#### 3. Install the SMS Bot

1. Click on **Install Your Chatbot**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FoRaH4uYbtMxd2EM0rL8X%2Fimage.png?alt=media&#x26;token=5d0e3d68-32a0-43c8-b457-73cdd3552bdc" alt=""><figcaption></figcaption></figure>

2. Choose Twilio as the provider.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fcn9fVOvMQMfyweZB87aE%2Fimage.png?alt=media&#x26;token=86ac1f35-0b95-480c-a5e3-526ae894809f" alt=""><figcaption></figcaption></figure>

3. You will be redirected to the installation screen.
4. Add the details of Account SID, Auth Token and Phone number details to integrate with Twilio. (specified below in "4. Get Twilio Credentials")
5. Then click on "**Save**" credentials options to save.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fqgb2nXY3DYd31yGfAbhT%2Fimage.png?alt=media&#x26;token=92a5c8b3-ff6d-4d72-a9c4-5b657f423674" alt=""><figcaption></figcaption></figure>

***

#### 4. Get Twilio Credentials

Follow these steps to collect the required details from Twilio:

1. Log in to Twilio
   1. Go to [**https://www.twilio.com/**](https://www.twilio.com/)
   2. Log in to your Twilio account.
   3. To get the following [prerequisites](https://help.botpenguin.com/bots/sms-bot/install-sms-bot/twilio#part-2-getting-the-required-information-from-twilio) follow the following steps:
2. Copy Account SID and Auth Token
   1. From the **Twilio Console Dashboard**, locate:
      * **Account SID**
      * **Auth Token**
3. Copy both values.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fq5ERn6qPuQ1JpOE02nm3%2Fimage.png?alt=media&#x26;token=0ee0fe3b-3677-43fb-8761-f1e06e3aca2d" alt=""><figcaption></figcaption></figure>

***

### Step 5: Connect Twilio in the SMS Bot

Enter the following details in the installation screen:

| Field            | What to Enter                  |
| ---------------- | ------------------------------ |
| **Account SID**  | From Twilio Dashboard          |
| **Auth Token**   | From Twilio Dashboard          |
| **Phone Number** | Your Twilio SMS-enabled number |

1. Paste the credentials.
2. Click "**Save Credentials"** to save the credentials. Leaving without clicking on the button will not update the installation screen.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FB4K3b1KlrKaqdg8ztRim%2Fimage.png?alt=media&#x26;token=432eb3b0-c059-47ab-ae56-d0c783cbe464" alt=""><figcaption></figcaption></figure>

3. Your Twilio account will now be connected successfully!

### After Setup

* Your SMS Bot will start sending and receiving messages via Twilio.
* Conversations can be monitored from the Inbox.

***

#### SMS Chatbot (Twilio) FAQs

<details>

<summary>Do I need a paid Twilio account to install the SMS chatbot?</summary>

You can start with Twilio’s trial account and use the provided credits to purchase a phone number. However, production usage may require upgrading your Twilio plan.

</details>

<details>

<summary>Where can I find my Twilio Account SID and Auth Token?</summary>

These details are available on the Twilio Dashboard under the **Account Info** section once you log in.

</details>

<details>

<summary>Can I use an existing Twilio phone number?</summary>

Yes, any active Twilio phone number associated with your account can be used for SMS chatbot installation.

</details>

<details>

<summary>What happens if I enter incorrect Twilio credentials?</summary>

The chatbot will not install successfully. Ensure that the Account SID, Auth Token, and Phone Number are copied exactly as shown in Twilio.

</details>

<details>

<summary>Can I change the Twilio number after installation?</summary>

Yes, you can update the credentials by revisiting the installation settings and saving new Twilio details.

</details>

### Need Help?

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.