Guide de configuration des trunks SIP sur la plateforme ODOIP

Sommaire

1.La plateforme ODOIP en bref

ODOIP fournit la connectivité voix (numéros géographiques, SDA, minutes) ; votre IPBX gère vos postes et votre plan d'appel interne. Les deux communiquent par un trunk SIP.

Un appel traverse plusieurs équipements. Côté ODOIP, un SBC (contrôleur de session) reçoit et sécurise le trafic de l'opérateur, puis le cœur de plateforme (sip.odoip.fr) applique le routage, la facturation et la présentation du numéro, avant de livrer l'appel à votre IPBX.

2.Prérequis & paramètres fournis par ODOIP

Avant de commencer, munissez-vous des informations transmises par ODOIP pour votre trunk :

3.Mode A — Tête de ligne enregistrement

Votre IPBX s'enregistre sur sip.odoip.fr avec le numéro tête de ligne et son mot de passe. C'est le mode recommandé : il fonctionne derrière NAT et ne nécessite pas d'IP fixe.

4.Mode B — Identification par IP peering

Aucun enregistrement : la plateforme reconnaît votre IPBX à son adresse IP publique fixe. Idéal pour les IPBX à IP dédiée et haut volume.

5.Configuration par IPBX

Les sections suivantes donnent les champs exacts pour chaque système. Le principe est identique partout : 1) créer le trunk vers ODOIP, 2) router les SDA entrants vers les postes, 3) créer la route sortante et régler la présentation du numéro.

5.1  FreePBX / Asterisk (PJSIP) testé & validé

a) Créer le trunk — Connectivity → Trunks → Add SIP (chan_pjsip) Trunk

b) Vérifier l'enregistrement

# En console Asterisk :
asterisk -rx "pjsip show registrations"
# Attendu :  odoswitch/sip:sip.odoip.fr:5060 ... Registered

c) Routes entrantes — Connectivity → Inbound Routes

Créez une route par SDA : DID Number = le numéro, Set Destination = le poste ou groupe voulu.

[from-odoswitch]
exten => _[+0-9]!,1,Set(REALDID=${PJSIP_HEADER(read,X-DID-Number)})
 same => n,ExecIf($["${REALDID}"=""]?Set(REALDID=${EXTEN}))
 same => n,Goto(from-pstn,${REALDID},1)

d) Route sortante — Connectivity → Outbound Routes

e) Présentation du numéro par poste (conforme ARCEP)

Renseignez le champ Outbound CID de chaque poste (Applications → Extensions) avec le SDA qu'il doit présenter. Pour que ce numéro soit réellement transmis à ODOIP, activez l'envoi du P-Asserted-Identity sur le trunk :

5.2  3CX

Menu SIP Trunks → Add SIP Trunk → Generic → Generic SIP Trunk.

Routez chaque DID (onglet DID → « Route to ») vers l'extension voulue. Pour le sortant, créez une Outbound Rule pointant vers ce trunk et laissez 3CX propager le Caller ID du poste (défini dans les propriétés de l'extension → Outbound Caller ID).

5.3  Yeastar (série P / S)

Menu Extension and Trunk → Trunk → Add.

Le mappage DID → extension se règle dans les paramètres du trunk (onglet Inbound / DID Pattern). Le DOD associe à chaque poste le SDA présenté en sortant (conforme à la validation ARCEP côté ODOIP).

5.4  FreeSWITCH

Déclarez une gateway dans un profil sofia (ex. external) :

<!-- conf/sip_profiles/external/odoip.xml -->
<include>
  <gateway name="odoip">
    <param name="username"    value="<tête de ligne>"/>
    <param name="password"    value="<secret>"/>
    <param name="realm"       value="sip.odoip.fr"/>
    <param name="proxy"       value="sip.odoip.fr"/>
    <param name="from-domain" value="sip.odoip.fr"/>
    <param name="register"    value="true"/>   <!-- false = mode IP -->
    <param name="expire-seconds" value="300"/>
  </gateway>
</include>

Sortant : bridge sofia/gateway/odoip/${destination_number}, en positionnant effective_caller_id_number sur le SDA du poste. Entrant : routez selon ${destination_number} (le SDA appelé) vers l'utilisateur voulu.

5.5  Cisco (CUCM / téléphones)

Sur CUCM (Call Manager), le raccordement se fait via un SIP Trunk pointant vers ODOIP (généralement en mode IP, CUCM ayant une IP fixe) :

Un téléphone SIP Cisco autonome (gamme SPA/MPP) s'enregistre directement : Line 1 → Proxy sip.odoip.fr, User ID = tête de ligne, Password = secret, Register = Yes.

5.6  Autre IPBX (Grandstream, Wildix, Vodia, Sangoma, PBX open source…)

Tout IPBX compatible SIP se raccorde avec les mêmes valeurs. Cherchez dans son interface un « SIP Trunk / VoIP Provider / Gateway » et renseignez :

6.Appels entrants — routage des SDA vers les postes

Un appel vers l'un de vos SDA est livré à votre IPBX ; c'est votre plan de numérotation qui décide du poste sonné.

• Un SDA = une destination. Chez la plupart des PBX, on crée une « route entrante » par numéro (DID) et on choisit le poste, le groupe d'appel, l'IVR/SVI, la messagerie, etc.
• Format du numéro : ODOIP présente le SDA au format national (0183610314) ; prévoyez aussi le format +33… dans vos correspondances par sécurité.

6.1 — Comment ODOIP livre le SDA : mode per-DID / DDI universel

Par défaut, ODOIP place le numéro réellement composé dans la Request-URI de l'INVITE (le champ standard DNIS), y compris en mode tête de ligne (un seul enregistrement, plusieurs SDA). C'est le fonctionnement attendu par tous les IPBX : chacun voit le bon SDA sans configuration exotique.

INVITE sip:0183610318@votre-ipbx SIP/2.0     ← le SDA composé, lisible nativement partout

En complément, ODOIP ajoute aussi l'en-tête X-DID-Number: 0183610318 (utile aux PBX de la famille Asterisk qui préfèrent router par en-tête).

7.Appels sortants & présentation du numéro (ARCEP)

En sortant, deux choses comptent : l'autorisation (ODOIP reconnaît votre trunk) et la présentation (quel numéro voit l'appelé).

8.Vérification & dépannage

Le trunk ne s'enregistre pas

• Vérifiez identifiant = numéro tête de ligne, mot de passe exact, domaine = sip.odoip.fr.
• Pare-feu : UDP 5060 ouvert en sortie ; NAT activé côté IPBX si derrière box.
• Après plusieurs échecs d'authentification, notre pare-feu peut bloquer temporairement votre IP (anti-fraude). Corrigez le mot de passe puis contactez ODOIP pour un déblocage si besoin.

Appel entrant qui n'aboutit pas / mauvais poste

• Vérifiez la route entrante du SDA concerné : en mode per-DID (§6.1), le SDA est dans la Request-URI ; à défaut, contrôlez la lecture de X-DID-Number (§5.1).
• Contrôlez que l'IPBX est bien « Registered » au moment de l'appel.

Sortant : mauvais numéro présenté

• Vérifiez l'Outbound CID du poste et l'envoi du PAI sur le trunk.
• Le numéro présenté doit être un SDA de votre trunk (sinon repli sur le principal).

Analyser un appel (SIP)

L'outil sngrep (sur un serveur SIP) affiche le flux d'un appel (INVITE, 100, 180/183, 200 OK, ou codes d'erreur). Les codes utiles :

9.Annexes

9.1  Ports & pare-feu (sens IPBX → ODOIP)

9.2  Codecs recommandés

alaw (G.711a) pour la meilleure qualité en national, ulaw (G.711u), et G.729 pour économiser la bande passante. Laissez la négociation ouverte à ces trois codecs.

9.3  Glossaire