Get calling config for a number
The WhatsApp Business Calling configuration of this number, keyed the
same way as the POST/PATCH/DELETE below (full read-write on one
sub-resource). Encrypted secrets are never returned; only a boolean
saying whether a SIP password is stored. The account-scoped read
(GET /v1/whatsapp/calling?accountId=) remains for callers that only
know the social account id, and additionally carries account-level
extras (billing eligibility, current-period spend).
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Phone number record ID (from GET /v1/phone-numbers).
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.whatsappcalling.getWhatsAppCalling({ path: { id: 'abc123', },});console.log(data);{
"phoneNumber": "string",
"callingEnabled": true,
"callDeepLink": "string",
"forwardTo": "string",
"recordingEnabled": true,
"sipAuthUsername": "string",
"sipAuthPasswordConfigured": true,
"callIconCountries": [
"st"
],
"outboundDisabled": true
}{
"error": "Unauthorized"
}Get a call recording GET
Resolves a fresh, playable MP3 URL for the call's recording. Provider-signed recording URLs expire ~10 minutes after signing, so the `recordingUrl` stored on the call is usually stale by the time it is played; this endpoint re-signs on demand. Default responds `302 Found` redirecting to the fresh URL (point an `<audio>` element or a link straight at this endpoint); pass `as=json` to receive `{ url }` instead.
Set business username POST
Claim or transfer a WhatsApp Business username for the account. Username rules: 3-35 characters, letters/digits/period/underscore only, must contain at least one letter, no leading or trailing periods, no consecutive periods, no `www` prefix, no domain TLD suffix (e.g. `.com`). If the desired username is currently held by another account, pass `transferAction: "force_transfer"` to request a transfer. On failure the API returns a standard error envelope with one of these codes: `whatsapp_username_unavailable` (already taken and transfer not requested), `whatsapp_username_ineligible` (account not eligible to claim a username), or `whatsapp_username_transfer_required` (username is held elsewhere; retry with `force_transfer`).