L'API Power Dialer vous permet de gerer la file d'appels d'un utilisateur — ajouter des numeros, configurer la file, la vider ou la reinitialiser, et lire son etat.
Chaque utilisateur a au plus une file Power Dialer active a la fois. La file est creee implicitement la premiere fois que vous ajoutez des numeros ou appelez reset.
Une file contient jusqu'a 25 000 numeros. Un ajout qui depasserait cette limite echoue avec 400 DIALING_QUEUE_LIMIT_REACHED.
Scope requis
Tous les endpoints necessitent le scope DIALING_QUEUE_READ_WRITE sur votre cle API.
Assigner une file a un coequipier
Chaque endpoint accepte user_id ou email pour agir sur la file d'un coequipier au lieu de celle du proprietaire de la cle API. L'emplacement de l'envoi depend de l'endpoint (query string ou corps JSON) — consultez la section "Cibler la file d'un coequipier" de chaque endpoint pour les details.
Regles communes a tous les endpoints :
user_idl'emporte quanduser_idetemailsont fournis ensemble.- Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.
- Si l'utilisateur resolu n'existe pas ou n'est pas un coequipier, l'API renvoie
404 ASSIGNEE_NOT_FOUND. La meme erreur couvre les deux cas volontairement, afin que les consommateurs de l'API ne puissent pas enumerer les utilisateurs. - Quand vous ajoutez a un coequipier qui n'a pas de file en cours, une nouvelle file est creee avec le proprietaire de la cle API comme
creator_idet le coequipier commeassignee_id.
Endpoints
Recuperer la file assignee a un utilisateur (vous-meme ou un coequipier)
Modifier le nom de la file, la gestion des messageries vocales ou le mode "ne pas deranger"
Ajouter des numeros de telephone (et metadonnees de contact optionnelles) a une file
Retirer des numeros precis, une position, ou toutes les entrees non assignees
Abandonner la file courante et en demarrer une nouvelle
Deplacer une file et ses numeros vers un autre membre de l'equipe