> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Numéroteur, tentatives et conformité
> Numérotation en parallèle, logique de tentatives, fenêtres d'appel, listes DNC et gestion de la messagerie vocale
Le numéroteur s'exécute **côté serveur** : aucun onglet de navigateur n'a besoin de rester ouvert. Il tourne en continu, réconciliant les appels terminés et en déclenchant de nouveaux selon vos règles.
## Numérotation en parallèle (concurrence)
* Définissez une **concurrence** par campagne : le nombre d'appels exécutés simultanément.
* La limite effective correspond à la *plus basse* des deux valeurs : le paramètre de la campagne et le `max_parallel_calls` de votre plan.
* Les appels obsolètes (bloqués en sonnerie) sont détectés et libérés automatiquement, afin qu'aucun emplacement ne reste jamais bloqué.
## Logique de tentatives
Les leads sans réponse sont automatiquement rappelés :
* **Nombre maximal de tentatives** (`retry_max`) par lead (par exemple 3).
* **Délai entre les tentatives** (par exemple 120 minutes) : la nouvelle tentative tombe à un *moment différent de la journée*, ce qui améliore sensiblement le taux de contact.
* Un lead qui répond n'est plus rappelé ; les résultats `busy`, `no answer` et `failed` déclenchent la tentative suivante jusqu'à épuisement du budget.
* L'historique complet des tentatives est visible pour chaque lead.
`retry_max` est le plafond absolu pour **toutes** les stratégies de nouvelle tentative ci-dessous. Les options de messagerie vocale et d'objectif ne créent pas de boucles infinies : une fois les tentatives supplémentaires épuisées, le lead est finalisé avec un statut terminal (`failed` / `no_answer`).
### Rappeler jusqu'à ce qu'un humain réponde
Activez **`retry_on_voicemail`** (désactivé par défaut) pour *continuer à appeler jusqu'à ce qu'un humain réponde (en ignorant les messageries vocales)*. Une fois activé, un appel dont le [résultat AMD](#amd--voicemail) correspond à une catégorie machine (`machine-vm`, `machine-ivr`, `machine-unavailable`) ne compte **pas** comme joint : le lead est reprogrammé pour une nouvelle tentative au lieu d'être marqué comme terminé, dans la limite de `retry_max`. Seul un résultat `human` (ou un budget de tentatives épuisé) finalise le lead.
Il s'agit d'une *politique* de nouvelle tentative. Ce que l'assistant fait réellement en tombant sur une machine — raccrocher en silence ou laisser un message — se configure au niveau de l'**assistant** (Paramètres → Conversation → Messagerie vocale), pas de la campagne.
### Rappeler jusqu'à ce que l'objectif soit atteint
Deux paramètres se combinent pour continuer à appeler un lead jusqu'à ce qu'un résultat défini soit atteint :
* **`retry_until_goal`** (booléen, désactivé par défaut) — *Continuer à appeler jusqu'à ce que l'objectif soit atteint.* Un lead n'est marqué `completed` que lorsque sa variable d'objectif évalue à `true` à l'issue de l'appel ; sinon, le numéroteur programme une nouvelle tentative (dans la limite de `retry_max`).
* **`goal_variable`** (texte) — *Variable devant être vraie pour marquer un lead comme terminé.* Le nom d'un champ booléen d'évaluation post-appel. Les options proviennent des champs d'analyse post-appel de l'assistant de la campagne (les champs `boolean` de sa configuration d'analyse), ainsi que de l'indicateur intégré **`success`**. Le numéroteur lit la valeur dans les données d'analyse de l'appel terminé (ou dans l'indicateur `success` de l'appel lorsque la variable est `success`).
Si `retry_until_goal` est activé mais que la variable d'objectif ne devient jamais `true`, le lead est rappelé jusqu'à ce que `retry_max` soit atteint, puis finalisé avec un statut terminal — la stratégie d'objectif ne prime jamais sur le plafond de tentatives.
## Fenêtres d'appel
Définissez **quand la campagne est autorisée à appeler**, jour par jour, dans le **fuseau horaire** de la campagne — par exemple du lundi au vendredi de 9h30 à 18h00. En dehors de cette fenêtre, le numéroteur se met en pause et reprend automatiquement.
En Allemagne, les appels non sollicités en dehors d'heures raisonnables enfreignent l'UWG. Les fenêtres d'appel ne sont pas qu'une fonctionnalité de courtoisie : configurez-les pour chaque campagne qui appelle des particuliers.
## Ne pas appeler (DNC)
Une **liste DNC centrale par espace de travail** bloque définitivement des numéros pour l'ensemble des campagnes :
* Les numéros de la liste ne sont **jamais composés**, même s'ils figurent dans un import de leads (ils sont filtrés au moment de l'envoi et signalés comme bloqués).
* Ajoutez des entrées manuellement, via import, ou laissez l'**assistant ajouter des appelants pendant une conversation** (« ne me rappelez plus jamais » → l'agent place le numéro sur la liste DNC).
* Chaque entrée enregistre sa source et son motif, à des fins de traçabilité.
Gérez la liste sous **Paramètres → Suppression**, ou par programmation :
* `GET /v1/suppression-list` — liste les entrées (`?search=` filtre par téléphone ou par motif)
* `POST /v1/suppression-list` — ajoute un numéro (`{ "phone": "+4930123456", "reason": "..." }`)
* `DELETE /v1/suppression-list/{id}` — supprime par ID d'entrée ou par numéro E.164 encodé pour URL
Ces mêmes opérations sont disponibles en tant qu'outils MCP : `list_suppression_entries`, `add_suppression_entry`, `remove_suppression_entry`.
## AMD et messagerie vocale
La **détection de répondeur (AMD)** classe la personne ou le système qui décroche dans l'une des cinq catégories suivantes :
| Résultat AMD | Signification |
| --------------------- | -------------------------------------------------------------------------- |
| `human` | Une personne a répondu — la conversation se poursuit normalement |
| `uncertain` | Impossible à classifier — traité comme un humain, la conversation continue |
| `machine-vm` | Messagerie vocale / répondeur |
| `machine-ivr` | Un serveur vocal interactif (SVI) / menu téléphonique |
| `machine-unavailable` | Numéro indisponible / message opérateur |
Ce que l'assistant *fait* face à une machine — raccrocher en silence ou laisser un message après le bip — se configure au niveau de l'**assistant** (Paramètres → Conversation → Messagerie vocale), pas de la campagne.
Le résultat AMD est enregistré sur l'appel et alimente le statut du lead, ce qui permet à la logique de nouvelle tentative de distinguer une « boîte vocale » d'un « jamais décroché ». Activez [`retry_on_voicemail`](#retry-until-a-human-answers) pour continuer à appeler jusqu'à ce qu'un humain (plutôt qu'une catégorie `machine-*`) réponde.
Message vocal + nouvelle tentative à une autre heure : c'est la combinaison la plus rentable pour la prospection à froid. Le message laissé en boîte vocale prépare le lead, et la nouvelle tentative le capte en direct. Associez le message vocal de l'assistant à l'option `retry_on_voicemail` de la campagne.