API reference
API reference index
A one-page cheatsheet of the whole WhatsApp API surface — each row links to the page with the full request/response detail.
App-key API
Base https://api.telenow.ai/api/app-whatsapp · auth Authorization: Bearer vai_app_….
| Method | Path | Scope | Purpose | Docs |
|---|---|---|---|---|
| GET | /channels | whatsapp | List native channels | wa-auth |
| POST | /send | whatsapp | Send one free-form message | wa-text |
| POST | /send-template | whatsapp | Send a pre-approved template | wa-send-template |
| POST | /messages/read | whatsapp | Read receipt + typing | wa-typing |
| POST | /channels/{id}/media | whatsapp | Upload/stage media (≤ 101 MB) | wa-media |
| GET | /media/{id} | whatsapp | Download media (by message-row UUID) | wa-media |
| GET | /channels/{id}/templates | whatsapp | List approved templates | wa-send-template |
| POST | /channels/{id}/templates | whatsapp:templates | Create a template | wa-templates |
| POST | /channels/{id}/templates/media | whatsapp:templates | Stage a media-header for a template def | wa-templates |
| PATCH | /templates/{tid} | whatsapp:templates | Edit/resubmit a template (note: NOT nested under /channels) | wa-templates |
| POST | /campaigns | whatsapp:campaign | Create + start a broadcast | wa-broadcasts |
| GET | /campaigns/{id} | whatsapp:campaign | Broadcast status | wa-broadcasts |
| POST | /campaigns/{id}/pause | whatsapp:campaign | Pause a broadcast | wa-broadcasts |
| POST | /campaigns/{id}/cancel | whatsapp:campaign | Cancel a broadcast | wa-broadcasts |
| GET | /channels/{id}/threads | whatsapp | List conversations | wa-conversations |
| GET | /threads/{id}/messages | whatsapp | Message history for a thread | wa-conversations |
Webhooks (org key)
Base https://api.telenow.ai/api/v1 · org-key auth · flat JSON (no success/data envelope).
| Method | Path | Purpose | Docs |
|---|---|---|---|
| GET | /hooks | List subscriptions | wa-webhooks |
| POST | /hooks | Subscribe a target_url to an event | wa-webhooks |
| DELETE | /hooks/{id} | Unsubscribe | wa-webhooks |
| GET | /events/sample | Sample payload for an event type | wa-webhooks |
Dashboard (JWT) — not app-key
Base https://api.telenow.ai/api/orgs/{orgId}/whatsapp-cloud · Authorization: Bearer <jwt> + X-Org-Id.
| Method | Path | Purpose | Docs |
|---|---|---|---|
| GET | /channels/{id}/health | Number quality / verification / payment health | wa-errors |
Channel connect and registration run on the same dashboard-JWT surface — see the Onboarding API.
Scopes are declared in the app manifest — see App scopes. Every failure code and hard limit lives in Errors & limits.