Skip to main content
POST
Créer un trunk SIP
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
Ce point de terminaison crée un nouveau trunk SIP. La plateforme provisionne automatiquement les trunks entrants et sortants sur l’infrastructure vocale à l’aide des identifiants fournis.

Paramètres du corps

string
requis
Le type de trunk SIP : extension pour une extension SIP, ou number pour un numéro de téléphone (DID). Cela détermine le format attendu du champ phone_number.
string
requis
L’extension SIP (1 à 15 caractères, par ex. 1000) lorsque sip_trunk_type vaut extension, ou un numéro de téléphone au format E.164 (par ex. +14155551234) lorsque sip_trunk_type vaut number.
string
Une étiquette courte et conviviale pour le trunk (par ex. « Fournisseur X — Principal »). 50 caractères maximum.
string
requis
Nom d’utilisateur pour l’authentification SIP (3 à 128 caractères)
string
requis
Mot de passe pour l’authentification SIP (3 caractères minimum)
string
requis
L’adresse du serveur SIP sans le port (par ex. sip.provider.com)
string
requis
Le format du numéro appelant sortant :
  • +e164 - International avec préfixe + (par ex. +12025550123)
  • e164 - International sans préfixe + (par ex. 12025550123)
  • national - Format national sans indicatif pays (par ex. 0741926265)
string
requis
Comment les appels entrants sont authentifiés :
  • auth - Utilise le même nom d’utilisateur et mot de passe SIP configurés pour les appels sortants
  • ip - Autorise des adresses IP spécifiques via liste blanche (nécessite allowed_inbound_ips)
array
Tableau des adresses IP autorisées à envoyer des appels entrants. Requis lorsque inbound_authorization_type vaut ip. Doit contenir au moins une adresse IP valide.
string
requis
Code pays ISO 3166-2 où se situe le trunk SIP (par ex. US, GB, DE). Lorsque sip_trunk_type vaut number, le pays est détecté automatiquement à partir du numéro de téléphone si possible.
boolean
Achemine les appels sortants via une adresse IP fixe. Par défaut : false. N’activez ceci que si votre fournisseur SIP exige une authentification basée sur l’IP pour le trafic sortant.

Réponse

string
Message de succès
object
L’objet trunk SIP créé (mêmes champs que Récupérer un trunk SIP)

Ce qui se passe après la création

Lorsque vous créez un trunk SIP, la plateforme effectue automatiquement les actions suivantes :
  1. Provisionne un trunk entrant sur l’infrastructure vocale - en utilisant soit l’authentification par nom d’utilisateur/mot de passe, soit l’authentification basée sur l’IP selon votre paramètre inbound_authorization_type
  2. Provisionne un trunk sortant - en utilisant l’adresse SIP et les identifiants que vous avez fournis, éventuellement via le proxy sortant
Si le provisionnement échoue, le trunk SIP n’est pas enregistré et une erreur 500 est renvoyée.

Étapes suivantes

Après avoir créé un trunk SIP, assignez-le à un assistant IA :