Sorry, you need to enable JavaScript to visit this website.

Frequently asked questions

These FAQs cover general questions about the TelstraDev portal and our products. If you can't find what you're looking for, post your question to us on our Community Forum.

These FAQs cover general questions about the TelstraDev portal, and some common troubleshooting steps.
For questions related to a specific API, please see that API’s documentation.

If you can’t find what you’re looking for, post your question to our Developer Community Forum and a fellow dev or one of our support team will assist.

Portal FAQs

APIs, apps and keys

I’ve purchased a plan. How do I start using it?

Once you have created a company with valid billing details, you will need to create a new company app to get API keys for your purchased plan. See Company and Billing Details FAQs to see how to create companies.

  1. Login with your developer account.
  2. Switch to your company profile (in the drop-down menu under your name in the top menu bar).
  3. Go to My Apps & Keys
  4. Create a new app with your purchased package, specify a name and create your app. You can now use the key and client ID under the new app you created.

I'm an independent developer and just want to try out the APIs. What can I do?

Once you register on the portal for the first time, you’ll be provided a profile with which you can trial some of our APIs. Our free trial currently allows access to the Messaging API (See the Messaging API Documentation to find what the free trial includes: https://dev.telstra.com/content/messaging-api#section/Features/Free-Trial-vs-Paid-Plan-Features).

Where can I find my free trial keys?

Upon registration, we have created your first app with access to the free trial APIs which you can find via My Apps & Keys.

I am getting an error “Quota reached” on my free trial keys, what does this mean?

You’ve exceeded your free trial limit for that API. The limit per user as of August 2020 is 100 messages. If you’d like to continue using the API, you will need to purchase a plan by creating a company profile and entering your billing details.

How do I get new keys for my existing apps?

We recommend that if you would like new keys immediately, create a new app with the same APIs.

Note: Do NOT delete the Free Trial app if you are using Messaging API, as you will not be able to create another mobile subscription due to limits of one subscription per free trial developer.

How do I use the APIs?

One of the quickest ways to get started is to use the Telstra provided Postman collections.  To find Postman collections for an API, find the Postman button in the Getting Started section of each API.  After you download the collection, you will need to add your API keys.

We have published several tutorials on our blog for you to try: https://dev.telstra.com/blog/tutorials

Are there any SDKs, or sample code, I can use to quickly create my app?

Yes, our APIs have SDKs for popular languages, and we have sample code for our APIs as well in the API Documentation. Check out our open source Github repo at https://github.com/telstra/.

I am getting an error that I don’t understand, where should I go for help?

Check out the API documentation which includes common error messages. Also check the forums, as your question may have already been answered. If you can’t find an explanation, post your questions on our developer forums and a Telstra team member or fellow developer will respond shortly.

 

Company and billing details

How can I add billing details to my developer account?

Billing details are associated to a ‘company’ in TelstraDev. To create a company, log into the TelstraDev portal and go to Create and Manage Companies under your profile name in the top menu bar. At this step, you will be asked for your billing details. All purchases made on the portal under this new ‘company’ will be charged to your preferred billing method.

What payment methods do you accept on TelstraDev?

You can choose to pay by credit card or Telstra Bill. Some features are not available on credit card, check the Pricing and Plans page for details.

What types of credit cards are accepted by TelstraDev?

At this point in time, TelstraDev accepts Visa and MasterCard credit cards.

Why am I getting an error message when entering my credit card details?

The details you are entering may be incorrect or TelstraDev does not accept your card type.  Please check your details and try again.

Are my credit card details stored on the portal?

No credit card details are stored on the TelstraDev portal.

Are all the API features available if I pay by credit card?

Some features are available; however, you will be restricted from accessing some API features if your current billing method is credit card.  Check the pricing & plans page to find out more.

I want to purchase a plan on a Telstra billing account but I don’t have one - can one be created for me?

Yes. Send an email to telstradev@team.telstra.com requesting new account creation. If you have any existing Telstra service, provide details about the account. If you are a new Telstra customer, the account creation team will need a background check before creating an account. Include details (Company Name, ABN, Authorised Representative name, email) in the email and we will be in touch with you thereafter

When are invoices generated?

If you are paying by Credit Card, the company admin will receive an invoice at the beginning of every month for the previous month’s purchases.

If you are paying by Telstra Bill, you will receive your bill as per nominated billing cycle

Is there a dollar limit on my purchased plan?

If you are paying by credit card, you will be limited to $1000 spending per month. This includes API usage and IoT Marketplace purchases.

If you are paying by Telstra Bill, you do not have a limit.

I’ve created a company and added my billing details.  How long till I can use my API plan?

If you create a company with your existing Telstra billing account details, we’ll need 2-5 days to validate your Telstra billing account. You’ll receive an email when billing validation is complete. We will also create a default App (Production API keys) which includes access to the Messaging API. If you have purchased a valid IoT Device (e.g Arduino Dev Kit or Track and Monitor Device) you will already have access to other Production APIs like the Connected Things API.

If you have created a company with validated Credit card billing, passing the Identity Verification (IDV), then you are eligible to purchase some of the IoT devices and APIs approved for sale using credit card. Please note that some APIs are not available on credit card plans and require a valid Telstra billing account. Check our pricing and plans page for details: https://dev.telstra.com/pricing-plan

If you need access to an API or device that is not available via credit card (e.g Messaging API), send an email with your request to telstradev@team.telstra.com If you are paying by credit card, you will get access to your API plan immediately. 

I added my Telstra billing account details but received an email saying my billing details could not be validated. Why is this?

There are a few reasons why your account details may not have been validated. The Telstra account you provided may have been in an incorrect format or the billing details you entered do not match our records. Please check those details and submit again, or contact telstradev@team.telstra.com I received an email that my billing details have been validated. What do I do now?

Log into TelstraDev and select your company profile. From here, you can create a new app via “My apps & keys”.  Add an app with your purchased package, specify a name and create the app. You can now use the new app key and client ID to access all the plan features.

I changed my billing details in the middle of the month, what billing details will be charged?

We will post all your charges for the previous billing period to whatever your current billing method is on the 3rd business day of the month.

Do you do discounts for bulk API usage?

We do offer Enterprise Plans for businesses that commit to high volumes of monthly API calls. If you are an Enterprise customer or will be committing to a regular high volume, please fill out a Sales Enquiry Form from our Support page to discuss your requirements with us. We do not currently offer any other forms of discount.

 

Plans and usage

How do I buy the PAYG plan?

You will need to create a company and enter your credit card details, or link your Telstra billing account;

  1. Go to Pricing & plans and select Buy now for the PAYG plan
  2. Enter your Company and billing details and Submit.
  3. Once your details have been validated you can start to use the PAYG plan
    1. If you are paying by credit card, you will get access to your API plan immediately. 
    2. If you are paying by Telstra Bill, we’ll need 2-5 days to validate your Telstra billing account and confirm it’s in the right format for billing.  You’ll receive an email when billing validation is complete.

  4. Log into TelstraDev and select your company profile. From here you can create a new app via “My apps & keys”.  Add an app with your purchased package, specify a name and create the app. You can now use the new key and client ID to access all the plan features.

I want to upgrade my plan to an enterprise contract, who do I contact?

Complete the sales enquiry form and one of our sales representatives will be in touch.

Where do I go to see my plan usage?

If you’re using the free trial, you can see your usage via the analytics tab of your app.

If you have a paid plan you can find out how much of your plan you’ve used via the billing reports.

Is there any set-up fee on the PAYG plan?

No, all fees charged are based on usage as defined in the PAYG plan.

I want to cancel my plan.  Who do I contact?

Email us at telstradev@team.telstra.com with your contact name, company name, plan and preferred plan end date.

 

User management

How do I add users to my company?

To invite a developer to your company they must have already registered on the portal. Go to the “Manage Users” page and enter a user’s email and invite the developer.  The developer will need to login and accept the invitation to the company before they can view the company’s profile.

What roles can I give user’s in my company?

By default, invited users will have the role “Developer” which allows them to view the company’s apps and keys.  You can increase the user’s privileges by giving them the “Monetisation Administrator” role which allows them to do everything in the company.

I want to change my company administrator/owner.  Who should I contact?

Email us at telstradev@team.telstra.com with the new company administrator’s email and your company details. The new "owner" of the company may be asked to confirm they agree to be contacted in case of billing issues.

Can I be part of multiple companies?

Yes, you can.

Why can’t I see my paid plans when I log in?

When you log in, you’ll be taken to your personal profile each time.  Use the navigation bar to switch the profile to the company under which you purchased a plan.

Do the features included in my paid plan work in all countries?

Our API and SDK services are globally available. Check the API or IoT Device specific documentation for the offshore feature availabilities.

 

IoT Marketplace FAQs

IoT Connectivity and Device Orders 

How can I order an IoT Device on the Marketplace?

To purchase a device from the TelstraDev IoT marketplace, you must have a developer account, and a ‘company’ with valid billing details. See ‘Company and billing details’ FAQ for instructions.

If you do not have a Company ABN and cannot create a valid company to proceed with your purchase, that’s OK. Please contact us to arrange at telstradev@team.telstra.com

When you accept the terms and conditions of your product purchase and submit the order, you should receive an email containing your order details. ETA of the order is approximately 5 days. Please allow delays for regional shipments.

Can I use credit card to purchase IoT devices?

Some devices are available, but some require a valid Telstra billing account and are not available if your current billing method is credit card.  Refer to the device’s product page for ‘Things to Know’ before you buy.

Where can I see more details about my device order?

When your order is completed, you should receive an email with your order confirmation and details. If you did not receive this order confirmation email, you may not have completed the purchase. You can review your order history by logging into the company account, and heading to https://dev.telstra.com/manage-order under the settings cog.

My device order is stuck in ‘pending’

If your order seems to be stuck in ‘pending’, please ensure you've made the purchase when in the correct company profile with valid billing details (Use the top navigation bar to switch the profile to the company under which you purchased a plan). If you created a billing company during the checkout process, you would need to navigate to the IoT Marketplace and submit the order for the device before it can be processed.

If your order is not processed because the billing details of your company are stuck in ‘pending’ for more than a few days, please contact us.

I need a bulk order of the devices, where do I get them?

Reach out to us via our contact methods at https://dev.telstra.com/support

My M2M SIM is broken/lost how do I get a new one

Drop us a line via one of our contact methods here https://dev.telstra.com/support

I think my SIM is not activated

If your debugging shows the SIM is not connected, and you’ve confirmed you are in the Cat-M1 coverage area, contact TelstraDev and we can check the status of your SIM. Please provide your ICCID number which is the number on the back of your IoT SIM card.

How can I check the data usage of my IoT SIM?

To check the usage of an IoT data SIM included in your IoT device bundle, you can use our Connected Things API: https://dev.telstra.com/content/connected-things-api. You will only be able to access the SIM details of SIM cards that came with your TelstraDev IoT device purchase under a valid company profile, when using the API keys of that same profile. 

I need more M2M SIMs, where can I get them?

We have launched standalone LPWAN plans (Cat-M1 or Narrowband SIM) for Small Business and Telstra IoT Data Sim plans. Please visit https://www.telstra.com.au/small-business/internet-of-things/data-sim-plans for more details.

If I purchase a new Telstra IoT Data SIM will I still have access to it via the TelstraDev Connected Things API

You will only be able to access the SIM details of SIM cards that came with your TelstraDev device. If you wish to use the Connected Things API with another Telstra IoT SIM (i.e purchased off of the Telstra.com website) Please contact us to arrange at telstradev@team.telstra.com.

Can I use a data SIM card in a Cat-M1/Narrowband device?

No, you cannot use a LTE (4G) data and voice SIM card in most Cat-M1 and Narrowband specific devices, as it connects into a different network type. You must use a Cat-M1 or Narrowband SIM for use with these networks.

Where can I check IoT coverage?

Telstra’s IoT coverage can be found here https://www.telstra.com.au/business-enterprise/solutions/internet-of-things/iot-coverage.

What is the difference between Narrowband (NB-IoT) and Cat-M1 (LTE-M) networks?

Both Narrowband and Cat-M1 are IoT-centric networks, but there are some key differences between them. The main differences are network reach, with Telstra’s Narrowband network having over 4 million sq kms of coverage in Australia and Telstra’s Cat-M1 having over 3.5 million sq kms of coverage in Australia. Typically you can expect lower power usage with Narrowband, but this depends on the use case and setup.

Your network design choices can have significant effects on how well your application works, as well as potentially give your product or solution a competitive edge and improve its performance. To better understand how to best develop for our mobile network, refer to our Wireless Application Development Guidelines

I built a really amazing thing that I want to share

We want to hear from you! Post on our Developer Community Forum or reach out via https://dev.telstra.com/support so we can chat about getting a writeup or blog post.

Arduino MKR NB 1500 

Important – take extra care when clipping the MKR NB 1500 antenna on and off as the clip is very small and quite easily broken! Accidental damage is not covered under the Voluntary Product Warranty that comes with the MKR NB 1500.

What data connectivity is included with the Arduino MKR NB 1500 on the TelstraDev IoT Marketplace?

With the included Cat-M1 SIM, you have a 60MB data allowance for 180 days (i.e 6 months) from the date of purchase, included in the Arduino purchase price.

After 6 months or exceeding 60MB data usage (whichever comes first), the SIM will be deactivated. If you wish to continue using the Cat-M1 IoT Network, you can order a data SIM plan from the Telstra website

Can I use the Narrowband (NB-IoT) network with my Arduino MKR NB 1500?

Yes, but the SIM included with our bundle is a Cat-M1 only SIM. If you have your own NB-IoT SIM, you may need to upgrade the UBLOX firmware to connect to that network.

Where do I get the Arduino NB library for the MKR NB 1500?

The official library is available at https://github.com/arduino-libraries/MKRNB. The library is also available via the latest Arduino IDE by going to Sketch > Include Library > Manage Libraries and searching for MKRNB.

I’m having issues with the Arduino library

Checkout the Arduino support forums at https://forum.arduino.cc/index.php?board=107.0. Also have a look at the MKR GitHub repo https://github.com/arduino-libraries/MKRNB.

I want to upgrade the firmware on my board’s u-blox SARA component

The u-blox website contains some useful documentation on the SARA-R4 series, and a SARA-R4 data sheet which includes more information on firmware upgrades. To get a copy of any firmware upgrades, you must register with U-BLOX and raise a ticket directly on their website.

The IoT device is connected to Telstra’s network but doesn’t get data from anywhere

Check the libraries you are using especially making sure you have the latest version of the MKR NB 1500 library https://github.com/arduino-libraries/MKRNB. Check the SIM card is installed correctly and has been activated via the dev portal also checking that you have Cat-M1 coverage available via the coverage maps https://www.telstra.com.au/business-enterprise/solutions/internet-of-things/iot-coverage.

My MKR NB 1500 device won’t do anything

Try running the blink sketch that comes with the Arduino IDE which will make LED 13 blink on the board. Also try doing Serial.println output to show what the device is doing.

My antenna clip has broken, what can I do?

You need to take extra special care when dealing with this tiny component, sadly there is no way that this can be reattached beyond trying to solder the clip back on.

I ordered an MKR NB 1500 and I didn’t get a … [SIMcard/antenna/board]

We will look into your order for you, please drop us a line via one of our contact methods here https://dev.telstra.com/support and include your order number.

How do I get more involved with open source projects?

Open source projects are always looking for people to get more involved. While most are code based you don’t have to write or contribute code to a project, just testing a new version of the library or proof reading READMEs. Head on over to https://github.com/Telstra or https://github.com/Arduino-libraries to get started

 

Captis

How do I connect the Captis device to the IoT network?

Your device comes with a Telstra IoT SIM card build in. The SIM card is on a plan on a recurring monthly subscription.

How long will the battery last?

The expected battery life of the device is dependent on multiple factors.  Under standard operating conditions Telstra warrants the device for 5 years or 5,000 transmissions (whichever comes first). Refer Warranty details for standard operating conditions.

Is the device waterproof?

The device is rated IP68 which means its water and dust resistant. The device is not waterproof and will be affected if submerged in water for any length of time

What can I monitor with my Captis Device?

Using one of our sensors, you can implement many environmental monitoring use cases include Water Level, Pressure, Flow and quality (recording parameters such as pH, conductivity, and ORP), solar radiation, rainfall, temperature, air quality and wind speed.

Temperature & Humidity: Monitor the ambient air temperature, rail temperature or fridge temperature, even in a power failure.

Infrastructure: Monitor water usage, lux, noise, vibration of entertainment precincts, construction sites etc.

Smart Relays: Monitor the health and performance of your equipment.

Controls: Control pumps, valves and alarms in response to data readings.

What’s the difference between the Captis Multi and Pulse Lite.

Captis Pulse Lite supports up to 2 digital inputs (Pulse and Switch mode)

Captis Multi supports the above inputs as well as  1 analog input, 1 serial input and 2 digital outputs

 How can I do a software/firmware upgrade on my Captis Devices?

You need to contact Captis support team

Can I replace the battery on my own?

No, you can’t.

Can I resell Captis?

No, you can’t

 

API FAQs

API General

What is the Service Availability on the APIs?

Our Service Availability on all APIs is 99.95% unless stated otherwise. You can check our live status page :  http://status.dev.telstra.com which currently monitors Telstra Messaging API end points and provides operational insights on the availability and performance of the APIs.

The API feature I want is not on your portal. What can I do?

We love hearing your suggestions for new API endpoints or features that add value to developers on the Telstra network! Please post your suggestions on our community forum, or email us.

 

Messaging API

Is creating a subscription via the Provisioning call a required step?

Yes. You will only be able to start sending messages if you have a provisioned dedicated number. Use Provisioning to create a dedicated number subscription, or renew your dedicated number if it has expired.

When trying to send an SMS I receive a 400-Bad-Request or a 404-RESOURCE-NOT-FOUND response. How can I fix this? 

You need to make sure you have a provisioned dedicated number before you can send an SMS. Use Provisioning to create a dedicated number subscription, or renew your dedicated number if it has expired. Perform a GET /provisioning/subscriptions call and ensure that your provisioned number is still actively linked to your API key. Otherwise, you will need to perform a POST /provisioning/subscriptions call to re-provision your API MSISDN to your API key.

If you do not have a provisioned dedicated number and you try to send a message via the API, you will get the error below in the response.

{
  "status":"400",
  "code":"DELIVERY-IMPOSSIBLE",
  "message":"Invalid \'from\' address specified"
}

OR

{
  "status":"404",
  "code":"RESOURCE-NOT-FOUND",
  "message":"Invalid resource. Refer to API docs at https://dev.telstra.com"
}

When trying to send an SMS I receive a 400 Bad Request response. How can I fix this?

You need to make sure you have a provisioned dedicated number before you can send an SMS. If you do not have a provisioned dedicated number and you try to send a message via the API, you will get the error below in the response:

{
  "status":"400",
  "code":"DELIVERY-IMPOSSIBLE",
  "message":"Invalid \'from\' address specified"
}

Use Provisioning to create a dedicated number subscription, or renew your dedicated number if it has expired.

What are the costs of dedicated number provisioning?

Messaging API is charged based on usage, i.e. number of SMS / MMS sent. At this stage, we do not charge for provisioning dedicated numbers as that is included with the API usage.

How many dedicated numbers (subscriptions) can I provision?

Free Trial users are limited to ONE virtual mobile number only. Do not delete the app you used for creating your first subscription or you will no longer have access to the Messaging API free trial.

For paid accounts, to create multiple dedicated virtual mobile numbers, create new apps under "My Apps & Keys". Each API key will be associated to a dedicated number (1:1 mapping). If you wish to create more than FIVE apps, please contact us for support.

Can I use my own mobile number to send messages from the Messaging API?

We are not able to manually associate a particular number with your Client Credentials. This includes porting Virtual Mobile Numbers (VNMs) from other accounts or between apps (i.e from free to paid keys). When you provision your own virtual mobile number by calling CREATE SUBSCRIPTION you are assigned a new number.

How long does my dedicated number stay active for?

When you provision a dedicated number, by default it will be active for 30 days. You can use the activeDays parameter during the provisioning call to increment or decrement the number of days your dedicated number will remain active. If the Provisioning call is made several times within that 30-Day period, it will return the expiryDate in the Unix format and will not add any activeDays until after that expiryDate.

Note that Free Trial apps will have 30 days as the maximum activeDays they can add to their provisioned number. Paid accounts have a maximum of 5 years.

Can I send a broadcast message using the Telstra Messaging API?

Yes. Recipient numbers can be in the form of an array of strings if a broadcast message needs to be sent, allowing you to send to multiple mobile numbers in one API call. A sample request body for this will be: {"to":["+61412345678","+61487654321"],"body":"Test Message"}

How many recipient numbers can I send a broadcast message to at one time?

The API currently supports up to 10 recipient numbers in the "to" array.

Can I send SMS and MMS to all countries?

You can send SMS and MMS to the countries in this list, provided the destination network supports delivery. The above list is an indication of reach, but we don’t currently send messages to all these countries. Traffic to international destinations is sent on a best endeavour basis as end to end SLAs to foreign operators are not available

For you to send SMS internationally, you must provide the country code plus the mobile number of your recipient in the "To" field, e.g “+82 87 6542 2100”.

International endpoints (outside of Australia) have some limitations. For example; Alphanumeric identifiers will only reliably work in Australia.

Can I use the Telstra Messaging API if I am based outside of Australia?

Yes, you can use our Messaging API outside Australia. However, the subscription you create with the API to send “from” will be an Australia Virtual Mobile Number.

Why is my Alphanumeric Identifier  failing to send?

Please ensure your message complies with the Alphanumeric Identifier rules

  1. ​Alphanumeric identifiers will only reliably work in Australia as many other countries (and thus carriers in those countries) around the world will block messages alphanumeric "from" addresses. You can refer to this forum post https://dev.telstra.com/content/assigning-alphanumeric-identifier-address
  2. Phone numbers in the from attribute will be blocked (400-error) to prevent number spoofing.
  3. There are specific characters which are not allowed in the "from" attribute (space, <, >, etc)
  4. If the "from" attribute is not present, the service will use the mobile number associated with the application (in E.164 format).
  5. If replyRequest is set to true, then the "from" field should not be present.
  6. This feature is only available on Telstra Account paid plans, not through Free Trials or a credit card paid plans. You can refer to the messaging API documentation: https://dev.telstra.com/content/messaging-api#operation/sendSms

If you pass all of the above criteria, and you’re still unable to use the Alphanumeric Identifier, please contact support.

Can I use Alphanumeric Identifier from my paid plan via credit card?

Alphanumeric Identifier is only available on Telstra Account paid plans, not through credit card paid plans.

Can I use Messaging API from my paid plan via credit card billing?

No. As of 1 June 2020, developers no longer have access Messaging API production keys with new credit card billing accounts. To access the paid account for Messaging API, you must create a company with a Telstra Billing account number associated. If you are not an existing Telstra customer, or if you are an existing Telstra customer but don't have a 10 digit account number ending in 0, please contact TelstraDev support to create one.

If you already have access to the Messaging API production keys with an existing Credit Card billing method, your account will not be affected by this change. This applies only to new accounts.

What is the maximum sized MMS that I can send?

This will depend on the carrier that will receive the MMS. For Telstra it's up to 2MB, Optus up to 1.5MB and Vodafone only allows up to 500kB. You will need to check with international carriers for their MMS size limits. The subject size is limited to 64 characters.

How is the size of an MMS calculated?

Images are scaled up to approximately 4/3 when base64 encoded. Additionally, there is approximately 200 bytes of overhead on each MMS. Assuming the maximum MMS that can be sent on Telstra’s network is 2MB, then the maximum image size that can be sent will be approximately 1.378MB (1.378 x 1.34 + 200, without SOAP encapsulation).

How is an MMS classified as Small or Large?

MMSes with numberSegments below 600 are classed as Small whereas those that are bigger than 600 are classed as Large. They will be charged accordingly.

Are SMILs supported by the Messaging API?

While there will be no error if you send an MMS with a SMIL presentation, the actual layout or sequence defined in the SMIL may not display as expected because most of the new smartphone devices ignore the SMIL presentation layer. SMIL was used in feature phones which had limited capability and SMIL allowed a powerpoint type presentation to be provided. Smartphones now have the capability to display video which is the better option for presentations. It is recommended that MMS messages should just drop the SMIL.

Can I use the Messaging API to receive inbound messages? Are they charged?

You can send and receive messages via the API by using the notifyURL feature. See the documentation for more info: https://dev.telstra.com/content/messaging-api#operation/retrieveSmsReplies

You will not be charged for any inbound messages to your virtual mobile number retrieved via GET /messages/sms. However, receipts via GET /messages/sms/{messageId}/status are charged (first read only).

How do I assign a delivery notification or callback URL?

You can assign a delivery notification or callback URL by adding the notifyURL parameter in the body of the request when you send a message. Once the message has been delivered, a notification will then be posted to this callback URL.

Why can’t I get the status of my message?

You can retrieve the replies to your virtual number under the following circumstances:

  1. If the subscription has a notifyURL, and replyRequest = True in outbound SMS payload, then
     

    1. Inbound messages will be logged to the notifyURL
    2. Cannot retrieve the reply using GET call
    3. Inbound replies received within 7 days of sending will be available via notifyURL
  2. If the subscription has a notifyURL, and replyRequest = false or not set at all in outbound SMS payload, then
     

    1. Inbound messages will be logged to the notifyURL
    2. Cannot retrieve the reply using GET call
    3. Inbound replies received anytime (eg. 2 weeks) will be available via notifyURL and accessible anytime
  3. If the subscription does not have a notifyURL, then
     

    1. Messages can be retrieved using GET call
    2. Inbound replies received anytime (eg. 2 weeks) will be available via the GET call only for 7 days from receiving the inbound reply

See our Messaging API docs for more info on using the NotifyURL and replyRequests. We also have some relevant blog on callbacks and Conversation via the Telstra Messaging API

Sometimes I am missing delivery receipts, why is this happening?

Telstra can guarantee delivery receipts are provided for any mobile service connected on Telstra's network so long as the destination handset is able to receive SMS or MMS messages. For other carriers, although messages will be delivered to valid handsets on those carriers, they do not have an obligation to provide delivery receipts back to Telstra.

What is the difference between the notifyURL parameter in the Provisoning call versus the notifyURL parameter in the Send Message call?

A. The notifyURL in the Provisoning call will be the URL where replies to the provisioned number will be posted. On the other hand, the notifyURL in the Send Message call will be the URL where the delivery notification will be posted, e.g. when an SMS has already been delivered to the recipient.

Is there a specific format for the notifyURL parameter?

The notifyURL should be a complete URL address which includes the protocol identifier (e.g. https://). It should also have a forward slash at the end if it is just a domain (e.g. http://www.example.com/).

Is Telstra Messaging API suitable for high volumes of SMS/MMS?

Yes, we can accommodate sending a large volume of messages per user (>100k/month) and have several active users enjoying large monthly usage. If you require high volumes of SMS or MMS, please contact us to arrange technical support.

Note: Free Trial use is limited to 100 messages total (prior to August 2020 the limit was 1000 messages per user). If you are using the API keys available under the company profile (i.e. Production Keys), there is no restriction on the number of messages you can send.

We are always improving our services to provide an increasing capacity for number of messages sent per second through the TelstraDev gateway. If you have a requirement for high throughput campaigns, please reach out to us to discuss your options.

Why should I consider the Telstra Messaging API?

Check out the Telstra Enterprise website for an introduction to Messaging API as a solution: https://www.telstra.com.au/business-enterprise/products/mobility-solutions/messaging-and-apis/messaging-api  

 

Telstra Event Detection API

What is the Telstra Event Detection (TED) API?

The Telstra Event Detection (TED) API is a subscription based service from Telstra that enables a customer to be alerted when a particular network event is detected in connection with a registered mobile number that may indicate that a fraudulent misuse of an end user’s mobility service is about to occur.

What are the network events that the TED API can detect?

Currently the TED API is able to detect a bundle of events associated with Telstra SIM swaps.

Can TED API detect number porting between operators other than Telstra? E.g. Optus to Vodafone?

No, we don't report these type of events at present.

How quickly are the network events detected?

This will vary depending on the event being detected, but generally we detect the event within a couple of seconds of it occurring and notify subscribers within near real time via the API.

How long does Telstra store the event data for?

Event data is stored for 90 days from the occurrence of a network event and then securely purged.

Is there a limit to the number of registered mobile numbers I can have for the Telstra Event Detection API?

No. You may have as many Telstra Event Detection API registered mobile numbers as you require within practical limits.

Why is monitoring for SIM SWAP events important?

Criminals are becoming much more savvy and will often try to circumvent two factor authentication protocols by swapping the SIM card for a particular mobile number in order to gain fraudulent access to the end user’s service. Monitoring for SIM swap events may provide early detection that this is occurring and help prevent criminals from being successful in their endeavours.

If an end user is currently a customer of a Telstra Reseller that still utilises the Telstra Network, am I able to detect their Network events?

No. Telstra resellers such as Aldi Mobile are Mobile Virtual Network Operators (MVNO) that operate as totally independent businesses to Telstra. The Telstra SIM swap API does not monitor MNVO network events at present.

How do I purchase Telstra Event Detection API?

At the moment, the Telstra Event Detection API is only available through your Telstra Account Manager. If you don't have a Telstra Account Manager, or are not sure who they are, please submit a sales enquiry.

What support options are available for the Telstra Event Detection API?

We provide 24/7 telephone based technical support (for paid plans) along with email support and an online community forum.

Do you detect network events from another carrier?

The Telstra Event Detection API detects network events associated with the Telstra network and Telstra mobile services.

Which Telstra personnel have access to the event detection data?

Access to Telstra Event Detection data is restricted to only Telstra personnel that require access for the purposes of providing the service.

Why should I purchase the Telstra Event Detection API from Telstra?

As the network events are occurring on the Telstra network, Telstra is in a position to be able to provide fast notification of an event as it is occurring, helping subscribers to prevent fraudulent activity from occurring and to minimise the resulting financial losses.

If I require assistance setting up my Telstra Event Detection API, are there any Professional Services options available to me?

At the current time, the Telstra Event Detection API does not have any Professional Service options available.

What subscription options are available for Telstra Event Detection API?

There is a month-by-month Pay As You Go (PAYG) plan or 12 Month contract option available.

Do Early Termination Charges (ETCs) apply?

If you have subscribed to a 12 month contract and want to terminate the plan or downgrade to a lower plan before the expiry of your existing 12 month term, we may charge you ETCs.

What privacy requirements apply to my use of the Telstra Event Detection API?

Before registering an end user's mobile number with Telstra Event Detection API, you must:

  1. prepare an "End User Notification" for our approval, which sets out what end user information will be disclosed via the API, the purposes for which that information will be disclosed, and to which third parties that information will be disclosed;
  2. provide each of your end user with the End User Notification; and
  3. obtain express, informed consent from each end user to the use and disclosure of their event data via the API for the purposes set out in the notification.

What terms and conditions apply to my use of the Telstra Event Detection API?

Before using the Telstra Event Detection API, you must agree to the TED API "Our Customer Terms".

 

Back to the top