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

# Twilio

> Branchez votre propre compte Twilio (BYOK) : Account SID et Auth Token, détection de répondeur (AMD), signature des webhooks et gestion des numéros E.164.

## Vue d'ensemble

Twilio est le fournisseur **le plus complet** de Bookivox. Deux modes :

| Mode | Ce que vous fournissez |
| - | - |
| **Numéro Bookivox** (managé) | Rien, voir [Numéro managé](https://docs.bookivox.com/telephony/providers/bookivox-number.md) |
| **Twilio (BYOK)** | Vos `account_sid` et `auth_token` |

> [!NOTE]
>
> Dans la liste déroulante, **Twilio apparaît deux fois** : « Numéro Bookivox »
> (managé) et « Twilio (BYOK) ». Choisissez la seconde pour apporter votre compte.

## Prérequis

* Un compte Twilio actif.
* Un numéro Twilio **au format E.164**.
* Si vous utilisez AMD, vérifiez que la détection de répondeur est disponible sur
  votre compte (facturée **en supplément** par Twilio).

## Configuration

**1. Choisir Twilio (BYOK)**

Dans **Configurations téléphoniques**, sélectionnez **Twilio (BYOK)**.

**2. Saisir les identifiants**

Renseignez l'**Account SID** (commence par `AC`) et l'**Auth Token**.
Ils sont stockés **chiffrés**.

**3. Activer la détection de répondeur (optionnel)**

Cochez **AMD** si vous voulez détecter les répondeurs/messageries.

**4. Associer les numéros**

Renseignez le ou les numéros **E.164** rattachés.

**5. Choisir l'agent**

Indiquez le workflow **publié** qui doit répondre.

## Champs de configuration

| Champ | Requis | Remarques |
| - | - | - |
| `account_sid` | Oui (hors managé) | Commence par `AC` |
| `auth_token` | Oui (hors managé) | Stocké chiffré |
| `amd_enabled` | Non | Détection de répondeur, facturée par Twilio |
| `from_numbers` | - | Gérés via les endpoints de numéros dédiés |

## Sécurité et webhooks

> [!WARNING]
>
> * Les webhooks entrants sont **validés** par la signature Twilio
>   (`X-Twilio-Signature`, HMAC). Une signature absente entraîne un **rejet**.
> * Utilisez un **Auth Token dédié** à Bookivox quand c'est possible, et
>   **régénérez-le** au moindre doute.

## Numéros

Les numéros sont au format **E.164**. À l'attachement, Bookivox retrouve le
numéro puis configure sa `VoiceUrl`. Les adresses **non-PSTN** (URI SIP,
extensions) sont **ignorées**.

> **[Numéro managé](https://docs.bookivox.com/telephony/providers/bookivox-number.md)**
>
> Ne rien gérer côté Twilio.

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


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