Skip to main content
Set POKU_TRANSFER_NUMBER in your installation config to enable call transfers. The number must be in E.164 format (e.g. +12223334444) — see Supported Countries for eligible destinations.

​
How it works

During an outbound call, the voice agent will transfer to your transfer number only if the person on the line explicitly asks to speak with a human. This gives the other party a way to reach you directly if needed — for example, if they have a question the agent can’t answer or want to confirm details personally. The transfer is not triggered automatically. If the caller does not request it, the agent completes the call as normal. If the transfer number is not set, no transfer option is available on the call.

​
API reference

curl -s -X POST \
  -H "Authorization: Bearer $POKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "<drafted message>",
    "to": "<normalized number>",
    "transferNumber": "$POKU_TRANSFER_NUMBER"
  }' \
  https://api.pokulabs.com/phone/call
ParameterTypeRequiredDescription
messagestringYesStructured prompt that drives the voice AI agent.
tostringYesDestination phone number in E.164 format.
transferNumberstringNoNumber to transfer the call to if the agent cannot proceed. Must be E.164 format.