Deplace une file vers un autre membre de votre equipe. La file conserve ses numeros et son creator id ; seul assignee id change. Le nouvel assigne voit la…
PATCH/v2/api/dialing-queues/{queue_id}/assignee
Deplace une file vers un autre membre de votre equipe. La file conserve ses numeros et son creator_id ; seul assignee_id change. Le nouvel assigne voit la file dans son Power Dialer immediatement.
Qui peut reassigner
La cle API doit appartenir a un admin ou un manager de l'equipe. Une cle de membre recoit 403 DIALING_QUEUE_ASSIGN_FORBIDDEN.
Le proprietaire de la cle API doit etre le createur ou l'assigne actuel de la file. Sinon la reponse est 404 DIALING_QUEUE_NOT_FOUND.
Choisir le nouvel assigne
Envoyez user_id ou email dans le corps JSON. L'un des deux est obligatoire (400 DIALING_QUEUE_ASSIGNEE_REQUIRED).
user_id — l'emporte quand les deux sont fournis. Resolvez les ids des coequipiers via GET /v2/api/users.
email — utilise uniquement quand user_id est absent.
Si l'utilisateur resolu n'est pas dans votre equipe, la reponse est 404 ASSIGNEE_NOT_FOUND.
Sessions d'appel ouvertes
Une file avec une session d'appel ouverte ne peut pas etre reassignee (409 DIALING_QUEUE_SESSION_ACTIVE). Terminez la session dans l'app Allo, puis reessayez.
Autorisation
Authorizationstring · headerrequis
Api-Key ak_live_…
Paramètres de chemin
queue_idstringrequis
Id of the dialing queue.
Corps
user_idstring
Id of the new assignee. Resolve teammate ids via GET /v2/api/users.
emailstring<email>
Email of the new assignee. Used only when user_id is absent.
Réponses
200Reassigned queue
dataobject
A user's Power Dialer queue with its configuration and numbers.
9 champs
idstring
Unique queue identifier (KSUID with pdl prefix)
namestring | null
Display name of the queue
creator_idstring
User ID of the queue creator — the user (or API key owner) that created the queue.
assignee_idstring | null
User ID of the user expected to run the queue. GET /current returns the queue where this matches the authenticated user (or the user resolved from user_id / email). Defaults to the creator when none was specified at creation time.
voicemail_handlingenum<string>
How the Power Dialer reacts when the call lands in voicemail. SKIP advances to the next number; NO_SKIP keeps the user on the call.
SKIPNO_SKIP
do_not_disturbenum<string>
When ENABLED, incoming calls are silenced while the queue is being run.
ENABLEDDISABLED
numbersobject[]
12 champs
number_tostring
E.164 destination phone number
positioninteger
Order within the queue (0-based)
created_atstring<date-time>
updated_atstring<date-time>
call_start_datestring<date-time> | null
When the user started calling this entry. null if the entry is still unassigned.
call_idstring | null
ID of the call placed for this entry (cll-*). null until a call is placed.
routing_resultenum<string>
Final routing outcome of the call placed for this entry.
Status of this entry, derived from the call placed for it. QUEUED: no call yet, or the call is still in progress. SKIPPED: skipped in the Power Dialer with no call placed (if a call is placed for it later, the status follows that call). VOICEMAIL: the call reached a voicemail box. CONNECTED: the call was answered at route level (routing_result is ANSWERED), no voicemail was detected and no not_reached_destination_reason is set; this can over-report a real conversation. TRANSFERRED: the call was transferred. BUSY: the destination was busy. WRONG_NUMBER: the destination is not in service. NO_ANSWER: the call ended without an answer, including the other not_reached_destination_reason values and any other final route status (failed, blocked, closed, handled by call flow).