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

I need to update the Authorised Representative on my account

To find out the Authorised Representative for your account, please contact your internal billing team. Otherwise, please keep your CIDN (Customer Identification Number) and Telstra account details ready and call 1800 878 483 , option 1 and option 3 and speak to one of our friendly billing consultants to provide required information.

To change the Authorised Representatives on your account, request one of your existing authorised representative on the Telstra account to e-mail with subject “Letter of Auhtorisation” business.care@team.telstra.com along with your full name, your date of birth and your contact details.

Please note any changes to your Telstra Billing Account will take affect across all Telstra services using this number, not just TelstraDev.

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.

 

API FAQs

API General

How can I check the live status of the APIs?

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.

Please see this blog for more information on using callbacks. 

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

 

Internet of Things (IoT)

IoT Connectivity & SIMs

How do I purchase a Telstra IoT M2M SIM?

Small Businesses can purchase standalone M2M IoT plans for Cat-M1 and NB-IoT from their nearest Telstra Business Technology Centre. Please visit https://www.telstra.com.au/small-business/internet-of-things/data-sim-plans for more details.

How can I manage all my IoT SIM accounts in one place?

Small business customers with Telstra IoT SIMs can use the IoT Connection Management Platform. You can gain insights into your fleet connection status and usage data, set alarms to manage performance and investigate connection problems by accessing network data.

How can I manage all my IoT Devices in one place?

Telstra IoT platform is a cloud solution that enables customers to manage, track and control remote assets equipped with sensors and actuators. It is provisioned through a cloud-based self-service platform. If you are an organisation who has the technical resources to create applications & connect devices using the tools and APIs available on the platform, purchasing the platform would be your best option. You can try the platform at no cost for 30 days at buyiot.telstra.com.

After your trial period, you can continue with either of the following 2 options:

  1. Continue on pay-as-you-go monthly subscription charged based on usage for number of devices, API calls, Storage. No lock-in contract. Cancel tenancy anytime
  2. Or opt for Enterprise plans applicable only for high usage. Lock-in contracts may be applicable

Interested?  please call our Telstra Enterprise Internet of Things Solution Centre on 1800 325 220

I think my SIM is not activated

Confirm you are in a Cat-M1 or NB-IoT coverage area. If you are testing in an Arduino MKR NB 1500, follow the steps in our Getting Started guide.

If you have purchased your SIM from TelstraDev, this SIM plan will end from December 30th, 2021. Any SIMs bought from TelstraDev will be deactivated after this date and you will need to purchase a SIM plan from Telstra to continue accessing the Telstra IoT network.

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

The Connected Things API is no longer offered. If you would like to check the usage of a Telstra IoT SIM, check out the IoT Connection Management Platform.

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

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

Does Telstra charge for the full data transmission of IoT payloads, including the Telstra network header and security bytes?

No. Telstra only charges for the payloads our customers send or receive. Any packet additions made by Telstra to safely and securely transport customer data through our network are not included in our usage charges. For example, if your payload is 35kb, the data charge to your account will be 35kb

I get only LTE-M, how can I get NB-IOT? Or I get NB-IoT, how can I get LTE-M?

Make sure your IoT M2M Data plan includes the desired network technology. Set your device’s Radio Access Technology to the desired network. We explain this process in our Arduino Getting Started Guide.

I don’t have an ABN; can I still get Telstra IoT SIMs / Telstra IoT Connection Manager / Telstra IoT Platform (Cumulocity?

No, currently all our IoT plans and platforms are for small busines and enterprise only. Please contact your closest Telstra Business Centre by requesting a call back to discuss your options.

Where can I get a device to test Telstra’s IoT network?

There are many Telstra IoT certified devices on the market! Here is a list of certified Telstra M2M IoT modules and devices: https://www.telstra.com.au/content/dam/shared-component-assets/tecom/iot/capabilities/certified-devices/telstra-m2m-certified-devices-modules.pdf
You can purchase these devices from a tech hobbyist store, or reach out to the device manufacturer directly.

How can I work on a Proof of Concept or IoT trial with Telstra? I’m building an IoT prototype, how can Telstra help?

IoT solution typically comprises:

  • Devices that communicate via a mobile or a fixed network
  • Embedded software that enables the devices to talk to a platform
  • IoT platform (with its own set of tools)
  • Application that would have a set of visualisations, business rules and/or integration to the customer’ back office systems.

Telstra has built capability across the IoT stack to service our customer needs. For specific IoT engagements, we can engage a suitable partner to design, build and implement a solution for our customers.

We are keen to take innovative solutions to market. If you have developed a proof concept / prototype using Telstra’s IoT ecosystem and if we think your prototype fits well into our suite of IoT products and solutions, we would love to evaluate the proposed solution on a case by case basis. Please drop a note on telstradev@team.telstra.com with details of your prototype / solution and we will get back to you.

Where is the latest version of Telstra’s Wireless Application Developer Guidelines?

This document is updated approximately annually, and a link to the latest guidelines can be found here: https://dev.telstra.com/content/wireless-application-developers-guidelines-iot

How do I certify my IoT device with Telstra?

If you are building your own IoT hardware and wish to have it certified with Telstra, please reach out to TelstraDev with your details.

Can I send an SMS message with my IoT device to a mobile phone?

Yes, but check that your IoT data plan includes SMS. Many IoT devices have the capability so send SMS directly from the device (e.g Arduino’s SMS library), however many IoT SIMs are data only and do not include SMS. If your IoT data plan doesn’t include SMS, you can set up a program that uses Telstra Messaging API to trigger SMS based on events from your IoT device. Check out our tutorial on this here: https://github.com/MichelleHowie/IoTSensorData_OnDemand/tree/master/Environmental_Sensor_Data_Push

I’ve asked the Telstra Business Centre about IoT and they can’t help me.

Small Businesses can request account management support here: https://www.telstra.com.au/small-business/support/contact-us/account-management,

Enterprise customers can call our Telstra Enterprise Internet of Things Solution Centre on 1800 325 220: 

  • For Machine to Machine or IoT connectivity press 1
  • For Monitoring, Tracking or Building IoT solutions press 2
  • For Vehicle solutions press 3
  • For Monitored Security solutions press 4
  • For other IoT Solutions press 5

Non business customers can post their question on the TelstraDev forum: https://dev.telstra.com/forum

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

Can I use the data SIM from my phone in the Arduino MKR NB 1500?
The hardware only supports the NBIoT and Cat-M1 (LTE-M) radio access technologies. If your SIM is used in a mobile phone (even data only SIMs) it is not likely to be a NB-IoT or Cat-M1 (LTE-M) connectivity. Please use the SIM that came with your Arduino IoT Starter KIt or order a data SIM plan from the Telstra website. 
 

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.

 

IoT Marketplace and Device Orders

Important – As of July 15th 2021 we are no longer selling IoT devices through the TelstraDev IoT Marketplace. See our blog announcement for more details.

Can I order a device on TelstraDev’s IoT Marketplace?

No, as of July 15th 2021 we no longer sell dev kits or IoT devices on the IoT marketplace. Refer to our blog for more details.

Why is my trial sim no longer working?

The Telstra IoT dev kit trial ends from December 30 2021. After this date, your trial SIM will be deactivated.

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.

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

Reach out to us via our contact methods at /support

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.

 

Arduino MKR NB 1500 

Important – As of July 15th 2021 we are no longer selling IoT devices through the TelstraDev IoT Marketplace. See our blog announcement for more details.

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.
 

How can I get an Arduino MKR NB 1500 device?

As of July 15th 2021, Telstra no longer sells the Arduino MKR NB 1500 devices. You can purchase one from your preferred online retailer or from Arduino directly.

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

Yes. The hardware supports both NB-IoT and Cat-M1 (LTE-M) radio access technologies. 

If you purchased your Arduino MKR NB 1500 from TelstraDev, the SIM included with 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.

 I bought the Arduino device from Telstra, what are my support options (after 30th June 2021)?

TelstraDev team will continue to support existing customers who have purchased Arduino MKRNB1500 board incl. IoT SIM from dev.telstra.com/iot-marketplace for a period of 3 months from purchase. During this period, you can email telstradev@team.telstra.com in case of any issues . and also can continue to access content eg. guides, tutorials, documents, etc

The Arduino I bought from TelstraDev has a hardware fault

Check the Arduino support forums, or contact Arduino for support.

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.

What is the firmware version of my ublox SARA radio module?

The Narrowband connectivity is performed with a module from u-blox, the SARA-R410M-02B, a low power chipset operating in the different bands of the IoT LTE cellular range.

Refer to Arduino's user forum to see how to check the firmware version of the module: https://support.arduino.cc/hc/en-us/articles/360016119159-How-to-check-the-firmware-version-the-SARA-radio-module-u-blox-on-the-MKR-NB-1500 

and to test the module functionality: https://support.arduino.cc/hc/en-us/articles/360013051939-How-to-test-the-Sara-Module-u-blox-of-the-Arduino-MKR-NB-1500

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.

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

Important – As of July 15th 2021 we are no longer selling IoT devices through the TelstraDev IoT Marketplace. See our blog announcement for more details.

Where can I buy a Captis device? Do you offer end to end solutions for Captis IoT solutions?

For more information visit, https://www.telstra.com.au/business-enterprise/products/internet-of-things/solutions/environment-monitoring

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