Numéros virtuels pour entreprise : recherche, commande et gestion par API
Trouvez un numéro par pays, type et capacités, voyez les justificatifs demandés avant de commander, puis rattachez-le à un projet. Tarification sur devis.
Sur devis
Un numéro virtuel est un numéro de téléphone qui n’est pas lié à une ligne physique. Il reçoit des appels, des SMS ou les deux, et les transmet vers votre application, vers un poste SIP ou vers un scénario d’appel.
Chez TELQIO, la recherche affiche pour chaque numéro son pays, son type et ses capacités voix et SMS, ainsi que les documents éventuellement exigés. Vous voyez ces conditions avant de commander, pas après.
Chaque numéro commandé est rattaché à un projet. Les journaux d’appels, les SMS et les consommations restent ainsi lisibles par projet, par numéro ou par pays.
Comment ça circule
Usages concrets
Un numéro par site ou par agence
Attribuez un numéro local à chaque implantation et suivez son activité séparément.
Un numéro par campagne
Réservez des numéros dédiés pour mesurer ce qui génère des appels, avec le call tracking.
Numéros de service pour votre application
Donnez à chaque environnement ou client de votre SaaS son numéro entrant, relié à vos webhooks.
Reprise de numéros existants
Préparez une demande de portabilité avec la liste des pièces à fournir pour le pays concerné.
Fonctionnalités
- Recherche par pays, type de numéro, préfixe et capacités voix ou SMS
- Affichage de l’état du stock, des justificatifs requis et du délai confirmé
- Commande avec validation des documents avant activation
- Rattachement de chaque numéro à un projet
- Événement number.activated envoyé à votre webhook signé
- Consommations lisibles par numéro, par projet et par pays
Limites à connaître
- La disponibilité d’un type de numéro dépend du pays, du fournisseur retenu et du contrat.
- Un numéro n’est proposé que si le pays et la capacité sont approuvés, que le stock est présent et que les obligations du pays sont remplies.
- Certains pays exigent des justificatifs d’identité ou d’adresse. Le délai d’activation dépend alors de leur validation.
- Un numéro capable d’appeler n’est pas forcément capable de recevoir des SMS. Les capacités se vérifient une par une.
- Une réservation peut expirer, et un stock peut changer entre la recherche et la commande : la commande vous l’indique explicitement.
# Recherche
curl "https://api.example.test/v1/numbers/search?country=FR&type=local" \
-H "Authorization: Bearer tq_test_EXEMPLE"
# => { "data": [{ "e164": "+33199001234", "country": "FR", "type": "local",
# "capabilities": ["voice","sms"], "documents_required": [] }] }
# Commande
curl -X POST "https://api.example.test/v1/number-orders" \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 7b1d2c4e-0000-4000-8000-000000000001" \
-H "Content-Type: application/json" \
-d '{ "e164": "+33199001234", "project_id": "projet_a" }'
# => { "id": "ord_exemple", "status": "pending_validation", "simulated": true }Éléments techniques
| Format des numéros | E.164, sans espace |
|---|---|
| Lecture | GET /numbers et GET /numbers/search, pagination par curseur |
| Commande | POST /number-orders, avec en-tête Idempotency-Key |
| Statut initial | pending_validation, jusqu’à validation des documents |
| Notification | Événement number.activated, webhook signé |
Questions fréquentes
Puis-je commander un numéro dans n’importe quel pays ?
Non. La liste des pays est un référentiel, pas une couverture active. Un numéro n’est proposé que si le pays et la capacité demandée ont été validés avec le fournisseur retenu.
Que se passe-t-il si le stock change pendant ma commande ?
La réservation peut expirer ou le stock disparaître. La console et l’API le signalent clairement, et vous relancez une recherche sans perdre le reste de votre demande.
Comment connaître le coût d’un numéro ?
Les conditions sont établies sur devis, en fonction du pays, du type de numéro et du volume prévu. Elles vous sont présentées avant la commande.
Usages associés
Documentation
Services associés
Dites-nous quels numéros il vous faut
Indiquez les pays, les types de numéros et les capacités voulus. Nous préparons un devis avec les conditions et les justificatifs attendus.