# Configuration du webhook

> Configurez BroadNet pour envoyer en POST les accusés de réception (DLR) et les messages entrants (MO) vers votre URL HTTPS, afin de suivre l'état final de chaque message sans interrogation. Répondez rapidement par HTTP 200 et traitez les données de manière asynchrone.

- URL canonique: https://www.broadnet.me/fr/developers/webhooks
- Langue: fr
- Dernière mise à jour: 2026-10-21
- Éditeur: BroadNet (https://www.broadnet.me)

BroadNet envoie l'état de la livraison à l'URL du webhook configurée sur votre compte à mesure que chaque message progresse dans son cycle de vie. Vous pouvez également interroger le système : la requête GET /whatsapp/message/bulk-insights renvoie l'état de chaque destinataire WhatsApp d'un lot, et la requête GET /sms/list renvoie le nombre de messages traités et en attente pour les envois de SMS groupés.

> **Répondez vite, travaillez ensuite.** Répondez à chaque POST de webhook par un code 2xx dès que vous l'avez enregistrée, puis traitez-la de manière asynchrone. Assurez-vous que votre gestionnaire puisse s'exécuter deux fois pour une même mise à jour.

## Exemples

### message statuses

```text
SUBMITTED   accepted by BroadNet, queued for the network
SENT        handed to the operator or channel
DELIVERED   confirmed on the handset
READ        opened by the recipient (channels that report reads, e.g. WhatsApp)
FAILED      not delivered
REJECTED    refused by the operator or channel
```

### webhook.ts

```typescript
import express from "express";

const app = express();

app.post("/webhooks/broadnet", express.json(), async (req, res) => {
  // Store the raw status update first, then acknowledge.
  // Field names per channel are in the OpenAPI spec.
  await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
  res.sendStatus(200);
});
```

Gestionnaire illustratif. Les champs de charge utile varient selon le canal; voir la spécification OpenAPI.

## Voir aussi

- [Norme de livraison et de fiabilité des webhooks](https://www.broadnet.me/fr/reference/webhook-delivery-and-reliability)