> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

> Gerez les files Power Dialer par programmation

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`.

## 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

<CardGroup cols={2}>
  <Card title="Lire la file courante" href="/fr/v2/api-reference/dialing-queues/get-current">
    Recuperer la file assignee a un utilisateur (vous-meme ou un coequipier)
  </Card>

  <Card title="Mettre a jour la config" href="/fr/v2/api-reference/dialing-queues/update-current">
    Modifier le nom de la file, la gestion des messageries vocales ou le mode "ne pas deranger"
  </Card>

  <Card title="Ajouter des numeros" href="/fr/v2/api-reference/dialing-queues/append-numbers">
    Ajouter des numeros de telephone (et metadonnees de contact optionnelles) a une file
  </Card>

  <Card title="Vider des numeros" href="/fr/v2/api-reference/dialing-queues/clear-numbers">
    Retirer des numeros precis, une position, ou toutes les entrees non assignees
  </Card>

  <Card title="Reinitialiser la file" href="/fr/v2/api-reference/dialing-queues/reset-current">
    Abandonner la file courante et en demarrer une nouvelle
  </Card>
</CardGroup>