# 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="/files/DJO6Z9XXEv19Z3V4IcxI" alt=""><figcaption></figcaption></figure>

4. Click on **MessageBird**

<figure><img src="/files/Uu3q9Ev6YZcyuv9mf0IF" alt=""><figcaption></figcaption></figure>

5. Click on Connect.

<figure><img src="/files/LdJUxcPqz9dPP3fx5IvP" 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="/files/yD28gT4w2PbExx02TALf" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/bots/whatsapp-bot/3rd-party-apps-integrations/botpenguin-integrations/integrate-botpenguin-with-messagebird.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.