Numéros de téléphone (SDA)
==========================

Les numéros de téléphone sont ceux que vos appelants composent pour joindre vos agents. Chaque numéro est assigné à exactement un agent à la fois, les appels entrants sont routés instantanément vers le flux publié de cet agent.

![Phone numbers in the dashboard](/docs/numbers-dark.gif)

Obtenir des numéros de téléphone
--------------------------------

Les numéros de téléphone sur Manivox.ai sont fournis exclusivement par **Manifone**, l'opérateur SIP intégré. Il n'y a pas de marketplace en self-service, les numéros sont provisionnés à la suite d'un processus d'autorisation légale.

### Commander un numéro pour votre compte

Obtenir un numéro se fait en deux temps : complétez d'abord l'autorisation KYC (Know Your Customer) du compte, puis faites-vous assigner un numéro.

1. **Complétez le KYC.** Ouvrez **Dashboard → Comptes → \[compte\] → Détails**. Dans la section *Documents*, téléversez les deux documents requis et renseignez les coordonnées du représentant légal : 
- **Extrait Kbis**, document officiel d'enregistrement d'entreprise (extrait Kbis ou équivalent), de moins de 3 mois
- **Justificatif d'adresse**, document d'adresse de l'entreprise correspondant à l'entité enregistrée
     
L'enregistrement des documents soumet automatiquement le compte à la revue KYC.
2. **Attendez la validation.** Un administrateur Manivox.ai examine les documents. Le statut KYC affiché sur l'onglet Détails passe de `PENDING` à `VALIDATED` une fois approuvé.
3. **Obtenez un numéro.** Une fois le compte validé : 
- Si la commande en self-service est activée pour votre organisation, un bouton **Commander un numéro** apparaît sur l'onglet **Comptes → \[compte\] → Numéros**. Cliquez dessus, choisissez un pays et une zone géographique (France uniquement pour le moment), et la plateforme assigne à votre compte le prochain numéro disponible dans cette zone. Il apparaît immédiatement dans la liste, prêt à être assigné à un agent.
- Sinon, demandez à votre interlocuteur Manivox de provisionner un numéro pour le compte.

### Déjà client Manifone ?

Si votre organisation a déjà des numéros provisionnés par Manifone (via un autre produit ou contrat Manifone), ces numéros peuvent être branchés directement sur Manivox.ai sans repasser par le processus d'autorisation. Contactez votre interlocuteur Manivox.ai pour mettre en place la connexion.

Voir vos numéros
----------------

Allez sur **Dashboard → Comptes → \[compte\] → Numéros** pour voir tous les numéros assignés à ce compte. Chaque entrée affiche :

- Le numéro de téléphone au format E.164 (ex : `+33988292988`)
- Le nom de l'agent assigné (le cas échéant)
- Le statut : `AVAILABLE`, `ASSIGNED` ou `RESERVED`
- Le pays

Il existe aussi une vue à l'échelle de l'organisation, **Dashboard → Numéros**, qui liste tous les numéros de l'ensemble de vos comptes avec des colonnes supplémentaires (dont la date d'assignation). Depuis cette vue, vous pouvez **demander la résiliation** d'un numéro. La résiliation n'est pas immédiate : elle planifie le retrait du numéro à une **date d'effet** qui respecte un **engagement minimum de 3 mois** (le mois où vous avez obtenu le numéro compte comme mois 1, et l'engagement se termine à la fin du mois 3). Jusqu'à cette date d'effet, le numéro continue de fonctionner normalement. Vous pouvez **annuler une résiliation en attente** à tout moment avant sa date d'effet pour conserver le numéro.

Statuts des numéros
-------------------

StatutDescriptionAccepte les appels ?    `AVAILABLE` Non assigné à un agent. Prêt à être assigné. Non, l'appelant reçoit un signal d'occupation   `ASSIGNED` Lié à un agent. Les appels entrants sont routés vers le flux de cet agent. Oui   `RESERVED` Réservé, pas assignable pour le moment. Non   `PORTED_OUT` Transféré vers un autre opérateur, plus utilisable sur la plateforme. Non  Assigner un numéro à un agent
-----------------------------

1. Allez sur **Dashboard → Comptes → \[compte\] → Numéros**
2. Trouvez un numéro `AVAILABLE` et cliquez sur **Assigner**
3. Sélectionnez l'agent dans le menu déroulant
4. Cliquez sur **Assigner**

Le numéro commence à router les appels vers cet agent immédiatement, aucun délai de propagation.

Un numéro ne peut être assigné qu'à un seul agent à la fois. Pour déplacer un numéro d'un agent vers un autre, détachez-le d'abord, puis réassignez-le.

Détacher un numéro
------------------

Détacher repasse le numéro au statut `AVAILABLE`. Tout appel déjà en cours sur ce numéro se termine normalement, les appels en cours ne sont jamais interrompus.

Depuis le dashboard : cliquez sur **Détacher** dans le menu d'action du numéro dans **Dashboard → Comptes → \[compte\] → Numéros**.

Plusieurs numéros par agent
---------------------------

Un seul agent peut avoir plusieurs numéros assignés simultanément. Utile pour :

- Des numéros régionaux routés vers le même agent (ex : un numéro Paris et un numéro Lyon tous deux gérés par le même agent de support)
- Des tests A/B sur la gestion des appels entrants sur différents numéros
- Du routage de repli quand le numéro principal est temporairement réassigné

Numéros pour les appels sortants
--------------------------------

Utiliser l'un de vos numéros comme caller ID pour les appels sortants arrive bientôt, en même temps que les appels sortants eux-mêmes. Voir [Appels sortants](https://www.manivox.ai/docs/calls/outbound).