You will connect your own MessageBird account so Pop Dispatch can send customer text messages through the existing outbox. MessageBird charges you for messages on your account; Pop Dispatch adds no fee.
Before you start #
- You need the owner or manager role.
- Read MessageBird's pages on SMS rules for your country. Some countries require registration before texts are delivered. MessageBird's developer pages (developers.messagebird.com) are the source for those rules.
Make an access key #
- Open the MessageBird Dashboard at dashboard.messagebird.com and sign in.
- Open Developers > API access.
- Create an access key and copy it. MessageBird may show the key once; copy it before you leave the page.
Choose a sender #
- In the MessageBird Dashboard, buy or assign a number that can send SMS, if you have not already.
- Write the number down with a plus and its country code, or note the alphanumeric sender ID your country allows.
Connect it in Pop Dispatch #
- Open Settings > Connections and find "MessageBird text messages".
- Paste the access key and type the sending number.
- In "Country code for numbers without one", type the digits your customers' numbers start with, for example 1.
- Select "Save details", then "Switch on".
- Select "Test connection". Pop Dispatch asks MessageBird for your account balance with the key. The test sends no text.
Check a real message #
- Add your own mobile number to a test customer.
- Move a test tow call to "Dispatched" and open Settings > Customer messages. The outbox lists a text message as "Sent".
Technical details
Pop Dispatch checks the connection with a GET to https://rest.messagebird.com/balance with the header Authorization: AccessKey <key>. Each customer text is a POST to https://rest.messagebird.com/messages with JSON originator, recipients (digits without a plus) and body. MessageBird documents this at developers.messagebird.com.
If something goes wrong #
- "MessageBird did not accept the account details": create a new access key under Developers > API access and save it again.
- Texts stay in the outbox: switch on only one text-message service at a time under Settings > Connections.