Voice

Claim a ringing inbound call for one rep

FIRST WINS. A second claim on the same call loses, and says so.

This CONNECTS A HUMAN TO A LIVE CALLER. It is the race-resolution step the notification socket exists to drive; calling it from an automation means deciding who answers before a person has seen the call.

post/voice/inbound-calls/{room_name}/claim

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/inbound-calls/{room_name}/claim
  • Auth: HTTP bearer

Path parameters

room_namestring required

The ringing call's room name.

Query parameters

sdr_emailstring required

The rep taking it.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.