Skip to main content
L’importation depuis un opérateur connecte votre propre compte opérateur, détecte ses numéros de téléphone existants et crée automatiquement la configuration SIP entrante et sortante correspondante. L’opérateur continue de facturer la location du numéro et la terminaison des appels.

​
Opérateurs pris en charge

Les secrets sont chiffrés au repos et ne sont jamais renvoyés par le tableau de bord, l’API publique ou MCP.

​
Importer un numéro

Sélecteur d’import opérateur avec Twilio, Telnyx, Zadarma et Vonage sur une seule ligne

Settings → Phone numbers → Add a number → Import from your carrier : sélectionnez votre opérateur, puis Continue pour accéder aux détails de connexion.

  1. Ouvrez Settings → Phone numbers → Add a number → Import from your carrier.
  2. Sélectionnez l’opérateur, saisissez les identifiants et choisissez la région SIP.
  3. Sélectionnez les numéros compatibles voix qui ne sont pas déjà routés ailleurs.
  4. Importez les numéros et associez un assistant.
  5. Testez un appel entrant et un appel sortant avant d’utiliser le numéro dans une campagne.
La plateforme relit chaque numéro sélectionné directement chez l’opérateur avant de l’importer. Un numéro fourni côté client ne peut donc jamais être associé à une ressource opérateur différente. Pour Telnyx, chaque importation autorise aussi, dans l’Outbound Voice Profile de la connexion, les appels sortants vers les pays de ses numéros (par défaut, Telnyx n’autorise que les États-Unis et le Canada). Les plages premium et à haut risque ne sont jamais activées automatiquement. Ajoutez les autres pays de destination dans Telnyx. L’adresse SIP, les identifiants et le format de l’identifiant d’appelant d’un numéro importé sont gérés par sa connexion et ne peuvent pas être modifiés sur le numéro.

​
Protection du routage Vonage

Les numéros Vonage disposant déjà d’une app, d’un téléphone ou d’un callback SIP sans rapport sont marqués comme indisponibles. L’importation depuis un opérateur n’écrase jamais ce routage. Lorsqu’un numéro Vonage est retiré, son callback n’est effacé que s’il pointe encore exactement vers le point de terminaison SIP régional configuré par cette connexion. Un callback modifié ultérieurement dans Vonage est conservé.
Ne supprimez et ne remplacez jamais le trunk, la connexion ou le callback côté opérateur tant qu’un numéro est actif. Utilisez Troubleshoot pour détecter et corriger en toute sécurité les écarts pris en charge.

​
Régions SIP et dépannage

La région sélectionnée détermine le point de terminaison SIP utilisé pour la signalisation entrante. La modifier lance un diagnostic fournisseur et répare le routage des numéros importés. Troubleshoot vérifie :
  • les identifiants opérateur et le solde du compte ;
  • le trunk/la connexion du fournisseur ou le routage direct du numéro ;
  • pour Telnyx, que la connexion accepte toujours les identifiants SIP de la plateforme et autorise les appels vers les pays de vos numéros ;
  • que chaque numéro importé envoie ses identifiants SIP et un identifiant d’appelant international lors des appels sortants ;
  • la connectivité entrante et sortante ;
  • les associations numéro/assistant.
Les réparations se limitent aux ressources appartenant à la connexion sélectionnée. Les erreurs fournisseur restent visibles sur la connexion.

​
API publique et MCP

L’API publique expose :
  • GET/POST /api/v1/carrier-connections
  • GET/PATCH/DELETE /api/v1/carrier-connections/{id}
  • GET /api/v1/carrier-connections/{id}/available-numbers
  • POST /api/v1/carrier-connections/{id}/import
  • DELETE /api/v1/carrier-connections/{id}/numbers/{numberId}
  • POST /api/v1/carrier-connections/{id}/troubleshoot
Utilisez la portée sip_trunks:read ou sip_trunks:write. Les outils MCP équivalents sont list_carrier_connections, create_carrier_connection, get_carrier_connection, update_carrier_connection, list_carrier_available_numbers, import_carrier_numbers, remove_carrier_number, delete_carrier_connection et troubleshoot_carrier_connection.
L’importation depuis un opérateur est l’option la plus rapide pour Twilio, Telnyx et Vonage. Pour un autre fournisseur SIP, utilisez Trunk SIP externe (BYO).

​
Import Zadarma

Trouver les clés API ou configurer Zadarma manuellement, avec SIP direct et renvoi PBX.
Logos Famulor et Zadarma avec un numéro de téléphone relié à un assistant vocal
Connectez le compte avec la clé et le secret de Paramètres → Intégrations et API → Clés et API dans Zadarma. Activez un numéro virtuel, désactivez son mode test et affectez-le à un identifiant SIP direct avant l’import. Un numéro dirigé vers un serveur externe ou un PBX doit d’abord passer au SIP direct. Chaque connexion importe un numéro et crée un identifiant SIP dédié utilisant ce numéro comme identifiant d’appelant. Gardez un emplacement SIP libre. Pour d’autres numéros, créez d’autres connexions avec les mêmes identifiants API. La liste indique les conflits d’activation et de routage ; un compte vide peut déjà être connecté. L’import remplace la destination SIP directe par le point de terminaison régional choisi. Les appels entrants sont limités au numéro et aux passerelles SIP directes de Zadarma. Les appels sortants utilisent TCP et l’identifiant dédié. Ajoutez du crédit et testez l’audio entrant, l’audio sortant et l’identifiant d’appelant. Le renvoi PBX et les SMS ne sont pas configurés. La suppression ou la déconnexion rétablit la destination précédente uniquement si le numéro pointe toujours vers cette connexion. Les modifications ultérieures dans Zadarma sont conservées. Si la restauration échoue, la connexion reste disponible pour réessayer. Supprimez ensuite manuellement l’identifiant SIP import-… inutilisé dans Zadarma ; l’API documentée ne permet pas sa suppression. Utilisez POST /api/v1/carrier-connections ou MCP create_carrier_connection avec carrier: "zadarma", puis listez et importez le numéro disponible. Commandes CLI équivalentes :