# Integrate BotPenguin with Messagebird

The MessageBird integration allows you to connect your BotPenguin chatbot with MessageBird to send and receive messages using MessageBird-supported channels such as SMS. Once connected, your bot can automatically communicate with users using your MessageBird phone number.

***

### Prerequisites

Before integrating MessageBird with BotPenguin, make sure you have:

* An active **MessageBird account**
* A **MessageBird API Key**
* A **MessageBird phone number (Originator)** enabled for messaging
* Admin access to your **BotPenguin Dashboard**

***

### How to Integrate MessageBird with BotPenguin

#### Step 1: Open MessageBird Integration in BotPenguin

1. Log in to your **BotPenguin Dashboard**
2. Select the bot you want to integrate
3. Navigate to:\
   **Integrations → Third-party Apps Integration**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FymQIqol5npg3qi5PZ44l%2Fimage.png?alt=media&#x26;token=7d97f185-855a-41bd-813c-3fb439c2c390" alt=""><figcaption></figcaption></figure>

4. Click on **MessageBird**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F4FoJJjq6VRnTfxU1ikye%2Fimage.png?alt=media&#x26;token=d3aabd5e-6717-4a4d-8f4d-c0072db6d46c" alt=""><figcaption></figcaption></figure>

5. Click on Connect.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FZISbZldVGKfD6ITkpH8P%2Fimage.png?alt=media&#x26;token=2ab394bb-ffab-49d5-9704-4301ad146c16" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Get API Key from MessageBird

1. Log in to your **MessageBird Dashboard**
2. Go to **Developers → API access**
3. Copy your **Live API Key**

***

#### Step 3: Get MessageBird Originator

1. In the **MessageBird Dashboard**, go to **Channels / Numbers**
2. Select your active **MessageBird phone number**
3. Copy the phone number exactly as provided by MessageBird\
   (This will be used as the Originator)

***

#### Step 4: Connect MessageBird with BotPenguin

1. Paste the **API Key** into the **API Key** field
2. Enter your **MessageBird Phone Number** in the **Originator** field
3. Click **Connect**

Once connected successfully, MessageBird will be linked to your BotPenguin bot.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FTZ19NUi2eXcgzEi6SBlD%2Fimage.png?alt=media&#x26;token=38957e4a-6f08-47f9-8f72-602f38d19f05" alt=""><figcaption></figcaption></figure>

***

### Field Description

* **API Key**\
  A unique authentication key generated in your MessageBird account to authorize BotPenguin.
* **Originator**\
  The MessageBird phone number or sender ID from which messages will be sent.

### FAQs:

<details>

<summary>Where can I find my MessageBird API Key?</summary>

You can find it in your MessageBird Dashboard under **Developers → API access**.

</details>

<details>

<summary>What should I enter in the Originator field?</summary>

Enter your **MessageBird phone number** exactly as shown in your MessageBird account.

</details>

<details>

<summary>Can I use a test API key?</summary>

No. You must use a **Live API Key** for successful message delivery.

</details>

<details>

<summary>I clicked Connect but the integration failed. What should I check?</summary>

* Ensure the API Key is correct and active
* Verify the phone number (Originator) is enabled for messaging
* Confirm there are sufficient credits in your MessageBird account

</details>

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.