MMS Gateway - MessageBird

The MessageBird MMS Gateway currently delivers MMS messages to USA and Canadian phone numbers. You can use the following methods for attaching media files to your outgoing messages:

• Public URL: simply enter the publicly accessible URL for each media file that you wish to send. You would typically upload the file (jpeg, png, gif etc) to a server and determine the URL to that file and enter this into the URL field when sending an MMS message.

You can get further information on supported media files and limitations here:

https://developers.messagebird.com/api/mms-messaging/#media-attachments

N.B. In order to send messages to Canada and the USA you will need to request approval from MessageBird first before you can send messages to numbers in these countries. You can get further information about requesting access for restricted countries here.

Incoming Messages/Replies

You can get incoming messages/replies to your MessageBird number into the fmMMS file in 2 ways:

• Manually Download Incoming Messages (SMS only not MMS)
• Use Webhooks to have MessageBird push these automatically to fmMMS
• Use Otto Webhooks

Using Webhooks is the preferred method as it saves you from having to poll/check for any new messages and supports MMS media attachments - with Webhooks new messages are forwarded to fmMMS automatically by MessageBird as they are received.

Manual Download Incoming Messages (SMS Only)

You can download incoming SMS (not MMS) messages manually via the Account Details screen. Simply enter the date range you wish to download messages between and click the Get Incoming Messages button:

Any incoming SMS messages to your MessageBird number that have not been previously downloaded will then be downloaded. You could also setup a FileMaker Server script schedule to have this run on a scheduled basis (e.g.every hour) to save you from having to manually download/check for new messages.

MessageBird Webhooks Setup

To receive incoming MMS messages to your MessageBird number, including replies to previously sent messages, you will need to use the supplied WebhooksIncomingMessages.php webhook file to act as the webhook receiver. See our Webhooks guide for what you need to do host the WebhooksIncomingMessages.php file on your chosen web server. Once you have the publicly accessible URL for this file you can create a flow using the MessageBird Flow Builder to have incoming messages forwarded to this URL.

You can get further information on handing inbound SMS/MMS messages and using Flow Builder on the MessageBird website here:

https://developers.messagebird.com/docs/sms-messaging/handle-inbound-sms/

Make sure you select POST for the HTTP Method when adding the Forward to URL step to your flow:

You flow when completed should look similar to this screenshot:

MessageBird Otto Webhooks Setup

Please visit the Webhooks using Otto guide for instructions on setting up Otto Webhooks for your MessageBird number. You will need to create a new webhook and enter the Otto webhook URL using the instructions above and modify the OttoReceiver script to handle incoming MMS messages from MessageBird.