tnzapi 2.1.0.1

TNZ REST API Helper Library for Python

tnzapi

Documentation

The documentation for the TNZ API can be found here.

Versions

tnzapi uses a modified version of Semantic Versioning for all changes. See this document for details.

Supported Python Versions

This library supports the following Python implementations:

• Python 3.8
• Python 3.9

Installation

Install from PyPi using pip, a package manager for Python.

pip install tnzapi

Don't have pip installed? Try installing it, by running this from the command line:

$ curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python

python setup.py install

You may need to run the above commands with sudo.

Getting Started

Getting started with the TNZ API couldn't be easier. Create a Client and you're ready to go.

API Credentials

The TNZAPI needs your TNZ API credentials. You can either pass these directly to the constructor (see the code below) or via environment variables.

from tnzapi import TNZAPI

client = TNZAPI()

client.Sender = "[e-mail]"
client.APIKey = "ABC123"

Send an SMS

from tnzapi import TNZAPI

client = TNZAPI(
    Sender="[e-mail]",
    APIKey="ABC123",
)

request = client.Send.SMS(
    Reference="Test",
    MessageText = "Test SMS Message click [[Reply]] to opt out",
    Recipients = ["[phone]"],
)

response = request.SendMessage()

print(repr(response))

Send a Fax Document

from tnzapi import TNZAPI

client = TNZAPI(
    Sender="[e-mail]",
    APIKey="ABC123",
)

request = client.Send.Fax(
    Recipients = "[phone]",
    Attachments = ["C:\\Document.pdf"]
)

response = request.SendMessage()

print(repr(response))

Make a Call - Text-to-Speech (TTS)

from tnzapi import TNZAPI

client = TNZAPI(
    Sender="[e-mail]",
    APIKey="ABC123",
)

request = client.Send.TTS(
    Recipients = "[phone]",
    Reference = "Voice Test - 64211232345",
    MessageToPeople = "Hi there!"
)

request.AddKeypad(Tone=1,RouteNumber="[phone]",Play="You pressed 1")

response = request.SendMessage()

print(repr(response))

Make a Call - Upload MP3 / Wav File

from tnzapi import TNZAPI

client = TNZAPI(
    Sender="[e-mail]",
    APIKey="ABC123",
)

request = client.Send.Voice(
    Recipients = "[phone]",
    Reference = "Voice Test - 64211232345",
)

request.AddMessageData("MessageToPeople","C:\\file1.wav")
request.AddMessageData("MessageToAnswerPhones","C:\\file2.wav")

request.AddKeypad(Tone=1,RouteNumber="[phone]",PlayFile="C:\\file3.wav")

response = request.SendMessage()

print(repr(response))

Getting help

If you need help installing or using the library, please check the TNZ Contact if you don't find an answer to your question.