Save opt-in callback routing; engine resolver activation is a separate operation

Save an explicit allowlist of owned active engine agents for returning callers with a unique real outbound call from this number within lookbackSecs (60-604800 seconds). Unknown, ambiguous or unverified callers keep the default agent. Empty agentIds disables the policy. Optional firstMessage applies only to verified callbacks. Optional missedFirstMessage (up to 500 characters) replaces firstMessage for a caller whose preceding outbound call had no conversation (not answered, voicemail, voice menu, nobody spoke) - that caller has not heard the offer yet; without it firstMessage applies to everyone. The engine also receives volai_callback_kind (missed or contacted) on a verified callback. engineSyncRequired: true means the default agent engine configuration must separately activate webhooks.inbound_route_url with readback; this request does not rewrite live engine configuration. Verified incoming calls expose callbackOf.callId and optional server-owned taskId and taskItemId in call details.

put/v1/numbers/{e164}/callback-routing

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/numbers/{e164}/callback-routing
  • Auth: HTTP bearer

Path parameters

e164string required

E.164 phone number. Send the plus sign as %2B or literally; 00420... is accepted as well.

Request body

agentIdsstring[] required

Owned active engine agents eligible for verified callbacks; an empty list disables callback routing.

lookbackSecsinteger required

Maximum age of a real outbound call in seconds, from 60 to 604800.

firstMessagestring

Optional greeting spoken only for a verified campaign callback, up to 500 characters.

missedFirstMessagestring

Optional greeting for a verified callback whose preceding outbound call had no conversation with the customer (not answered, voicemail, voice menu or nobody spoke), up to 500 characters. Without it firstMessage applies to every verified callback.

Response

Callback routing saved

engineSyncRequiredtrue required

Changes

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