Welcome to TNZ SMS!

This guide will help you integrate TNZ SMS with your Marketplace app. We'll cover everything from starting a trial to setting TNZ as your default SMS provider, and troubleshooting common issues.

In This Guide

  1. Getting Started: Trials & Enquiries
  2. Connecting TNZ SMS
  3. Setting TNZ as Your Default SMS Provider (Optional)
  4. Sending & Receiving SMS
  5. Exclusive Focus on New Zealand and Australia
  6. Troubleshooting Common Issues
  7. Frequently Asked Questions (Short Codes, Sender IDs, Notifications, and More)
  8. Additional Assistance

 

Getting Started: Trials & Inquiries

If you're ready for a trial, TNZ will ask about your intended use (appointment reminders, order notifications, etc.) to ensure your trial setup matches your needs.

Once you provide these details, TNZ activates your free 14-day trial with 30 SMS credits.

You'll receive a welcome email with TNZ Dashboard access and instructions on how to connect TNZ SMS.

Starter Plan Pricing (NZD, ex GST):

  • $0 Setup
  • $20/Month
  • $0/SubAccount
  • $0.10/SMS Part to NZ Mobiles
  • $0.10/SMS Part to AU Mobiles
  • $0.20/SMS Part to International Mobiles

 

Connecting TNZ SMS

1. Set Up Your TNZ Account

  • Visit https://my.tnz.co.nz and log in or register for an account.
  • Your TNZ username must match your app username for a seamless connection.

 

2. Connect TNZ

  • In the TNZ Dashboard, go to Service Settings → Integrations.

  • Select your app and follow the prompts to authorise your access.

 

3. Set TNZ as the Default SMS Provider (Optional)

This step must be performed by an Agency Admin or Owner.

  • Log into your app as your Agency Admin user.
  • Switch to a subaccount where you want TNZ SMS as the default.
  • Go to Settings → Phone Numbers → Advanced Settings.
  • Choose TNZ SMS Provider as the default SMS provider and click Save.
  • Repeat this process for each subaccount where TNZ SMS should be the default provider.

 

Premium Action Costs

Using "Send TNZ SMS" or "Send TNZ Internal SMS" actions incurs a premium action cost unless TNZ is set as the default provider. Setting TNZ as the default so that you can use the standard "Send SMS" options can help you avoid these additional charges.

 

Sending & Receiving SMS Messages

Sending Using "SMS" versus "TNZ SMS"

If TNZ is the default provider, the built-in "Send SMS" option in Conversations, Bulk Actions, and Workflows work. All messages sent via the default "Send SMS" action route through TNZ automatically.

If TNZ is not the default provider, use the "Send TNZ SMS" or "Send TNZ Internal SMS" actions in Workflows and Automations to route messages through TNZ.

 

 

Receiving SMS Replies

Replies from your contacts appear in the Conversations tab.

You can view replies in the TNZ Dashboard and may optionally receive email notifications.

 

Send SMS in Workflows

You can optionally use SMS messaging in Automations, for example, automatically send a welcome SMS when creating a new Contact, or sending a Happy Birthday message on a contact's birthday.

Note: The "TNZ SMS" actions incur a Premium Action cost (an additional fee charged to you by the marketplace). You can avoid this cost by setting TNZ SMS as the default SMS Provider (in Step 3 above).

1. Create a new Workflow or open an existing one


2. Configure an appropriate 'Trigger' that will cause your workflow to run

3. Add a new 'Action' and find 'Send SMS'

• Send SMS uses the default SMS settings. If your default SMS Provider is TNZ SMS (set up in Step 3), it will use TNZ SMS.

• Send TNZ SMS forces using TNZ SMS.

• Send TNZ Internal SMS forces using TNZ SMS to send a message to internal app users.

4. Enter your Message and send a test before saving your action

• Action Name is a description displayed in your workflow.
• Override TNZ User allows you to select the SMS Sender that should receive reports for the messages. By default, leave blank.
• Mobile Number is the mobile telephone number that should receive the SMS message. You may specify up to five other mobile numbers separated by commas. For international messages, ensure you use the full country code including the leading +.
• Message contains the SMS message to send and may include dynamic values. You may send messages longer than 160 characters and are charged per SMS Part (see Long SMS Messages).

 

Exclusive Focus on New Zealand and Australia

TNZ SMS provides competitive pricing and unparalleled service quality for sending SMS to mobile numbers in New Zealand and Australia. This regional focus ensures reliable message delivery and compliance with local carrier rules, making TNZ the ideal choice for businesses operating in these areas.

 

Troubleshooting Common Issues

Messages Stuck as "Pending"

  1. Check the mobile number is correct: A good tip is to try calling the mobile number to ensure it's valid.
  2. Try using the "TNZ SMS" option: Send a test message using the "TNZ SMS" tab, which confirms whether the "default SMS Provider" setting is at fault.
  3. Try re-installing the TNZ SMS app:
    1. In Agency view, go to App Marketplace → Installed Apps.
    2. Uninstall TNZ SMS from all subaccounts (not your agency).
    3. Refresh the page.
    4. Click the + icon and re-add TNZ SMS for the subaccounts.

At the time of writing, using a custom SMS Provider (such as TNZ SMS) is not supported for some features including Send Review Request and Missed Call Text-Back.

Disable Email Notifications for SMS Replies

To disable email notifications for SMS replies:

  1. Log into the TNZ Dashboard.
  2. Go to Users, select your user email.
  3. Click the SMS tab.
  4. Set the SMS Reply Report Method to None.
  5. Click Update.

 

Frequently Asked Questions

Q: Can I Use My Own Mobile Number or a Custom Sender ID?
A: No, when sending to New Zealand mobiles, TNZ uses short codes only. Custom sender IDs are not supported. When sending to Australia and some international locations, a Custom Sender ID is supported.

Q: Do I Need to Leave the app to Send SMS?
A: No, all sending, receiving, and automation occurs within your app.

Q: Why Are Messages "Pending"?
A: Usually because TNZ isn't set as the default SMS provider or the app needs reinstalling.

Dealing with Hard-Coded Features

Some features (e.g., "Request Review") use LeadConnector SMS by default and cannot be changed.

To work around this, create a custom Workflow with a trigger (e.g., Contact Tag added) and add a "Send TNZ SMS" action to the Workflow for using TNZ in these scenarios.

Additional Assistance

We're here to help! If you have any questions or need further support, please don't hesitate to reach out. Our team at TNZ is dedicated to ensuring you make the most of your SMS integration.

Contact us via email or phone for personalised assistance, or visit our Help Centre for more resources. Let's work together to streamline your communication and keep your business connected with your customers effortlessly.