Para desarrolladores

API de WhatsApp Business y CRM

Conectá tu ERP, tu tienda online o Zapier con FlujosChat: enviá WhatsApp y plantillas, sincronizá conversaciones y datos de clientes, y recibí eventos en tiempo real por webhook. REST, autenticación por API key y especificación OpenAPI.

Empezar OpenAPI

Tu primer request

Creá una API key en Configuración → API Keys y comprobá que funciona:

curl https://www.flujoschat.foo/api/public/v1/me \
  -H "Authorization: Bearer fjc_live_xxxxxxxxxxxx"

Elegí tu lenguaje una vez: el resto de la documentación te muestra los ejemplos en ese lenguaje.

Qué podés hacer

Enviar WhatsApp

Texto libre dentro de la ventana de 24 h, o una plantilla aprobada para escribir primero.

Sincronizar tu CRM

Conversaciones, historial y campos personalizados, con sincronización incremental por updatedAfter.

Recibir eventos

Webhooks firmados con HMAC-SHA256 y reintentos con backoff. Sin polling.

OpenAPI 3.1

Importala en Postman, generá un cliente o pasásela a tu asistente de IA.

Documentación

Primeros pasos

API de WhatsApp y CRM: primeros pasos

Qué puede hacer la API y tu primer request en 2 minutos.

4′

Autenticación con API key y permisos (scopes)

API keys, la tabla de scopes y cómo pedir el permiso mínimo.

5′

Errores, cuotas, rate limits e idempotencia

Todos los error.code, los límites por plan y cómo reintentar sin duplicar.

6′

Referencia

Conversaciones: leer, paginar y sincronizar tu CRM

Listar, paginar por cursor, sincronizar cambios y actualizar el estado.

7′

Enviar mensajes de WhatsApp por API

Texto libre, plantillas para escribir primero, y la ventana de 24 h de Meta.

7′

Plantillas de WhatsApp: listar y usar sus variables

Descubrir tus plantillas aprobadas y qué espera cada variable.

4′

Campos personalizados: sincronizar la ficha del cliente

Leer y escribir DNI, RUC, dirección y lo que tengas definido.

5′

Eventos

Webhooks: recibir eventos de WhatsApp en tiempo real

Eventos firmados con HMAC, con reintentos: dejá de hacer polling.

9′

Herramientas

OpenAPI, Postman y clientes generados

La spec OpenAPI 3.1, Postman, clientes generados y uso con IA.

4′

Antes de empezar

La ventana de 24 horas de Meta

Solo podés mandar texto libre a alguien que te escribió en las últimas 24 horas. Fuera de esa ventana se usa una plantilla aprobada. No es una limitación de FlujosChat: es cómo funciona la WhatsApp Business API.

La API es un entitlement del plan: los planes iniciales no la incluyen. Los límites por minuto y por mes también vienen del plan.
La key identifica a tu empresa y se envía solo servidor a servidor. Nunca en el navegador ni en una app móvil.
Todo listado pagina por cursor y los envíos aceptan Idempotency-Key: reintentar no duplica.

Autenticación y permisos Webhooks