MessageBird

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

• Capabilities

  • Content types
  • Action Types
  • Structured Messages
  • Delivery Events
• Configuring MessageBird
• Outbound messaging

Capabilities

MessageBird SMS supports a wide variety of capabilities as seen in the channel capabilities grid. Below is a detailed view of each capabilities.

Configuring MessageBird

Add the MessageBird integration through the Sunshine Conversations dashboard or via the REST API.

After the integration, you will be provided with a 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.

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

Then, click on the “Forward to URL” bubble and select the method “POST”. In the URL field, you will need to provide the webhook URL provided by the 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: https://app.smooch.io/api/messagebird/webhooks/{appId}/{integrationId}/{webhookSecret}. If you are a licensed Zendesk customer, use https://<subdomain>.zendesk.com/sc/api/messagebird/webhooks/{appId}/{integrationId}/{webhookSecret}.

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

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

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

Outbound messaging

To initiate a conversation with a user for which you know their phone number, you can use the Notification API. For more information on outbound messaging, consult the guide.

Initiate a conversation with a user over SMS by making a request to the Notifications endpoint:

curl https://api.smooch.io/v1.1/apps/5963c0d619a30a2e00de36b8/notifications \
     -X POST \
     -d '{
          "destination": {
               "integrationId": "5e1f438bf99fb467810c0ab9",
               "destinationId": "+15145555333"
          },
          "author": {
               "role": "appMaker"
          },
          "message": {
               "type": "text",
               "text": "This is a sample notification."
          }
     }' \
     -H 'content-type: application/json' \
     --user 'keyId:keySecret'