Call Setup

Calling licenses, PSTN number mapping and permissions to set up before placing calls.

Set these up once before your team or your AI agents place calls through the API.

Calling License

A team member needs a calling license to make and receive calls. Your organization must have the Calling License add-on.

TaskEndpoint
Give a team member a licensePOST /v1/call/license/invoke
Free a license for someone elsePOST /v1/call/license/revoke
  • The team member is identified by phone, which must exactly match the phone stored on their profile.
  • Assigning to a member who already holds a license succeeds without using another license.

PSTN Number Mapping

Each PSTN number is linked to a WhatsApp number, and has someone who answers its incoming calls: a team member or an AI agent.

  • Calls on the PSTN number are logged in the customer's chat on the linked WhatsApp number.
  • Set this for up to 500 numbers at a time with Update PSTN Number Mappings. It does the same as editing a PSTN channel in the app (Channels → PSTN number → Edit channel details).

Permissions

  • PSTN calls: the team member needs calling permission on the PSTN number used to place the call.
  • WhatsApp calls: the team member needs permission to call from the from number, and the customer must have allowed calls.

What’s Next

Map your PSTN numbers, then place a call.

Did this page help you?