## Qué envía el webhook

Un webhook es una dirección de su lado a la que BulkGate informa de lo que ha ocurrido
con sus mensajes. El portal lo llama `Informes de entrega`, pero envía a él dos cosas a
la vez:

| Qué llega | Cómo reconocerlo |
|:--|:--|
| Informe de entrega | Un registro con el estado de un mensaje enviado y su `smsID` |
| SMS entrante (una respuesta) | Un registro con `status` `10`, el remitente en `from` y el texto del mensaje |

Por tanto, no se trata de dos ajustes separados: una sola dirección gestiona tanto los
informes de entrega como las respuestas.

El formato de los datos depende de si el envío masivo está activado:

| Modo | Cómo llegan los datos | Formato descrito en |
|:--|:--|:--|
| predeterminado | Una solicitud por mensaje, mediante GET | [Confirmación de entrega](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/api-confirmaciones-de-entrega-y-sms-entrantes/) |
| `DLRs a granel - solicitud a granel` | Un lote de registros, mediante POST con `application/json` | [Confirmación de entrega masiva](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/api-confirmaciones-de-entrega-masivas-y-mensajes-entrantes/) |

## Dónde se configura el webhook

El lugar depende de la interfaz que utilice. Los dos primeros pasos son iguales en
todos los casos: en el menú del portal, haga clic en `Módulos y APIs` y abra la tarjeta
de su aplicación en `Mis APIs y módulos`.

| Interfaz | Dónde en el detalle de la aplicación |
|:--|:--|
| HTTP API | La pestaña `Ajustes`, la parte `Web hooks`, la tarjeta `Informes de entrega` |
| `Email > SMS` | Solo `Informes de entrega de correo electrónico`: los informes llegan por correo electrónico, no a una URL |

## Cómo activar el webhook

La tarjeta muestra si hay algo configurado. Mientras no lo haya, muestra
`No tienes configuración.` y un botón `Configurar`.

![Parte Web hooks con la tarjeta Informes de entrega](docs:api-webhooks/webhooks_en)

El botón `Configurar` (o `Editar`, si ya tiene una configuración) abre la ventana
`Configuración de informes de entrega`.

![Ventana Configuración de informes de entrega con el campo Informes de entrega de URL](docs:api-webhooks/delivery-report_en)

Introduzca una dirección que empiece por `http://` o `https://` en el campo `Informes
de entrega de URL`; el portal no acepta otra forma de escribirla. Con él van tres
casillas:

| Opción | Qué hace |
|:--|:--|
| `Desactivar la verificación de disponibilidad de URL` | El portal no comprueba que la dirección responda antes de guardar |
| `Informe solo cuando se produce un error` | Solo llega un informe cuando un mensaje falla |
| `DLRs a granel - solicitud a granel` | Los informes llegan en lotes en lugar de uno a uno |

La configuración se guarda con el botón `Salvar`.

> [!TIP]
> El envío masivo es útil con volúmenes altos: en lugar de una solicitud por mensaje,
> llega una sola solicitud con un array de registros. El formato del lote se describe
> en [Confirmación de entrega masiva](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/api-confirmaciones-de-entrega-masivas-y-mensajes-entrantes/).

Una vez configurado el webhook, la tarjeta muestra tres filas: `URL` con la dirección
y un icono para `Informe solo cuando se produce un error` y otro para `DLRs a granel -
solicitud a granel`, que indican si están activados.

## Cómo eliminar el webhook

La flecha junto al botón `Editar` abre un menú con la opción `Borrar`. La ventana de
confirmación `Eliminar configuraciones` advierte de que perderá la configuración de
sus informes de entrega y de que dejarán de llegar.

> [!WARNING]
> Al eliminar el webhook también dejan de llegar los mensajes entrantes: las
> respuestas a sus SMS no tienen adónde entregarse.