FRENES
Se connecterDemander un devis
Demander un devis

Gestion des numéros

Un numéro suit un cycle : recherche, réservation, commande, activation, affectation, résiliation. À chaque étape, une condition peut bloquer. Cette page les décrit.

Mis à jour le

Quand un numéro est-il disponible ?

Un numéro est disponible lorsque quatre conditions sont réunies à la fois.

  • Le pays et la capacité sont approuvés (voix, SMS, ou les deux).
  • Le stock est présent chez le fournisseur.
  • Votre compte est autorisé à commander ce type de numéro.
  • Les obligations du pays sont satisfaites, notamment les pièces justificatives.
Si l’une manque, le numéro n’est pas proposé ou la commande reste en attente de validation.

Types de numéros

Les types proposés dépendent du pays et du fournisseur. Les plus courants sont les suivants.

TypeUsage courant
LocalPrésence géographique, accueil d’un site.
NationalNuméro unique pour un pays.
MobileUsages SMS ou appels vers des mobiles, selon pays.
Numéro spécialNuméros de service, selon pays et fournisseur.

Pièces justificatives

Certains pays demandent une preuve d’identité, un justificatif d’adresse locale ou une description de l’usage. Les exigences sont visibles avant la commande, avec la recherche de numéros. Une commande dont les pièces sont incomplètes reste en attente de validation.

Réservation, expiration et conflit de stock

  1. Vous recherchez puis réservez un numéro. La réservation est temporaire.
  2. Si vous ne confirmez pas à temps, la réservation expire et le numéro retourne au stock.
  3. Si un autre client obtient ce numéro avant vous, la commande échoue pour conflit de stock. Relancez une recherche.
  4. Une commande confirmée passe en attente de validation, puis le numéro est activé et l’événement number.activated est émis.
Exemple fictif de commande d’un numéro. Il s’agit d’une simulation tant qu’aucun fournisseur n’est configuré.
curl -X POST https://api.example.test/v1/number-orders \
  -H "Authorization: Bearer tq_test_EXEMPLE" \
  -H "Idempotency-Key: 5b0e6f0e-2f55-4c1e-9a43-0d6a2f1c7a10" \
  -H "Content-Type: application/json" \
  -d '{"e164":"+33199001234","project_id":"prj_A"}'

Affectation à un projet

Un numéro appartient à un projet. Ses appels, ses messages et sa consommation sont rattachés à ce projet. Affecter un numéro à un autre projet est une opération tracée dans le journal d’audit.

Résiliation

Résilier un numéro demande une confirmation qui indique la cible précise. Selon le pays, un numéro résilié peut ne pas pouvoir être récupéré ensuite. Si vous voulez le conserver ailleurs, étudiez plutôt une portabilité.

Gérer ses numéros pas à pasNuméros virtuels