# Numéros de téléphone

Associez le numéro SIP du client à un agent pour les appels vocaux entrants

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Ajoutez un numéro de téléphone SIP, associez-le à un agent, et l'agent vocal IA répond aux appels entrants.

<VoiceSetupDemo />

## Connecter un téléphone [#connect-a-phone]

1. Obtenez les identifiants SIP auprès d'un [fournisseur pris en charge](/docs/integrations/telephony) : numéro de téléphone, login SIP, mot de passe SIP, URL de téléphonie.
2. **Téléphones** > **Ajouter un téléphone**, remplissez les champs ci-dessous, **Enregistrer**.
3. Associez-le : sélectionnez un **Agent** dans les paramètres du téléphone (un téléphone → un agent), **Enregistrer**.
4. Ajoutez l'intégration du fournisseur de téléphonie : **Intégrations** > **Ajouter une intégration** > choisissez le fournisseur, saisissez les identifiants, activez.
5. Configurez les paramètres vocaux de l'agent, puis appelez le numéro pour tester l'accueil et un outil.

## Champs du téléphone [#phone-fields]

| Champ               | Valeur                                          |
| ------------------- | ----------------------------------------------- |
| Numéro de téléphone | Numéro de téléphone SIP (par ex. +380501234567) |
| Login SIP           | Nom d'utilisateur d'authentification            |
| Mot de passe SIP    | Mot de passe d'authentification                 |
| URL du fournisseur  | Adresse du serveur SIP                          |
| Codec               | A-law (par défaut) ou μ-law                     |
| Commentaire         | Libellé facultatif                              |

## Paramètres vocaux (sur l'agent) [#voice-settings-on-assistant]

| Paramètre          | Valeur                                                          |
| ------------------ | --------------------------------------------------------------- |
| Voix               | 30 voix intégrées ou ElevenLabs                                 |
| Format audio       | Format d'entrée/sortie (PCM 8000 par défaut)                    |
| Réactivité         | Eager, Normal ou Patient                                        |
| Tour après silence | Secondes avant que l'agent ne parle (7 par défaut)              |
| Délai souple       | Attente maximale de la réponse de l'utilisateur ; -1 = illimité |

Voir [Agents > Paramètres vocaux](/docs/agents).

## API [#api]

```bash
POST /api/phones
X-Access-Token: happ_your_token_here
Content-Type: application/json

{
  "phoneNumber": "+380501234567",
  "sipLogin": "your-sip-login",
  "password": "your-sip-password",
  "telephonyUrl": "sip.provider.com",
  "codec": "alaw",
  "comment": "Main office line"
}
```

Associez-le à un agent avec `PATCH /api/phones/{phoneId}` (`{ "assistantId": "..." }`). Liste : `GET /api/phones`, mise à jour : `PATCH`, suppression : `DELETE /api/phones/{phoneId}`.

**API :** [api.happ.tools/reference](https://api.happ.tools/reference)

## Dépannage [#troubleshooting]

| Problème         | Solution                                                           |
| ---------------- | ------------------------------------------------------------------ |
| Pas de son       | Vérifiez les identifiants SIP et l'URL du fournisseur              |
| Son haché        | Vérifiez le réseau ; essayez l'autre codec (alaw ou ulaw)          |
| Réponses lentes  | Réglez la réactivité sur Eager                                     |
| Pas de connexion | Vérifiez que l'intégration du fournisseur de téléphonie est active |
| Mauvaise voix    | Vérifiez le paramètre de voix dans la configuration de l'agent     |

## Pour aller plus loin [#next]

* [Fournisseurs de téléphonie](/docs/integrations/telephony) — liste des fournisseurs
* [Agent vocal](/docs/agents/voice) — vue d'ensemble