Call a Customer

Places a call from a team member to a customer, on WhatsApp or on a phone line.

• WHATSAPP · VOIP: the reply carries credentials. Your app joins with them within 30 seconds, then the customer's WhatsApp rings.
• PSTN · DIRECT: no credentials. The team member's own phone rings first; when they pick up, the customer is dialled and the two are connected.

🚧

Not available yet

PSTN · VOIP and WHATSAPP · DIRECT are not available yet: 400 MODE_NOT_SUPPORTED.

Endpoint

POST https://public.doubletick.io/v1/call/person

Authentication

Include your API key in the Authorization header.

📘

NOTE

If you do not have your DoubleTick API Key, you can obtain it by following this guide link.

Request Body

Example Request

A WhatsApp call:

curl -X POST https://public.doubletick.io/v1/call/person \
  -H 'Authorization: <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"channel": "WHATSAPP", "mode": "VOIP", "from": "<your WhatsApp number>", "to": "<customer number>", "agentNumber": "<team member number>"}'

A phone-line call:

curl -X POST https://public.doubletick.io/v1/call/person \
  -H 'Authorization: <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"channel": "PSTN", "mode": "DIRECT", "from": "<your phone-line number>", "to": "<customer number>", "agentNumber": "<team member number>"}'

Example Response

{
  "success": true,
  "message": "Call initiated",
  "data": { ...the call... },
  "credentials": { ...WhatsApp VOIP only... }
}

data is the call. Keep its callId for the other routes.

Error Responses

Rate Limit

60 a minute per organization. A PSTN call also counts in /v1/call/agent's limit of 10 a minute.