MMS Gateway - Telstra
The Telstra MMS Gateway currently delivers MMS messages to countries in this list. You can use the following methods for attaching media files to your outgoing messages:
- Base64 Encoding: simply insert your media into the fmMMS Media container field and they will be Base64 Encoded during the sending process and included in the message payload that is sent to Telstra
You can get further information on supported media files and limitations here:
https://dev.telstra.com/apis/messaging-api/endpoints#tag/messages/operation/sendMessages
https://dev.telstra.com/apis/messaging-api/faqs
Get a Virtual Number
Before you can start sending MMS 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 WebhooksIncomingMessages.php file enter the URL for the WebhooksIncomingMessages.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 MMS 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 fmMMS file in a number ways:
- Use Webhooks to have Telstra 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 - with Webhooks new messages are forwarded to fmMMS automatically by Telstra as they are received.
Telstra Webhooks Setup
To receive incoming MMS messages to your Telstra 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 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 MMS Replies will be pushed to that URL.
Telstra Otto Webhooks Setup
Please visit the Webhooks using Otto guide for instructions on setting up Otto Webhooks for your Telstra 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 Telstra.