MessageBird

Getting started with MessageBird

The MessageBird modules allow you to watch, create, update, list, and delete SMS, contacts, and groups in your MessageBird account.

Prerequisites

  • A MessageBird account

In order to use MessageBird with Boost.space Integrator, it is necessary to have a MessageBird account. If you do not have one, you can create a MessageBird account at dashboard.messagebird.com/en/sign-up.

[Note] Note

The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connecting the MessageBird to Boost.space Integrator

To connect your MeesageBird account to Boost.space Integrator you need to obtain the Access Key from your MessageBird account and insert it in the Create a connection dialog in the Boost.space Integrator module.

1. Login to your MessageBird account and open the Dashboard.

2. In the Your API Keys section, click Show and copy the API Key.

61f2736e14116.png

3. Go to Boost.space Integrator and open MessageBird module’s Create a connection dialog.

61f2736f498d3.gif

4. In the Connection name field, enter the name of the connection.

5. In the Access Key field, enter the API key copied in step 2.

6. Click Continue.

61f2737169529.png

The connection has been established.

Messages

Delete an SMS Message

Deletes an SMS message.

Connection

Establish a connection to your MessageBird account.

Message ID

Enter the Message ID you want to delete.

Read an SMS Message

Gets details of an SMS message.

Connection

Establish a connection to your MessageBird account.

Message ID

Enter the Message ID you want to read.

List SMS Messages

Retrieves a list of SMS messages that were sent or received.

Connection

Establish a connection to your MessageBird account.

Limit

Enter the number of messages Boost.space Integrator should return during one execution cycle.

Originator

Enter the sender number whose messages you want to list.

Recipient

Enter the recipient number whose messages you want to list.

Direction

Select the message direction:

  • Sent

  • Received

Type

Select the message type:

  • SMS

  • Binary

  • Flash

Status

Select the status of the messages you want to list:

  • Scheduled

  • Sent

  • Buffered

  • Delivered

  • Expired

  • Delivery Failed

Send an SMS Message

Sends an SMS message via MessageBird.

Connection

Establish a connection to your MessageBird account.

Recipients

Enter the recipient number to whom you want to send the message.

Originator

Enter the sender details. You can either enter the sender’s phone number with country code or name or text that is alphanumeric.

Body

Enter the message text.

Reference

Enter the client reference number of the message.

Report URL

Enter the message status report URL.

Watch SMS Messages

Triggers when a new SMS message is sent or received.

Connection

Establish a connection to your MessageBird account.

Limit

Enter the maximum number of messages Boost.space Integrator should return during one execution cycle.

Originator

Enter the sender number whose messages you want to watch.

Recipient

Enter the recipient number whose messages you want to watch.

Direction

Select the message direction:

  • Sent

  • Received

Type

Select the message type:

  • SMS

  • Binary

  • Flash

Status

Select the status of the messages you want to watch:

  • Scheduled

  • Sent

  • Buffered

  • Delivered

  • Expired

  • Delivery Failed

Contacts

Create a Contact

Creates a contact.

Connection

Establish a connection to your MessageBird account.

Phone Number

Enter the phone number of the contact.

First Name

Enter the first name of the contact.

Last Name

Enter the last name of the contact.

Custom Field 1 – 4

Add custom fields for the contact.

Get a Contact

Retrieves the information of an existing contact.

Connection

Establish a connection to your MessageBird account.

Contact ID

Enter the Contact ID whose details you want to retrieve.

Add a Contact to a Group

Adds a contact to a group.

Connection

Establish a connection to your MessageBird account.

Group ID

Enter the Group ID to which you want to add to the contacts.

IDs

Add the Contact IDs of the contact. You can add a maximum of 50 contacts.

Remove a Contact from a Group

Removes a contact from a group.

Connection

Establish a connection to your MessageBird account.

Group ID

Enter the Group ID from which you want to remove the contact.

Contact ID

Enter the Contact ID you want to remove from the group.

Delete a Contact

Deletes a contact.

Connection

Establish a connection to your MessageBird account.

Contact ID

Enter the Contact ID you want to delete.

Update a Contact

Updates the contact.

Connection

Establish a connection to your MessageBird account.

Contact ID

Enter the Contact ID you want to update.

Phone Number

Enter the phone number of the contact

First Name

Enter the first name of the contact.

Last Name

Enter the last name of the contact.

Custom Field 1 – 4

Add custom fields for the contact.

Create a Group

Creates a group.

Connection

Establish a connection to your MessageBird account.

Name

Enter the name of the group.

Delete a Group

Deletes a group.

Connection

Establish a connection to your MessageBird account.

Group ID

Enter the Group ID you want to delete.