Documentación

WhatsApp: eventos que recibe Kipu

Kipu recibe mensajes y estado de sesión desde el conector de WhatsApp. Eso no es el aviso de salida que registrás en Desarrollador.

Qué hay hoy

En Configuración → WhatsApp Ventas conectás el chat. El conector (OpenWA) pega a Kipu en /api/webhooks/openwa/{companyId} con firma HMAC. Kipu guarda el inbox y puede armar un borrador de factura.

Ese endpoint es de Kipu (inbound), no un URL tuyo. Los avisos de salida (ventas cobradas / stock) se configuran aparte en Configuración → Desarrollador → Avisos a tu servidor: ahí registrás tu URL HTTPS y Kipu pega firmado a tu sistema.

Firma

Kipu valida HMAC del cuerpo contra el secret del comercio. Requests sin firma válida se rechazan con 401.

Eventos que entran

Mensajes del chat elegido (texto) y avisos de sesión desconectada para reconectar el QR desde el dashboard.

Integrar tu propio sistema

Consultá productos, stock y facturas con /api/partner/v1: clave kipu_live_ en Configuración → Desarrollador, o token kipu_tok_ si conectaste una app en Integraciones. Para que Kipu te avise ventas o stock sin polllear, usá Avisos a tu servidor. Documentación: /docs/api-reference.

Ayuda: support@kipuapp.store.