Aller au contenu principal

Raccorder Asterisk / FreePBX au Trunk SIP ODOIP

Ce guide explique comment connecter un serveur FreePBX (basé sur Asterisk) au Trunk SIP ODOIP, à l’aide d’un trunk chan_pjsip avec inscription par identifiants.

info

Ce guide suit l’interface FreePBX (version 15 ou 16) avec le pilote chan_pjsip, recommandé par défaut. Les libellés sont ceux de l’interface d’administration FreePBX.

1. Prérequis​

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • un Trunk SIP ODOIP actif sur votre compte ;
  • les identifiants de votre Trunk fournis à l’activation (Username et Secret) ;
  • le numéro (DID) inclus avec votre Trunk ;
  • un accès administrateur à FreePBX.
astuce

Vous retrouvez à tout moment vos identifiants et le détail de votre Trunk dans votre espace client : https://clients.odoip.com.

2. Créer le trunk SIP (chan_pjsip)​

  1. Connectez-vous à l’interface d’administration FreePBX.
  2. Ouvrez Connectivity > Trunks (Connectivité > Lignes réseau), puis cliquez sur Add Trunk et choisissez Add SIP (chan_pjsip) Trunk.
  3. Dans l’onglet General (Général) :
    • Trunk Name : un libellé explicite, par exemple odoip.
    • Outbound CallerID : votre numéro (DID) ODOIP au format international (par exemple 33xxxxxxxxx).
  4. Ouvrez l’onglet pjsip Settings, sous-onglet General, et renseignez :
    • Username : votre identifiant d’authentification ODOIP ;
    • Secret : le secret associé ;
    • Authentication : Outbound ;
    • Registration : Send (envoyer l’inscription) ;
    • SIP Server : sip.odoip.fr
    • SIP Server Port : 5060
  5. Ouvrez le sous-onglet Advanced (pjsip Settings > Advanced) et vérifiez :
    • From Domain : sip.odoip.fr
    • Codecs : activez alaw (G.711) et opus.
  6. Cliquez sur Submit (Soumettre) puis sur Apply Config (Appliquer la configuration).
astuce

Si votre Trunk est en authentification par adresse IP, réglez Authentication : None et Registration : None, puis communiquez à ODOIP l’adresse IP publique fixe de votre serveur.

Exemple de chaîne de registre​

Si vous configurez le registre manuellement (ou via le champ Register String sur un trunk chan_sip ancien), la syntaxe est de la forme suivante :

IDENTIFIANT:SECRET@sip.odoip.fr:5060/IDENTIFIANT

En chan_pjsip, ne saisissez pas cette chaîne : renseignez séparément les champs Username, Secret, SIP Server et SIP Server Port décrits ci-dessus, et laissez Registration : Send.

Après application, vérifiez l’état en console Asterisk :

asterisk -rx "pjsip show registrations"

L’inscription doit afficher l’état Registered.

3. Route entrante (diriger le DID)​

Les appels entrants arrivent sur votre numéro (DID). Créez une route entrante pour les diriger.

  1. Ouvrez Connectivity > Inbound Routes (Routes entrantes), puis cliquez sur Add Inbound Route.
  2. Renseignez :
    • Description : par exemple Entrant ODOIP.
    • DID Number : votre numéro (DID) ODOIP (au format tel que présenté par ODOIP sur les appels entrants).
  3. Dans Set Destination (Définir la destination), choisissez la cible : une Extension, un Ring Group (groupe d’appel), une Queue (file d’attente) ou un IVR (standard automatique).
  4. Cliquez sur Submit puis Apply Config.
astuce

En cas de doute sur le format du DID reçu, laissez le champ DID Number vide pour créer une route entrante « attrape-tout » (any DID), le temps d’observer le numéro réellement présenté.

4. Route sortante et motifs de numérotation​

La route sortante détermine quels appels partent par le Trunk ODOIP.

  1. Ouvrez Connectivity > Outbound Routes (Routes sortantes), puis cliquez sur Add Outbound Route.
  2. Dans l’onglet Route Settings :
    • Route Name : par exemple Sortant ODOIP.
    • Trunk Sequence for Matched Routes : sélectionnez le trunk odoip créé à l’étape 2.
  3. Dans l’onglet Dial Patterns (Motifs de numérotation), ajoutez les motifs correspondant à votre plan, par exemple :
    • match pattern 0XXXXXXXXX pour les numéros français à 10 chiffres commençant par 0 ;
    • match pattern 00. pour l’international. Utilisez les colonnes prepend et prefix si vous devez ajouter ou retirer des chiffres avant l’envoi.
  4. Cliquez sur Submit puis Apply Config.
attention

Le numéro appelant présenté (Outbound CallerID) doit correspondre à votre numéro (DID) ODOIP. Un numéro non autorisé peut être rejeté par l’opérateur.

5. Tableau récapitulatif des paramètres​

ParamètreValeur
Pilotechan_pjsip
SIP Serversip.odoip.fr
SIP Server Port5060
From Domainsip.odoip.fr
Usernameidentifiant fourni à l’activation
Secretsecret fourni à l’activation
AuthenticationOutbound
RegistrationSend
Codecsalaw (G.711), opus
Numéro (DID)numéro inclus avec le Trunk

6. Test et dépannage​

  • L’inscription reste « Unregistered » ou « Rejected » : vérifiez le Username, le Secret, le SIP Server sip.odoip.fr et le port 5060. Contrôlez en console avec asterisk -rx "pjsip show registrations".
  • Pas d’audio ou audio dans un seul sens : vérifiez les réglages NAT de FreePBX (Settings > Asterisk SIP Settings), l’adresse IP externe déclarée et l’ouverture des ports RTP.
  • Appels entrants non routés : contrôlez le DID Number de la route entrante par rapport au numéro réellement présenté (voir l’astuce de l’étape 3).
  • Appels sortants en échec : contrôlez les Dial Patterns et l’Outbound CallerID.
astuce

Pour un premier test, appelez votre numéro (DID) depuis un mobile : l’appel doit aboutir sur la destination définie à l’étape 3.

Besoin d’aide ?​

Notre équipe reste à votre disposition. Ouvrez un ticket depuis votre espace client : https://clients.odoip.com.