# Настройка веб-перехватчика

> Настройте BroadNet на отправку отчётов о доставке (DLR) и входящих (MO) через POST на ваш HTTPS URL — итоговый статус каждого сообщения без опроса. Быстро подтверждайте получение кодом HTTP 200 и обрабатывайте данные асинхронно.

- Канонический URL: https://www.broadnet.me/ru/developers/webhooks
- Язык: ru
- Последнее обновление: 2026-10-21
- Издатель: BroadNet (https://www.broadnet.me)

BroadNet отправляет информацию о статусе доставки на URL веб-перехватчика, настроенный в вашей учетной записи, по мере прохождения каждым сообщением своего жизненного цикла. Вы также можете опрашивать: GET /whatsapp/message/bulk-insights возвращает статус каждого получателя WhatsApp в пакете, а GET /sms/list возвращает количество обработанных и ожидающих обработки SMS сообщений.

> **Отвечайте быстро, работайте позже.** Отправляйте ответ на каждый POST веб-хука с кодом 2xx сразу после его сохранения, а затем обрабатывайте его асинхронно. Сделайте так, чтобы ваш обработчик мог безопасно запускаться дважды для одного и того же обновления.

## Примеры

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

Иллюстративный обработчик. Поля полезной нагрузки различаются в зависимости от канала; см. спецификацию OpenAPI.

## См. также

- [Стандарт доставки и надежности веб-хуков](https://www.broadnet.me/ru/reference/webhook-delivery-and-reliability)
