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

# Telnyx

> Branchez Telnyx (Call Control) : clé API, Application Call Control auto-créée et clé publique de webhook obligatoire pour accepter les événements.

## Vue d'ensemble

Telnyx fonctionne en mode **Call Control** : Bookivox pilote l'appel via des
appels REST. Une **Call Control Application** est nécessaire ; Bookivox peut la
**créer automatiquement** à l'enregistrement.

## Champs de configuration

| Champ | Requis | Remarques |
| - | - | - |
| `api_key` | **Oui** | Clé API Telnyx |
| `connection_id` | Optionnel | Call Control Application ID, **auto-créée** si absente |
| `webhook_public_key` | Optionnel | **Requis en pratique** : sans elle, les webhooks Telnyx sont rejetés |
| `from_numbers` | - | E.164 |

## Configuration

**1. Créer une clé API Telnyx**

Dans le portail Telnyx, générez une **clé API**.

**2. Sélectionner Telnyx**

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

**3. Saisir la clé API**

Renseignez `api_key`. Vous pouvez laisser `connection_id` vide :
l'application Call Control sera **créée automatiquement**.

**4. Ajouter la clé publique de webhook**

Copiez la **clé publique** (portail Telnyx → *Keys & Credentials*) dans
`webhook_public_key` pour que les événements soient **acceptés**.

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

Numéros E.164, puis le workflow **publié**.

## Spécificités techniques

* **Base API** : `https://api.telnyx.com/v2`.
* **Call Control** : Bookivox répond et streame via des appels REST.
* L'application créée automatiquement est configurée par Bookivox pour recevoir
  les événements d'appel.

> [!WARNING]
>
> Sans `webhook_public_key`, la **signature** des webhooks Telnyx ne peut pas être
> vérifiée : Bookivox les **rejette** par sécurité.

> **[Transfert d'appel](https://docs.bookivox.com/integrations/overview.md)**
>
> Telnyx est compatible avec le transfert.

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


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