Using the Address Book in the TNZ Dashboard for SMS Messaging

The Address Book in the TNZ Dashboard is a central location for storing, managing, and sending messages to your contacts. It supports CSV, XLS, and XLSX imports, shows contact names in reports, and lets multiple users share access (depending on Address Book ownership settings). This guide explains how to import contacts, review contact records, and send broadcasts.

Why use the Address Book?

Adding Contacts

To open the Address Book, log into the Dashboard and select Address Book from the menu.

You can add contacts in three ways:

Sending Messages to Contacts

Creating a Personalised Broadcast

Under New Message | Send SMS Broadcast you can create a personalised broadcast by selecting your Address Book contacts and groups.

You can reference personalised values like "Hi [[FirstName]]".

See How To Send SMS Broadcasts.

Creating a message from the Address Book

You can send a message to contacts directly in the address book.

• Single contact: Click on a contact, then select New Message > Send SMS
• Multiple contacts: Use the checkboxes to select contacts, then choose Action > Send SMS

Using Email-to-SMS

Your address book groups are automatically allocated an email address.

You can find the group code here:

Then send an email to:

group.%group_code%@sms.tnz.co.nz

Using the REST API

The API allows you to send messages to address book contacts and groups.

Documentation: 
1. Sending SMS Messages
2. Adding Contacts

        [
            { "ContactID": "6000000b-f002-4007-b00a-c00000000001" },
            { "GroupID": "4000000b-f002-4007-b00a-c00000000002" }
        ]

Managing Unsubscribes

Every SMS broadcast must include an unsubscribe option. Common formats:

When a user replies with STOP or clicks the [[STOP]] link, they are automatically added to your Opt-out List.

See the Unsubscribe Option for SMS Messages guide for more detail on automated unsubscribes.