> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bookivox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ARI (Asterisk)

> Branchez Asterisk (ARI) : endpoint, nom d'application et mot de passe. Bookivox se connecte en WebSocket à votre serveur.

## Vue d'ensemble

ARI (Asterisk REST Interface) branche Bookivox directement sur votre propre
serveur **Asterisk**. La particularité d'ARI est son transport : Bookivox
établit une **connexion WebSocket** persistante vers votre serveur ARI.

## Champs de configuration

| Champ | Requis | Remarques |
| - | - | - |
| `ari_endpoint` | **Oui** | URL de votre endpoint ARI |
| `app_name` | **Oui** | Nom de l'application ARI (Stasis) |
| `app_password` | **Oui** | Mot de passe ARI, stocké chiffré |
| `ws_client_name` | Optionnel | Nom du client WebSocket (défaut : chaîne vide) |
| `from_numbers` | - | Affiché comme « From Extensions » |

## Configuration

**1. Préparer Asterisk**

Activez l'interface ARI dans votre `ari.conf` et créez un utilisateur dédié
avec un mot de passe.

**2. Sélectionner ARI**

Dans **Configurations téléphoniques**, choisissez **ARI**.

**3. Saisir les identifiants**

Renseignez `ari_endpoint`, `app_name` et `app_password`. `ws_client_name` est
optionnel (par défaut une chaîne vide).

**4. Associer les extensions et l'agent**

Les numéros sont présentés comme des **extensions** (« From Extensions »), puis
sélectionnez le workflow **publié**.

## Spécificités techniques

* **Transport** : Bookivox établit une connexion ARI **WebSocket** persistante
  vers votre serveur ; vous n'avez aucune route HTTP à exposer de votre côté.
* **Authentification** : la connexion s'appuie sur vos identifiants ARI
  (`app_name`, `app_password`), sans signature de webhook supplémentaire.
* **Numéros** : identifiés comme des **extensions**, sans notion d'account-id.
* **Credentials** : `app_password` est stocké chiffré et n'est jamais réexposé
  en clair.

> [!WARNING]
>
> Exposez votre endpoint ARI uniquement sur un réseau de confiance ou via TLS.
> Comme il n'y a pas de signature de webhook, tout accès au WebSocket avec les
> identifiants ARI peut piloter vos appels.

> **[Configurations](https://docs.bookivox.com/telephony/configurations.md)**
>
> Créer une configuration.

> **[Vue d'ensemble](https://docs.bookivox.com/telephony/overview.md)**
>
> Tous les fournisseurs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.