MessageBird SMS

MessageBird is an SMS marketing, notification and communication service that allows users to send and receive personalized text messages.

Smooch lets you integrate MessageBird SMS into your software with a single API that also connects to other channels like Messenger, Viber, chat SDKs and more.

Our MessageBird integration allows you to receive and send text messages from a MessageBird number. Refer to the channel capabilities grid to see all the MessageBird integration capabilities.

Configuring MessageBird

Add the MessageBird integration through the Smooch dashboard or via the REST API.

Smooch MessageBird Dashboard Integration

After the integration, you will be provided with a Smooch webhook URL. First, you will need to create a MessageBird flow. Go to your MessageBird Flow builder, use the flow “Call HTTP endpoint with SMS” and give it a name.

MessageBird Flow Builder Call HTTP endpoint with SMS

On the next page, select the desired number on the right of the screen under “Incoming SMS” and click “Save”.

MessageBird Flow Builder Incoming SMS

Then, click on the “Forward to URL” bubble and select the method “POST”. In the URL field, you will need to provide the Smooch webhook URL provided by the Smooch dashboard. If you used the REST API to create the integration, you will need to use the webhookSecret from the response to write the following with the respective values to your integration:{appId}/{integrationId}/{webhookSecret}.

Select “application/json” for the “Set Content-Type header” field.

Click “Save”, then “Publish changes” on the upper right corner.

Messagebird Flow Builder Forward URL

If you integrated MessageBird via the Smooch dashboard, confirm your integration.

Smooch MessageBird Dashboard Integration Confirm

Delivery Events

Delivery events allow you to track deliveries of Smooch messages to MessageBird by subscribing to the message:delivery:channel webhook. Smooch also tracks user deliveries on MessageBird which let you confirm whether a message has reached the user by listening to the message:delivery:user webhook. Failures to deliver a message to MessageBird or to a MessageBird user can be detected by subscribing to the message:delivery:failure webhook.

The MessageBird message IDs associated with each Smooch message are available in delivery event payloads in the externalMessages property.