Comment connecter Asterisk à Bitcall Le guide complet d'authentification SIP pour 2026

• Un VPS sous Ubuntu 22.04 ou 24.04 LTS.

• Un compte Bitcall actif : Rendez-vous sur panel.bitcall.io

• Vos identifiants SIP Bitcall : Nom d'utilisateur, mot de passe et domaine.

• Un accès SSH à votre serveur.

Ce guide vous accompagne étape par étape dans la connexion d'un PBX Asterisk au réseau vocal cloud Bitcall via l'enregistrement SIP. Vous configurerez soit le driver legacy chan_sip, soit le driver moderne chan_pjsip, vérifierez l'enregistrement, mettrez en place un plan de numérotation sortant et passerez votre premier appel de test le tout depuis le terminal. Aucune expérience préalable d'Asterisk n'est requise.

Avant d'installer quoi que ce soit, assurez-vous que votre serveur est prêt.

Étape 1 Connectez-vous à votre serveur :

ssh root@your-server-ip

Étape 2 Vérifiez votre version d'Ubuntu :

lsb_release -a

Vous devriez voir Ubuntu 22.04 ou 24.04 LTS. Les deux fonctionnent parfaitement.

Étape 3 Installez les outils de base :

apt install -y curl wget nano net-tools

Ce sont de petits outils auxiliaires nécessaires pendant l'installation. S'ils sont déjà installés, la commande le confirmera simplement et passera à la suite rien ne sera cassé.

Étape 4 Installez Asterisk :

apt install -y asterisk

Cela installe automatiquement Asterisk version 20. Comptez 2 à 5 minutes. Vous verrez beaucoup de texte défiler c'est normal, attendez simplement que cela se termine.

Étape 5 Confirmez qu'Asterisk fonctionne :

asterisk -rx "core show version"

Vous devriez voir : Asterisk 20.x.x

Utilisez cette option si votre système charge le module legacy chan_sip. C'est le driver SIP classique livré avec Asterisk.

Étape 6 Naviguez vers le dossier de configuration Asterisk :

cd /etc/asterisk

C'est le dossier qui contient tous les fichiers de configuration d'Asterisk.

Étape 7 Ajoutez la ligne d'enregistrement dans sip.conf :

Cette commande ajoute automatiquement la ligne d'enregistrement au bon endroit dans la section [general] pas besoin d'ouvrir ou de modifier manuellement le fichier :

sed -i '/^\[general\]/a register => your-bitcall-username:your-bitcall-password@your-bitcall-domain' /etc/asterisk/sip.conf

⚠️ Remplacez your-bitcall-username, your-bitcall-password et your-bitcall-domain par vos vrais identifiants Bitcall depuis panel.bitcall.io.

Vérifiez que la ligne a été correctement ajoutée :

grep "register =>" /etc/asterisk/sip.conf

Vous devriez voir votre ligne d'enregistrement dans la sortie.

CAUTION

La ligne register => doit se trouver à l'intérieur de la section [general] de sip.conf. La commande sed ci-dessus gère cela automatiquement. Si vous l'ajoutez manuellement, assurez-vous qu'elle est placée directement après [general] — si elle est placée en dehors, Asterisk l'ignorera silencieusement et affichera "0 SIP registrations."

Étape 8 — Ajoutez le bloc de configuration du peer Bitcall :

Exécutez cette commande pour ajouter automatiquement les détails de connexion Bitcall à la fin de sip.conf :

cat >> /etc/asterisk/sip.conf << 'EOF'

[bitcall]

type=peer

host=your-bitcall-domain

port=5060

username=your-username

secret=your-password

fromuser=your-username

fromdomain=your-bitcall-domain

insecure=invite

qualify=yes

dtmfmode=rfc2833

disallow=all

allow=ulaw

allow=alaw

nat=yes

canreinvite=no

EOF

⚠️ Remplacez your-bitcall-domain, your-bitcall-username et your-bitcall-password par vos vrais identifiants Bitcall.

NOTE

La dernière ligne doit être uniquement EOF cela indique à la commande « J'ai terminé, enregistre maintenant. » Elle s'exécute instantanément.

Étape 9 Ajoutez le plan de numérotation sortant dans extensions.conf :

cat >> /etc/asterisk/extensions.conf << 'EOF'

[outbound-bitcall]

exten => _X.,1,Set(CALLERID(num)=your-caller-id)

 same => n,Dial(SIP/${EXTEN}@bitcall,60)

 same => n,Hangup()

EOF

⚠️ Remplacez your-caller-id par un Caller ID valide de votre compte Bitcall au format international par exemple +33612345678.

Étape 10 Rechargez Asterisk :

asterisk -rx "reload"

Cela indique à Asterisk de relire tous les fichiers de configuration. Sans cette étape, vos modifications sont complètement ignorées.

Étape 11 Vérifiez l'enregistrement :

asterisk -rx "sip show registry"

Vous devriez voir une sortie comme celle-ci :

Host                                    Username    Refresh  State         Reg.Timeyour-bitcall-domain:5060                your-user   285      Registered    Mon, 23 Mar 2026 13:05:51

1 SIP registrations.

IMPORTANT

Si vous voyez 0 SIP registrations, la cause la plus fréquente est que la ligne register => se trouve en dehors de la section [general]. Retournez à l'Étape 7 et vérifiez son emplacement.

Utilisez cette option si votre système exécute Asterisk 16 ou ultérieur — chan_pjsip est le standard moderne pour Asterisk.

IMPORTANT

Conflit de port : Un seul driver SIP peut utiliser le port 5060 à la fois. Si vous décidez d'utiliser PJSIP, assurez-vous que chan_sip est désactivé ou déplacé sur un autre port.

Étape 12 Ajoutez les blocs de configuration PJSIP :

Exécutez cette commande pour créer un nouveau fichier pjsip.conf avec tous les blocs de connexion nécessaires :

cat > /etc/asterisk/pjsip.conf << 'EOF'

; === BitCall PJSIP Configuration ===

[transport-udp]

type=transport

protocol=udp

bind=0.0.0.0:5060

[bitcall]

type=registration

outbound_auth=bitcall-auth

server_uri=sip:your-bitcall-domain

client_uri=sip:your-bitcall-username@your-bitcall-domain

retry_interval=60

contact_user=your-bitcall-username

[bitcall-auth]

type=auth

auth_type=userpass

username=your-bitcall-username

password=your-bitcall-password

[bitcall-aor]

type=aor

contact=sip:your-bitcall-domain

[bitcall-endpoint]

type=endpoint

transport=transport-udp

aors=bitcall-aor

auth=bitcall-auth

context=outbound-bitcall

disallow=all

allow=ulaw

allow=alaw

outbound_auth=bitcall-auth

[bitcall-identify]

type=identify

endpoint=bitcall-endpoint

match=your-bitcall-domain

EOF

⚠️ Remplacez your-bitcall-domain, your-bitcall-username et your-bitcall-password par vos vrais identifiants Bitcall.

Étape 13 Ajoutez le plan de numérotation sortant PJSIP :

cat >> /etc/asterisk/extensions.conf << 'EOF'

[outbound-bitcall]

exten => _X.,1,Set(CALLERID(num)=your-caller-id)

 same => n,Dial(PJSIP/${EXTEN}@bitcall-endpoint)

 same => n,Hangup()

EOF

⚠️ Remplacez your-caller-id par votre numéro valide au format international.

Étape 14 — Redémarrez Asterisk :

Contrairement à chan_sip, les changements de transport PJSIP (comme le binding sur le port 5060) nécessitent un redémarrage complet :

asterisk -rx "core restart now"

Étape 15 Vérifiez l'enregistrement PJSIP :

asterisk -rx "pjsip show registrations"

Vous devriez voir une sortie comme celle-ci :

<Registration/ServerURI...>           <Auth...>           <Status...>=======================================================================

 bitcall/sip:your-bitcall-domain      bitcall-auth        Registered

Maintenant que vous avez configuré Asterisk (via l'Option A ou l'Option B), exécutez l'une de ces commandes directement dans votre terminal SSH pour tester la connexion :

Pour chan_sip (Option A) :

asterisk -rx "channel originate SIP/bitcall/+33612345678 application Playback hello-world"

Pour PJSIP (Option B) :

asterisk -rx "channel originate PJSIP/+33612345678@bitcall-endpoint application Playback hello-world"

⚠️ Remplacez +33612345678 par votre numéro de téléphone mobile.

Ce qui devrait se passer :

1. Votre téléphone sonne.

2. Quand vous répondez, vous entendez le message audio "hello world".

3. Cela confirme que Bitcall traite correctement votre trafic Asterisk.

ProblèmeCauseSolution [Étape Terminal]0 SIP registrations (chan_sip)La ligne register => est en dehors de [general]Vérifiez avec grep "register =>" /etc/asterisk/sip.conf. Déplacez-la dans [general].Enregistrement SIP rejetéIdentifiants incorrectsVérifiez votre nom d'utilisateur/mot de passe depuis le Panel Bitcall. Confirmez qu'il n'y a pas d'espaces ou de fautes de frappe.Échec du binding du port 5060Deux drivers SIP sur le même portArrêtez d'abord chan_sip : asterisk -rx "module unload chan_sip.so".Audio unidirectionnelProblème NAT / SIP ALGPour chan_sip, définissez nat=yes. Désactivez SIP ALG sur votre routeur/pare-feu.L'appel se coupe rapidementinsecure=invite manquantAjoutez insecure=invite à la configuration de votre peer/endpoint.Endpoint / Peer introuvableNom incorrect dans extensions.confVérifiez que l'identifiant correspond exactement à votre config (bitcall vs bitcall-endpoint).

TIP

Puisqu'un seul driver peut utiliser le port 5060, utilisez ces commandes pour un basculement permanent en un clic.

Pour passer de chan_sip → PJSIP :

sed -i '/\[modules\]/a noload => chan_sip.so' /etc/asterisk/modules.conf

asterisk -rx "core restart now"

asterisk -rx "pjsip show registrations"

Puis mettez à jour votre chaîne Dial dans extensions.conf pour utiliser PJSIP/.

Pour passer de PJSIP → chan_sip :

sed -i '/noload => chan_sip.so/d' /etc/asterisk/modules.conf

sed -i '/\[modules\]/a noload => res_pjsip.so' /etc/asterisk/modules.conf

asterisk -rx "core restart now"

asterisk -rx "sip show registry"

Puis mettez à jour votre chaîne Dial dans extensions.conf pour revenir à Dial(SIP/...).