Integrate BotPenguin with Twilio
This page provides a step-by-step guide on integration of 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
Sign into your BotPenguin account and choose the chatbot. Go to "Third Party Apps Integrations"
Go to Twilio integration either by:
Searching for Twilio on the search bar available, or
Scrolling down to Twilio under the list of integrations
Click on the connect button to make the connection.
Click on the connect button again on the integration screen, and we'll be at the integration.
Step 2: Getting the Information from Twilio.
Go to Twilio and sign into your account. Make an account if you don't have one.
You will land on your dashboard, as shown in the picture below.
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.
Now, scroll down to the bottom of the Dashboard, where you will find the "Account SID", "Auth Token", and your Twilio Phone Number.
Copy and paste the same tokens in the BotPenguin Applciation.
Next, click on Phone Number -> Manage -> TwiLM apps. Here, click on "Create new TwiML App".
Fill the Name and Request URL which is under "Voice Configuration".
Set the name as "BotPenguin".
Copy the code in BotPenguin Twilio Integration Screen, and paste it in the Request URL box.
This will create a new application.
Click on the application to see the TwiLM App SID. Copy the ID over to the botpenguin platform.
Lastly, for the API Key and for the API Secret, click on the top right ""Admin" icon, and then click on "Account Management"
You may be asked to verify your identity. Please do so.
Click on "API Keys & Tokens", and then click on "Create API Key".
Enter a name for the API Key, as demonstrated below, and then click on create.
Note the secret keys that come up.
Make sure to copy the keys as they will not appear again. Store them in a safe place
Copy the same in your BotPenguin Account.
Click on update to update the integration.
For the final changes, go to Phone Number -> Active Numbers, and click on the same.
Make sure both the "Voice Configuration", and scrolling down, the Messaging Configuration have the URL as copied from BotPenguin.
Click on "Save Configuration".
And you're done! You're now free to use the Twilio Integrations with your bots!
Troubleshooting
Connection fails when clicking the Connect button
Ensure you are signed into the correct BotPenguin account and that your chatbot is published. Try refreshing the page and clicking "Connect" again.
Account SID or Auth Token is not being accepted
Double-check that you have copied the credentials from the correct Twilio account. Ensure there are no extra spaces before or after the values when pasting.
TwiML App SID is not working
Confirm the TwiML App was created with the correct Request URL copied from BotPenguin. Go to Phone Numbers → Manage → TwiML Apps in Twilio and verify the URL is correctly set.
API Key and Secret are not being accepted
API Secret is only shown once at the time of creation — if you did not copy it, you will need to create a new API Key. Go to Admin → Account Management → API Keys & Tokens and create a fresh key.
Voice or messaging is not working after setup
Go to Phone Numbers → Active Numbers in Twilio and confirm that both the Voice Configuration URL and Messaging Configuration URL match the URL provided by BotPenguin. Click "Save Configuration" after making any changes.
FAQs
Does BotPenguin offer SMS services with Twilio?
No. BotPenguin only supports Twilio for Voice calling configuration. SMS via Twilio is not available through this integration.
Which bots can be integrated with Twilio?
Only WhatsApp bots can be integrated with Twilio on BotPenguin.
Where do I find my Twilio Account SID and Auth Token?
Log in to your Twilio account and go to the Dashboard. Scroll to the bottom of the page — you will find the Account SID, Auth Token, and your Twilio phone number in the Account Info section.
What is a TwiML App and why do I need it?
A TwiML App is a Twilio configuration that routes incoming calls or messages to a specified URL — in this case, BotPenguin's webhook URL. It is required to connect Twilio's voice functionality to your BotPenguin chatbot.
Can I use an existing Twilio phone number for this integration?
Yes. If you already have an active Twilio number, you can use it. Just ensure the Voice Configuration and Messaging Configuration URLs on that number are updated to the BotPenguin webhook URL.
I lost my API Secret — what should I do?
The API Secret is only displayed once at the time of key creation. If you did not save it, go to Admin → Account Management → API Keys & Tokens in Twilio, delete the old key, and create a new one.
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.
Last updated
Was this helpful?