WhatsApp

Enable or disable calling on a WhatsApp number

Pushes Meta's calling configuration for the number (POST /{phone_number_id}/settings): turns the call button on or off, and whether a user calling you automatically grants a 7-day call-back permission. Meta requires the number to have a messaging limit of at least 2,000 conversations per day before calling can be enabled. Requires the telephony:manage scope.

post/v1/whatsapp/numbers/{id}/calling

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/v1/whatsapp/numbers/{id}/calling
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Request body

enabledboolean

Meta calling.status.

call_icon_visibility'DEFAULT' | 'DISABLE_ALL'
callback_permissionboolean

A user calling you grants a 7-day call-back permission automatically.

Response

Settings applied

objectstring
idstring
waba_idstring

WhatsApp Business Account id.

phone_number_idstring

Meta's id for the business number (what the webhook carries).

phone_numberstring

E.164.

app_idstring nullable
agent_idstring nullable

Agent that answers inbound WhatsApp calls.

calling_enabledboolean
calling_settingsobject

Last calling settings pushed to Meta.

status'active' | 'released'
created_atinteger

Unix ms.

updated_atinteger

Unix ms.

released_atinteger nullable

Unix ms.

Example response

{
  "object": "whatsapp.number",
  "id": "wan_...",
  "phone_number": "+14155550123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.