Connecting TNZ with Keap
Configure Keaps Send HTTP Post campaign action to send SMS through TNZ.
Overview
- TNZ's Keap (InfusionSoft) integration adds SMS Sending capabilities to Keap.
- The Keap contact must have a Mobile field and the Campaign must have a Message field.
- An HTTP success means TNZ accepted the request; it does not mean the SMS was delivered. Reporting and tracking occurs in the TNZ Dashboard.
Set up the integration
In the TNZ Dashboard:
- Log into https://my.tnz.co.nz/
- Under Users, click on your Username.
- Toggle Enable API to On.
- Enable the Sender/APIKey.
- Save your Sender and APIKey values somewhere safe.
In Keap:
- In the Keap campaign builder, add a Send HTTP Post action at the required point.
- Set the URL to
https://api.tnz.co.nz/api/v2.04/HttpApi/SMS. - Add a field named
Senderand enter the dedicated TNZ Sender. - Add a field named
Tokenand enter that User's TNZ APIKey. - Add a field named
Number. Use Keap's Merge control to select the contact field that contains the mobile number. Do not copy a merge-field name from another Keap account without checking it. - Add a field named
Messageand enter the SMS text or the approved merge content. - Save the action. Keep the request as an HTTPS form POST and do not move credentials into the URL.
- Run the campaign with a test contact, then inspect the TNZ delivery result.
Troubleshooting
The request returns 401
Check that Sender and Token contain the dedicated User's Sender and APIKey and that Sender/APIKey access is enabled.
The destination is blank
Open the Number field and select the correct contact mobile field through Keap's Merge control.
Keap reports success but no SMS arrives
Find the message TNZ reporting and review the delivery result.
The HTTP Post action is unavailable
Ask Keap Support whether your edition includes the legacy Send HTTP Post campaign action.
Topics: Installation