Aller au contenu principal

FreeSWITCH

Ce guide explique comment raccorder votre PBX FreeSWITCH au Trunk SIP ODOIP, en déclarant une passerelle (gateway) sortante et en routant vos appels.

Prérequis​

  • Un Trunk SIP actif et les identifiants fournis à l’activation (ou votre adresse IP publique si vous avez choisi l’authentification par IP).
  • Un accès à la configuration de votre FreeSWITCH (dossier /usr/local/freeswitch/conf/ par défaut).

1. Créer la passerelle (gateway)​

Créez le fichier conf/sip_profiles/external/odoip.xml :

<include>
  <gateway name="odoip">
    <param name="username" value="VOTRE_IDENTIFIANT"/>
    <param name="password" value="VOTRE_SECRET"/>
    <param name="realm" value="sip.odoip.fr"/>
    <param name="proxy" value="sip.odoip.fr"/>
    <param name="register" value="true"/>
    <param name="expire-seconds" value="600"/>
    <param name="retry-seconds" value="30"/>
    <param name="from-domain" value="sip.odoip.fr"/>
    <param name="caller-id-in-from" value="true"/>
  </gateway>
</include>
Authentification par identifiants ou par IP
  • Par identifiants (ci-dessus) : register à true, avec votre identifiant et votre secret.
  • Par IP : passez register à false et laissez username/password vides. Votre adresse IP publique doit être déclarée côté ODOIP.
Codecs

ODOIP négocie le G.711 (a-law et µ-law). Dans conf/vars.xml, assurez-vous que global_codec_prefs et outbound_codec_prefs incluent PCMA,PCMU (par exemple PCMA,PCMU).

2. Recharger et vérifier l’enregistrement​

fs_cli -x "reloadxml"
fs_cli -x "sofia profile external restart"
# Vérifier l'état de la passerelle
fs_cli -x "sofia status gateway odoip"

La passerelle doit passer à l’état REGED (enregistrée).

3. Route sortante​

Dans votre dialplan (par exemple conf/dialplan/default.xml), ajoutez une extension qui envoie les appels sortants vers la passerelle :

<extension name="sortant_odoip">
  <condition field="destination_number" expression="^(0\d{9})$">
    <action application="set" data="effective_caller_id_number=VOTRE_NUMERO"/>
    <action application="bridge" data="sofia/gateway/odoip/$1"/>
  </condition>
</extension>
Présentation du numéro

effective_caller_id_number doit correspondre à un de vos numéros attribués par ODOIP. Un numéro non autorisé est rejeté.

4. Route entrante (DID)​

Les appels entrants arrivent sur votre DID. Dans le contexte public (conf/dialplan/public.xml), dirigez le numéro vers le poste ou le groupe souhaité :

<extension name="entrant_odoip">
  <condition field="destination_number" expression="^(VOTRE_NUMERO)$">
    <action application="transfer" data="1000 XML default"/>
  </condition>
</extension>

Remplacez 1000 par l’extension de destination.

Dépannage​

La passerelle ne s’enregistre pas (NOREG / FAIL_WAIT)

  • Vérifiez l’identifiant, le secret et realm (sip.odoip.fr).
  • Vérifiez que votre pare-feu autorise le SIP (port 5060) et les flux RTP.

Pas de son ou son dans un seul sens

  • Problème de média (RTP) lié au NAT ou au pare-feu. Vérifiez ext-sip-ip / ext-rtp-ip dans le profil external et l’ouverture des ports RTP.

Appel sortant rejeté

  • Vérifiez que effective_caller_id_number est bien un de vos numéros ODOIP.

Besoin d’aide ?​

Pour toute question, contactez notre support à contact@odoip.fr. Pensez à préciser votre version de FreeSWITCH.