Private Integrations
Private Integrations is where you connect Zonitel to a CRM, a booking system or your own dashboard. Find the screen and its three tabs, create and rotate access credentials, understand what calls and messaging can be automated, and follow the links to the two developer guides.
Private Integrations is where you connect Zonitel to software you already run — a CRM, a booking system, an internal dashboard. You create an access credential here, and your developer uses it to read your calls and messages or to act on them.
Where to find it
Log in to your Zonitel Office Portal. In the left sidebar, expand Settings and click Private Integrations. The screen has three tabs:
- Overview — what you can do from here, with links to the API documentation and a Postman collection.
- Credentials — create, copy and revoke the access tokens your systems use, and read your Client identifier.
- Webhooks — the addresses we post call and message events to.
The page title is Automation & Integrations Dashboard. You can also reach it from Settings → Integrations → Automation & Integrations → Manage.
What you can automate
Calls: read your call history, download recordings and transcriptions, receive an event when a call comes in, and place a call from your own app, which is what a click-to-call button in a CRM is built on.
Messaging: send SMS and MMS, receive incoming messages, look up a message you sent, and queue bulk or scheduled campaigns.
Watching calls as they happen on screen is a separate thing, and it lives in the portal rather than the API — see Active Panel-Calls.
WhatsApp: check account readiness, list business numbers and approved templates, and send messages through the API. Start with Send WhatsApp Messages with the API.
Create a credential
- Open the Credentials tab.
- Click New credential and give it a description naming the system it is for.
- Copy the token while it is on screen. It is shown once.
- Note your Client identifier from the same tab. Requests need both values.
Issue one credential per system. When a credential has to be revoked you then disable a single integration rather than every one you run.
Use a credential
Both values travel as headers on every request.
curl --request GET \
--url https://api.zonitel.com/api/v3/integrations/sms/webhooks \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'Accept: application/json'
Rotate, replace or delete a credential
To rotate one, open the Credentials tab, select the credential, click Rotate Credential and confirm with Continue. Copy the new value straight away and update your systems. The old token stops working the moment you rotate, and neither the old nor the new one can be retrieved later.
If you believe a token has been exposed, rotate it immediately rather than waiting for a maintenance window — an exposed token can act on your account until it is replaced.
To remove an integration you no longer run, select its credential on the same tab and click Delete.
Account administrators can create and manage credentials.
Webhooks
The Webhooks tab holds two addresses, one for calls and one for messages. Each has to be live and answer with HTTP 200 before it will save, and clearing the field removes it. Incoming Call Webhooks covers the call event in detail.
For receiver authentication and HTTP methods, see Advanced in Incoming Call Webhooks and SMS Webhooks.
Where to go next
Two guides pick up where this one stops, both with endpoints and working examples: Sync Your Calls with the API and Send and Receive SMS with the API.
Need help?
Call/Text/WhatsApp: (833) 966-4835
Email: info@zonitel.com