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

# Vue d'ensemble

> Recevez des notifications en temps reel lorsque des evenements se produisent dans votre compte Allo

Les webhooks permettent a Allo d'envoyer des evenements a votre serveur en temps reel. Lorsque quelque chose se produit -- un appel se termine, un SMS arrive, un contact est cree -- Allo envoie une requete HTTPS POST a votre endpoint avec les donnees de l'evenement.

## Comment ca fonctionne

1. Un evenement se produit dans votre compte Allo (par ex., un appel est termine).
2. Allo envoie une requete HTTPS POST a l'URL que vous avez configuree.
3. Votre serveur recoit la requete, verifie la signature et traite l'evenement.

## Evenements disponibles

| Evenement         | Description                                                                          |
| ----------------- | ------------------------------------------------------------------------------------ |
| `call.received`   | Un appel entrant commence a sonner                                                   |
| `call.triggered`  | Un appel sortant est initie                                                          |
| `call.answered`   | Un appel est decroche de l'autre cote                                                |
| `call.completed`  | Un appel est termine avec toutes les donnees (enregistrement, transcription, resume) |
| `tag.added`       | Un tag est ajoute a un appel                                                         |
| `tag.removed`     | Un tag est supprime d'un appel                                                       |
| `sms.received`    | Un SMS entrant est recu                                                              |
| `sms.sent`        | Un SMS sortant est envoye                                                            |
| `contact.created` | Un contact est cree                                                                  |
| `contact.updated` | Un contact est mis a jour                                                            |

Consultez le [Catalogue d'evenements](/fr/v2/api-reference/webhooks/event-catalog) pour les schemas complets des payloads.

## Format du payload

Chaque webhook utilise le meme format d'enveloppe :

```json theme={null}
{
  "topic": "call.completed",
  "version": "2.0",
  "timestamp": "2025-03-15T14:30:45.123456Z",
  "data": {
    // Champs specifiques a l'evenement
  }
}
```

| Champ       | Type   | Description                                                  |
| ----------- | ------ | ------------------------------------------------------------ |
| `topic`     | string | Type d'evenement (par ex., `call.completed`, `sms.received`) |
| `version`   | string | Version du payload, toujours `"2.0"`                         |
| `timestamp` | string | Horodatage ISO 8601 indiquant quand l'evenement a ete envoye |
| `data`      | object | Payload specifique a l'evenement                             |

## Demarrage rapide

<Steps>
  <Step title="Creer un endpoint webhook">
    Rendez-vous dans [Parametres > Webhooks](https://web.withallo.com/settings/webhooks) dans votre tableau de bord Allo. Ajoutez l'URL HTTPS de votre endpoint et selectionnez les evenements que vous souhaitez recevoir. Le webhook s'applique a tous les numeros Allo de votre workspace.
  </Step>

  <Step title="Traiter les requetes entrantes">
    Votre endpoint recoit des requetes POST avec le payload de l'evenement dans le corps. Retournez un code de statut `2xx` dans les 20 secondes pour confirmer la reception.
  </Step>

  <Step title="Verifier les signatures">
    Chaque webhook inclut une signature cryptographique. Verifiez-la pour vous assurer que la requete provient bien d'Allo. Voir [Verification des signatures](/fr/v2/api-reference/webhooks/verifying-signatures).
  </Step>
</Steps>

## Etapes suivantes

<CardGroup cols={2}>
  <Card title="Catalogue d'evenements" icon="list" href="/fr/v2/api-reference/webhooks/event-catalog">
    Reference complete de tous les evenements et leurs payloads
  </Card>

  <Card title="Verification des signatures" icon="shield-halved" href="/fr/v2/api-reference/webhooks/verifying-signatures">
    Authentifiez les webhooks entrants avec HMAC-SHA256
  </Card>
</CardGroup>