MMS Gateway - touchSMS

The touchSMS MMS Gateway currently delivers MMS messages to Australian 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 (jpg, png, gif supported) to a server and determine the URL to that file and enter this into the URL field when sending an MMS message. You can attach a single image, up to a size limit of 1MB.
• Get Media Record URL: using the supplied getMediaURL.php file (for the FileMaker Data API) you can generate a dynamic URL on the fly that touchSMS can use to download a media file from the container field in the Media table record. This requires the fmMMS file to be hosted on FileMaker Server. N.B. the getMediaURL.php file currently doesn't work with FileMaker Cloud 2.x deployments due to the differences in how authentication is handled for FileMaker Cloud 2.x users with the Data API. We hope to have a version of the getMediaURL.php file that supports FileMaker Cloud 2.x soon.

You can get further information on supported media files and limitations on the touchSMS website here.

Incoming Messages/Replies

You can get incoming messages/replies to your touchSMS number into the fmMMS file in a number of ways:

• Use OttoFMS Webhooks
• Use PHP Webhooks to have touchSMS push these automatically to fmMMS using the supplied PHP files

Using Webhooks is the preferred method as it saves you from having to poll/check for any new messages - with Webhooks new messages are forward to fmMMS automatically by touchSMS as they are received. If you are new to webhooks we recommend using the free OttoFMS product from Proof+Geist.

touchSMS Otto Webhooks Setup

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

touchSMS Webhooks Data API PHP Setup

To receive incoming MMS messages to your touchSMS 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 enter the URL to this file in your online touchSMS account settings as follows:

1. login to your touchSMS account via their website
2. click on Settings in the side navigation then Webhooks (or go to https://app.touchsms.com.au/settings/webhooks)
3. Click the Create Webhook Subscription button
4. enter a name for the Webhook (e.g. 'fmMMS Replies')
5. enter the URL in the URL field
6. for the Events select Message Received.
7. click Save Subscription

It should look similar to this screenshot:

You can get further information on touchSMS MMS Webhooks on the touchSMS website here:

https://documenter.getpostman.com/view/14542603/UUy1en9E#cf6eb07e-22e7-43ff-acb6-578e4d241474