---
title: "Passerelle SIP"
weight: 75
description: "Configurer la connexion à la passerelle téléphonique WebRTC-to-SIP pour les appels depuis le navigateur."
---

# 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](screenshots/passerelle-sip-configuration.webp)

> **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](screenshots/passerelle-sip-test-connexion.webp)

## 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.