AI agent & calling

AI agent, auto-reply & calling

Bind one of your voice AI agents to a WhatsApp number and it can reply to messages automatically and answer WhatsApp voice calls. Both are native-channel features and both are configured per channel. This page covers turning them on, the requirements, and the APIs.

AI auto-reply

When a customer messages your number, the bound agent generates and sends a reply — no human needed. You can pause the AI on any single conversation for a human to take over, then resume.

Turn it on

In the dashboard: open Communicate → WhatsApp, pick the channel, and in the agent bar choose an answering agent, then toggle AI on. Owners and admins only.

Over the API (dashboard JWT):

curl -X PUT https://api.telenow.ai/api/orgs/{orgId}/whatsapp-hub/channels/{channelId}/agent \
  -H "Authorization: Bearer <jwt>" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{ "agent_id": "a1b2c3d4-…", "ai_enabled": true }'

{ "success": true }

Requirement: auto-reply runs only when the platform flag FEATURE_WHATSAPP_AGENT is on and the channel has an agent bound with ai_enabled: true. Voice-note transcription for the agent isn't built yet, so a customer's voice note doesn't trigger a reply.

Pause AI on one conversation

Hand a single thread to a human (and resume later) without unbinding the agent:

curl -X PUT https://api.telenow.ai/api/orgs/{orgId}/whatsapp-hub/threads/{threadId}/pause \
  -H "Authorization: Bearer <jwt>" -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

Any org member can pause/resume. In the dashboard this is the Pause AI / Resume AI control on the thread.

How it works

An inbound message (fresh, within 24 hours) that is real user text runs the bound agent on that conversation and sends its reply back — the reply shows in the shared inbox tagged AI, and it fires the normal whatsapp.message.status events. While the agent composes, a typing indicator is shown to the customer.

WhatsApp Calling

WhatsApp lets customers place a voice call to your business number. With calling enabled, your voice AI agent answers the call — the same agent stack you use for phone calls, bridged to WhatsApp over WebRTC. Calls are logged, and a call that can't be answered is cleanly rejected rather than left ringing into dead air.

Requirements (mandatory)

Calling needs more than the messaging setup. All of these must be in place:

The last four are platform/operator settings (see the go-live runbook). On a hosted Telenow plan they're already provisioned — you only bind an agent and toggle calling on. If calling isn't available in your workspace, contact your administrator.

The two marked yours are the ones you can act on, and they're both visible before you try: the account-health endpoint or banner shows your messaging limit and any payment-method warning.

Turn it on

In the dashboard: on the channel, open the Calling bar, pick an answering agent, and toggle calling on. This also flips the calling setting at Meta for your number. Owners and admins only.

Over the API (dashboard JWT):

curl -X PUT https://api.telenow.ai/api/orgs/{orgId}/whatsapp-hub/channels/{channelId}/calling-agent \
  -H "Authorization: Bearer <jwt>" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{ "agent_id": "a1b2c3d4-…", "calling_enabled": true }'

{ "success": true,
  "data": { "callingEnabled": true, "agentId": "a1b2c3d4-…", "metaSynced": true, "warnings": [] } }

metaSynced says whether Meta's own switch is known to match what was stored: true applied, false we tried and Meta refused (your channel setting still governs whether an agent answers), null Meta never reported its state. warnings carries anything real but non-blocking — a payment-method problem, a display name still in review.

To turn calling off, send { "calling_enabled": false }. Disabling always succeeds — it is recorded on your channel first and Meta is told afterwards, so an account problem can never trap you with calling stuck on.

Enabling is the direction Meta can refuse. When it does you get an actionable 400 naming the blocker, with the full list under blockers so fixing the first one doesn't just reveal the second:

{ "success": false,
  "error": "Your messaging limit is too low for WhatsApp calling. WhatsApp only allows calling once your business can start at least 2000 conversations a day; yours is at 1000. …",
  "code": "wa_calling_messaging_limit",
  "blockers": [ { "code": "wa_calling_messaging_limit", "level": "error", "title": "…", "detail": "…", "action": "Open Meta Business Manager" } ] }

The codes are listed under Calling errors. A 502 from this endpoint means something on Meta's side failed rather than your account being ineligible — retry it.

Re-saving a channel whose calling state is unchanged is a no-op at Meta: only the agent binding is written, so merely re-saving a page can't fail on an account problem you didn't introduce.

How a call flows

1. A customer places a WhatsApp call to your number → Meta sends Telenow a connect event.
2. If calling is enabled and an agent is bound and the media plane is on, Telenow answers: it negotiates WebRTC, stands up the agent's session, and accepts the call at Meta. The agent talks to the caller.
3. Otherwise the call is rejected at Meta immediately — the caller isn't left ringing.
4. When either side hangs up, the call is logged with its duration.

Call log

List a channel's calls (most recent first):

curl "https://api.telenow.ai/api/orgs/{orgId}/whatsapp-hub/channels/{channelId}/calls" \
  -H "Authorization: Bearer <jwt>" -H "X-Org-Id: {orgId}"

{ "success": true, "data": { "calls": [
  { "call_id": "wacid.…", "direction": "inbound", "from_number": "+919876543210",
    "status": "completed", "duration_secs": 92, "agent_id": "a1b2c3d4-…",
    "start_time": "2026-01-01T12:00:00Z", "end_time": "2026-01-01T12:01:32Z" }
] } }

status is one of ringing, accepted, rejected, completed, failed, or missed. The endpoint returns up to the 100 most recent calls (newest first) with no pagination, filtering, or offset — for full history, consume the calls webhook/events instead. duration_secs is in seconds, and direction reflects the value WhatsApp reports for the call (e.g. inbound).

Related

• Connecting WhatsApp — set up the number first.
• Webhooks & events — receive messages and delivery statuses in your own system.
• Reading conversations — thread and message history for a human agent.
• Authentication & channels — the dashboard-JWT surface these routes use (X-Org-Id, orgId).
• Authentication — how JWTs and org ids work.