Saltar al contenido principal
Un aviso es una dirección de tu sistema a la que Impulso le envía un POST cada vez que pasa algo. Créalo en el panel (Integraciones → Para desarrolladores → Nuevo aviso) o por la API (POST /webhooks). La respuesta trae el secret una sola vez: guárdalo para verificar la firma.

Eventos

Cómo llega

En los pedidos, data.order trae id, code, status, total, subtotal, delivery_fee, taxes, delivery, address, items (product_id, name, price, quantity…) y created_at, más contact y conversation. Cabeceras: X-Impulso-Event, X-Impulso-Delivery (el id de la entrega, el mismo en cada reintento: úsalo para no procesar dos veces) y X-Impulso-Signature.

Verificar la firma

X-Impulso-Signature: t=<unix>,v1=<hex> — HMAC-SHA256 con tu secret sobre "<t>.<cuerpo crudo>".
Verifica sobre el cuerpo crudo, tal como llegó (sin volver a convertir el JSON), y rechaza firmas de más de 5 minutos.

Reintentos

Responde 2xx en menos de 10 segundos. Si no, Impulso reintenta a 1 min, 5 min, 30 min, 2 h y 6 h; después la entrega queda fallida (se puede reenviar desde el panel). Tras 20 fallos seguidos el aviso se apaga solo; reactívalo con PATCH /webhooks/{id} (active: true). Con POST /webhooks/{id}/test envías un ping para probar. Solo se aceptan direcciones https públicas. Hasta 10 avisos por cuenta.