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

# Vonage

> Branchez Vonage (Nexmo) : API Key, API Secret, Application ID, clé privée RSA et signature des webhooks. Audio 16 kHz Linear PCM, réponses NCCO.

## Vue d'ensemble

Vonage (ex-Nexmo) se configure avec une **application Vonage** : vous fournissez
des identifiants, une **clé privée RSA** (pour signer les jetons) et un secret
de signature pour valider les webhooks.

## Champs de configuration

| Champ | Requis | Remarques |
| - | - | - |
| `api_key` | **Oui** | Clé API Vonage |
| `api_secret` | **Oui** | Secret API, stocké chiffré |
| `application_id` | **Oui** | Non sensible, affiché en clair |
| `private_key` | **Oui** | Clé **RSA** (génération des JWT) |
| `signature_secret` | Optionnel | **Requis en pratique** : sans lui, les webhooks entrants sont rejetés |
| `from_numbers` | - | **E.164 sans le `+`** |

## Configuration

**1. Créer une application Vonage**

Dans le tableau de bord Vonage, créez une **application** et générez une
paire de clés. Récupérez l'**Application ID** et la **clé privée**.

**2. Sélectionner Vonage**

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

**3. Saisir les identifiants**

Renseignez `api_key`, `api_secret`, `application_id` et la clé privée.

**4. Ajouter le secret de signature**

Renseignez le `signature_secret` pour que les webhooks entrants soient
**acceptés**.

**5. Associer les numéros et l'agent**

Numéros **sans `+`**, puis le workflow **publié** à servir.

## Spécificités techniques

* **Audio** : 16 kHz **Linear PCM** (`audio/l16;rate=16000`).
* **Réponses** : **NCCO** (JSON), Vonage pilote l'appel via des objets NCCO.

> [!WARNING]
>
> Sans `signature_secret`, Vonage enverra des webhooks que Bookivox **rejettera**
> par sécurité (validation de signature obligatoire).

> **[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.