Skip to main content
PATCH
Scope requis : DIALING_QUEUE_READ_WRITE
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.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

queue_id
string
requis

Id of the dialing queue.

Exemple:

"pdl-174AB37D545367EB5CE26784EE7A376202B2BFAE"

Corps

application/json

The team member the queue should be assigned to. Provide user_id or email; user_id wins when both are provided.

user_id
string

Id of the new assignee. Resolve teammate ids via GET /v2/api/users.

Exemple:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

email
string<email>

Email of the new assignee. Used only when user_id is absent.

Réponse

Reassigned queue

data
object

A user's Power Dialer queue with its configuration and numbers.