Allo

Vue d'ensemble

Gerez les files Power Dialer par programmation

Mis à jour le

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_id l'emporte quand user_id et email sont 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_id et le coequipier comme assignee_id.

Endpoints