Introducción

Conecta WhatsApp oficial con tu CRM, agente de IA o automatización usando un solo webhook.

En esta página
Contrato público Flujo Mapa de documentación

Contrato público v1

Nahui Connect enlaza WhatsApp oficial con cualquier CRM, agente de IA o automatización mediante webhooks seguros. El canal público operativo es whatsapp. Instagram y Messenger están únicamente como Próximamente.

URL base: https://api.nahui.studio. Connect transporta eventos; no ejecuta la IA del cliente y no almacena el contenido ni el historial de mensajes.

Flujo de extremo a extremo

Un contacto escribe por WhatsApp. Meta entrega el mensaje a Nahui; Nahui normaliza el evento y lo envía firmado al webhook configurado. Tu backend valida, deduplica y procesa. Puedes responder en el mismo webhook o después con /reply.

Flujo

Cliente → Meta WhatsApp → Nahui Connect → Tu webhook / CRM / IA → Nahui Connect → Meta → Cliente

Las respuestas públicas se dirigen exclusivamente por conversationId. El número real del destinatario nunca se entrega al CRM.

Mapa de documentación

Inicio rápidoConfigura una conexión y recibe tu primer evento.Webhook entranteEncabezados, cuerpo, timeout y respuesta inmediata.Verificación de firmaHMAC SHA-256 sobre el cuerpo crudo.Responder mensajesPOST /reply, autenticación e idempotencia.Enviar plantillasPlantillas aprobadas y límite por conexión.Eventos y mensajesTexto, botones, interactivos, medios y desconocidos.Errores y límitesEstados HTTP, consumo y reintentos.SeguridadCredenciales, SSRF, logs y checklist.EjemplosNode.js, Cloudflare Workers, Python y cURL.Guía para crear un CRMArquitectura, persistencia y operación.OpenAPIDescarga la especificación pública sin modificar.