SMS Gateway - Telstra

The Telstra SMS Gateway currently delivers SMS messages to countries in this list.

Get a Virtual Number

Before you can start sending SMS messages with Telstra you will first need to request a Virtual Number to use as your Sender ID using the Messaging API. We have added a script to perform this function within the fmSMS file. On the Account Details screen when you have selected Telstra as your Gateway you will see a Get a Virtual Number button:

You will need to first enter your Telstra API Key Client ID in the Username field and your Telstra API Key Client Secret in the Password field. If you plan to receive incoming messages using the dedicatedNumberReply.php file enter the URL for the dedicatedNumberReply.php file in the Custom Text 2 field which will set the value for the replyCallbackUrl that Telstra will post new incoming messages to. Then click the Get a Virtual Number button which will request a virtual number and populate your Telstra number in the Custom Text 1 field automatically.

If you wish to modify your assigned Virtual Number (e.g. to change the replyCallbackUrl parameter for incoming webhooks) you can click the Update Virtual Number button instead which appears when there is a phone number in the Custom Text 1 field:

Free Trial Recipient Number Registration

Your Free Trial Numbers are the 10 recipient mobile numbers that you can message during the Free Trial. The first five numbers you send an SMS/MMS to will automatically be added to your Free Trial Numbers list. After that, you can register another five (you can also register all 10 numbers as well).

If you are using the free trial with the Telstra Messaging API you can add a new number to your free trial numbers list by clicking the Add Telstra Free Trial Number button in the Account Details screen:

This will prompt you to enter the mobile number you wish to add:

Enter the number and click OK. If this was successful you will now be able to send SMS messages to that number as part of your Telstra free trial.

Incoming Messages/Replies

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

• Manually Download Incoming Messages
• Use Webhooks to have Telstra push these automatically to fmSMS
• Use Claris Connect Webhooks
• Use Otto Webhooks

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 Telstra as they are received.

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 Telstra 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.

Telstra Webhooks Setup

To receive incoming SMS messages to your Telstra 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 fmSMS Account settings in the Custom Text 2 field.

If your Telstra Virtual Number has has a replyCallbackUrl parameter set then any SMS Replies will be pushed to that URL.

Telstra Claris Connect Webhooks Setup

Please visit the Webhooks using Claris Connect guide for instructions on setting up Claris Connect Webhooks for your Telstra number.

Telstra Otto Webhooks Setup

Please visit the Webhooks using Otto guide for instructions on setting up Otto Webhooks for your Telstra number.