# Configuración del webhook

> Configure BroadNet para enviar por POST las confirmaciones de entrega (DLR) y los mensajes entrantes (MO) a su URL HTTPS, y así seguir el estado final de cada mensaje sin sondeos. Confirme la recepción rápidamente con HTTP 200 y procese de forma asíncrona.

- URL canónica: https://www.broadnet.me/es/developers/webhooks
- Idioma: es
- Última actualización: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)

BroadNet envía el estado de entrega a la URL del webhook configurada en tu cuenta a medida que cada mensaje avanza en su ciclo de vida. También puedes realizar consultas: GET /whatsapp/message/bulk-insights devuelve el estado de cada destinatario WhatsApp en un lote, y GET /sms/list devuelve el número de mensajes procesados y pendientes para los envíos masivos SMS.

> **Responde rápido, trabaja después.** Responda a cada POST del webhook con un código 2xx tan pronto como la haya almacenado y, a continuación, procésela de forma asíncrona. Asegúrese de que su controlador pueda ejecutarse dos veces para la misma actualización.

## Ejemplos

### 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);
});
```

Controlador ilustrativo. Los campos de la carga útil varían según el canal; consulte la especificación OpenAPI.

## Relacionado

- [Estándar de entrega y confiabilidad de webhooks](https://www.broadnet.me/es/reference/webhook-delivery-and-reliability)