SMS Gateway - touchSMS

The touchSMS SMS Gateway delivers SMS messages internationally. When setting up your Account in the fmSMS file follow the instructions in the Gateway Notes field. You will need to enter your touchSMS API Token in the Username field in the Accounts screen - you can find these from your online touchSMS account under the Developer menu > API Tokens:

Incoming Messages/Replies

You can get incoming messages/replies to your touchSMS number into the fmSMS file in several ways:

• Manually Download Incoming Messages
• Use OttoFMS Webhooks
• Use PHP Webhooks to have touchSMS push these automatically to fmSMS 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 fmSMS automatically by touchSMS as they are received. If you are new to webhooks we recommend using the free OttoFMS product from Proof+Geist.

Manual Download Incoming Messages

You can download incoming 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 messages to your touchSMS account 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 - your script would just need to handle the incrementing of the timestamps.

N.B. the touchSMS only uses the Date From parameter here to get messages created after the specified date, but you will need to enter a Date To as well.

touchSMS OttoFMS Webhooks Setup

Please visit the Webhooks using OttoFMS guide for instructions on setting up OttoFMS Webhooks for your touchSMS account. The OttoReceiver script is ready to handle incoming MMS messages from touchSMS.

touchSMS PHP Webhooks Setup

To receive incoming SMS messages to your touchSMS number, including replies to previously sent messages, you will need to use the supplied dedicatedNumberReply.php webhook file to act as the webhook receiver. See our Webhooks guide for what you need to do host the dedicatedNumberReply.php file on your chosen web server. Once you have the publicly accessible URL for this file you can enter this into your 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. 'fmSMS 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: