Passerelle SIP

Passerelle SIP

À quoi sert cette page ?

La page de configuration de la passerelle SIP permet de connecter CapCall à une passerelle téléphonique WebRTC-to-SIP. Lorsqu'elle est configurée, les prospecteurs peuvent passer leurs appels directement depuis le navigateur sans logiciel tiers.

Accès : Menu CapCall > Configuration > onglet Passerelle SIP

Droit requis : Administrateur Dolibarr uniquement

Paramètres de connexion

Paramètre Description
URL de l'API passerelle URL de base de l'API REST de la passerelle SIP (port 8443)
Token API (Bearer) Token d'authentification fourni lors de la création du tenant. Le token n'est plus affiché après la saisie
Secret webhook (HMAC) Clé secrète HMAC-SHA256 pour vérifier l'authenticité des webhooks reçus de la passerelle
Identifiant du tenant Slug identifiant cette instance Dolibarr sur la passerelle
Hôte WebSocket Nom d'hôte de la passerelle pour la connexion WebSocket du navigateur (port 443)

Page de configuration de la passerelle SIP avec les champs URL, token, secret, tenant et WebSocket

Attention : Le token API et le secret webhook sont des données sensibles. Ils sont masqués en mode consultation. Pour les modifier, passez en mode édition et saisissez la nouvelle valeur. Laissez le champ vide pour conserver la valeur actuelle.

Test de connexion

Après avoir saisi les paramètres, cliquez sur le bouton Tester la connexion pour vérifier que la passerelle est joignable. Le test effectue deux vérifications :

  1. Vérification de santé : appel à l'endpoint /api/health de la passerelle. Si la passerelle est joignable, les informations suivantes sont affichées :

    • Nombre d'appels actifs
    • Nombre de tenants enregistrés
    • État de la passerelle (opérationnelle ou en cours d'arrêt)

  2. Vérification du tenant : appel authentifié à l'endpoint /api/usage avec le token API. Les résultats possibles sont :

    • Token reconnu : le tenant est enregistré et actif
    • Token non reconnu (HTTP 401) : vérifiez que le tenant est créé avec ce token
    • Accès refusé (HTTP 403) : le tenant est suspendu ou l'adresse IP n'est pas autorisée

Résultat du test de connexion avec statut de la passerelle et vérification du tenant

Fonctionnement côté prospecteur

Lorsque la passerelle est configurée, l'interface prospecteur affiche un bouton d'appel intégré au navigateur. Le flux d'appel est le suivant :

  1. Le navigateur demande l'accès au microphone
  2. La connexion WebSocket est établie avec la passerelle
  3. L'appel est initié (statut : "Connexion en cours...")
  4. La sonnerie retentit (statut : "Ça sonne...")
  5. Le correspondant décroche (statut : "En ligne")
  6. L'appel se termine (statut : "Appel terminé")

En cas d'erreur, un message explicite est affiché (accès micro refusé, WebRTC non supporté, échec de connexion, etc.).

Actions

Cliquez sur Modifier pour passer en mode édition. Après modification, cliquez sur Sauvegarder pour enregistrer ou Annuler pour revenir aux valeurs précédentes.

Import Appel direct