Connecting Bird Messaging

Bird (formerly MessageBird) is a communications company which provides messaging systems which enable us to integrate SMS, WhatsApp, Facebook Messenger, Instagram and LINE messaging with the MotorDesk platform.


1. Sign-up With Bird

Visit Bird.com to sign-up with Bird. You do not need to sign-up to a membership plan with a monthly fee, we will be using the 'API Pricing'.

2. Buy a Number

Once you've signed-up and completed the initial account set-up please go to the Channels section, then proceed to the 'Longcode Numbers' section and select the 'Buy a number' button. Then select your country and set the capabilities as 'SMS', then click 'Search' and select to 'Buy' your preferred number.

To purchase the number you will need to top-up your account balance with Bird, the minimum top-up is currently £15 GBP. Your messaging and number charges will be deducted from this balance as you use the service and you will then top-up periodically as needed.

3. Number Compliance

Once your number has been issued you will need to complete the compliance processes. Navigate to view your longcode number and then proceed to the Compliance tab.

For the 'Brand Identification' simply enter your business details.

For the 'SMS Use Case' we recommend setting the 'Use Case' as 'Customer Care'.

Example description:
2-way customer initiated messaging for sales and service.

Sample message 1:
Thank you for your interest in this vehicle, would you like to arrange a test drive?

Sample message 2:
Yes, this vehicle is still available. Would you like to book a viewing appointment?

Sample message 3:
Yes, all our vehicles include a 12 month warranty, and we offer free nationwide delivery.

Once submitted the compliance verification process can take several weeks to complete, during this time you can receive SMS message but you will be unable to send SMS messages.

4. Set-up Channels

Please navigate to the Channels section and enable any channels you would like to use such as WhatsApp, Facebook Messenger, Instagram Messaging and Line. Bird frequently adds new channels which MotorDesk may not yet support, please contact MotorDesk support for assistance enabling these.

5. Set-Up MotorDesk

Next go to the Business -> Connect Services -> Communications section of your MotorDesk account and complete the Bird set-up.

Telephone Number should be the longcode number you've purchased, entered in the international format, e.g. 447000123123

Access Key Token can be created in the Settings -> Security -> Access Keys section of your Bird account. Please select to 'Add new access key' and select the 'Roles' as 'Owner' to enable MotorDesk to complete the set-up process.

Organisation ID can be found in the Settings -> Account -> Organization section of your Bird account.

Workspace ID can be found in the Settings -> Account -> Workspaces section of your Bird account. You should have created your workspace during the initial account set-up process, simply click on your workspace name to reveal the ID.

Your Channel IDs can be found in the Settings -> Channels section of your Bird account by viewing each channel.

When you save your settings in the Business -> Connect Services -> Communications section of your MotorDesk account your Bird webhooks will be created - these webhooks tell Bird how to send message notifications to MotorDesk.

6. Final Checks

Please test your messaging channels by initiating messages as customers, and then replying to them from MotorDesk's Sales -> Leads & Chat section. SMS messages can be initiated from the Leads & Chat section, but for example WhatsApp and Facebook messages must be initiated from those platforms.

Finally, please test that you can send your website URL to customers via SMS, if this fails please contact Bird and ask them to allow your account to send URLs in SMS messages.