# MessageBird SMS Quick Start
{% hint style="info" %}
To connect with MessageBird, you will need a [MessageBird account](https://dashboard.messagebird.com/en/sign-up).
{% endhint %}
Messagebird is a cloud communications platform that allows you to send and receive SMS text messages through web service APIs.
This Messagebird integration lets you respond to SMS messages directly from our platform.
## Setting Up MessageBird
### Purchasing **a Virtual Number**
{% hint style="info" %}
Note that you will have to [top up your MessageBird account](https://dashboard.messagebird.com/en/paymentflow/add-funds) in order to purchase a Virtual Number.
{% endhint %}
**Step 1: Sign in to your MessageBird account**\
Navigate to the [MessageBird dashboard](https://dashboard.messagebird.com/). If you are not already signed in, you may have to log in with your [MessageBird account](https://dashboard.messagebird.com/en/sign-up/) first.
**Step 2: Buy a Number**\
On the sidebar, select **Numbers.** On the Numbers page, select the blue **Buy a Number** button on the top right.
**Step 3: Choose a phone number**\
Select a phone number that you prefer and best suit your company needs. You can select a number from any country available on MessageBird.
{% hint style="warning" %}
Be sure to select a phone number that supports SMS capability as it is required for this connection to work.
{% endhint %}
## Connecting MessageBird
**Step 1: Navigate to Channel Settings**\
From **Settings** Module, navigate to the menu item, **Channels**
**Step 2: Add Channel**\
Press **Add Channel** and choose **SMS.** Select **MessageBird** on the second step
**Step 3: Sign in to your MessageBird account**\
Navigate to the [MessageBird dashboard](https://dashboard.messagebird.com/) and navigate to [Flow Builder](https://dashboard.messagebird.com/en/flow-builder).
**Step 4: Select Call HTTP endpoint with SMS template**\
Locate the **Call HTTP endpoint with SMS** template and press **Try This Flow**
**Step 5: Select the preferred phone number**\
Select the preferred phone number and press **Save**
**Step 6: Configure Forward to URL**\
From the Flow Builder, press on **Forward to URL** icon and select **POST** as the method.
**Step 7: Add the generated URL to the field**\
From the ISMessenger platform, copy the generated URL and paste it to the URL field at MessageBird
**Step 8:** If there are no errors, you may proceed to publish and activate the flow.
**Step 9:** On the IS-Messenger platform, follow the instructions and click **Next**.
**Step 10:** Navigate to the [Developer Access Page](https://dashboard.messagebird.com/en/developers/access) and click **Show Key**. Add the API key to the IS-Messenger platform.
**Step 11:** Select the phone number from the dropdown on the IS-Messenger platform.
**Step 12:** Click **Save Changes** to complete the setup.
{% hint style="success" %}
Once you completed the setup, any SMS sent to the MessageBird phone number will now be received in your space.
{% endhint %}
## Channel Configuration
{% hint style="info" %}
MessageBird SMS channel can be configured with a unique channel name.
{% endhint %}
**Step 1:** Navigate to **Workspace Settings** > Click **Channels**.
**Step 2:** Locate the MessageBird SMS Channel > Click **Manage > Configuration.**
**Step 3:** Configure the Channel name, which is used internally to identify the account.
{% hint style="warning" %}
Ensure all your details are entered correctly as errors may cause outbound messages from your MessageBird SMS account to fail.
{% endhint %}
{% hint style="warning" %}
**Important**: As for the other details, take extra note while updating as it might fail to receive messages from the connected MessageBird SMS account.
{% endhint %}
**Step 4:** Click **Save Changes** to update the Channel configuration.
---
# 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://docs.is-messenger.com/ismessenger/messaging-channels/sms/messagebird-sms.md?ask=
```
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.