Desarrolla sobre Flowella mediante programación.
Cuando las herramientas sin código no cubren alguna función, la API REST de Flowella y los webhooks de salida sí lo hacen. Llama a la API para enviar mensajes de WhatsApp, gestionar contactos y bajas, y obtener datos analíticos. Suscríbete a los webhooks para reaccionar en tiempo real ante mensajes, entregas, bajas y cambios en las plantillas, sin necesidad de realizar consultas periódicas.
Llámalo y deja que te devuelva la llamada.
Dos direcciones, un solo motor. Tu aplicación llama a la API REST para que las cosas sucedan: enviar una plantilla, actualizar un contacto, recuperar datos analíticos. En la otra dirección, Flowella envía eventos de webhook firmados a tu punto final en el momento en que ocurre algo, para que puedas reaccionar al instante en lugar de realizar consultas periódicas. Juntos te permiten crear todo lo que tu pila tecnológica necesite sobre la base del mismo motor de WhatsApp y HubSpot.
Enviar, gestionar y generar informes
Una API REST v1 sencilla con autenticación mediante clave de portador y un comportamiento predecible.
La API REST es la versión 1 y se encuentra en https://app.flowella.io/api/v1. Cada solicitud incluye una clave de acceso de tipo «bearer» válida para toda la organización en el encabezado «Authorization», creada desde «Configuración» > «Claves API» por un propietario o un administrador, y que solo se muestra una vez. Los puntos finales de lista utilizan paginación por cursor con un límite de uno a cien, los errores se devuelven en un formato coherente con un campo de código estable, y las solicitudes están limitadas por organización con un 429 cuando se realiza con demasiada rapidez. Los números de teléfono se transmiten mejor en formato E.164, y una especificación OpenAPI legible por máquina se integra directamente en Postman o en un generador de código.
Para envíos masivos de gran volumen, el punto final de envío de plantillas acepta un parámetro de limitación por hora, de modo que Flowella regula el ritmo de entrega del lado del servidor, en lugar de que seas tú quien regule las solicitudes.
Reaccionar ante los acontecimientos en tiempo real
Suscríbete a los eventos que te interesen y Flowella te enviará una notificación en cuanto se produzcan.
| Evento | Cuando se activa |
|---|---|
| message.received | Llega un mensaje entrante de WhatsApp de un contacto |
| message.sent | Flowella ha aceptado tu mensaje saliente y lo ha enviado a Meta |
| message.delivered | Meta ha confirmado la entrega en el dispositivo del destinatario |
| message.read | El destinatario ha abierto el mensaje |
| message.failed | Meta devolvió un error para el mensaje |
| conversación.abierta / cerrada | El estado de una conversación ha cambiado |
| optout.created | Un contacto se ha dado de baja de un canal |
| template.status_updated | Meta ha cambiado el estado de una plantilla |
Cada solicitud se firma con un resumen hexadecimal HMAC-SHA256 del cuerpo sin procesar, por lo que debes verificar la firma antes de procesarla. Flowella espera hasta diez segundos por un 2xx, reintenta hasta tres veces con retroceso y desactiva automáticamente un punto final tras diez fallos consecutivos. Dado que los reintentos pueden repetir un evento, utiliza el ID del evento como clave de idempotencia y trata los duplicados como operaciones nulas.
Primero sin código; código solo cuando lo necesites.
La API amplía las funciones del producto. No sustituye a las partes que ya funcionan sin necesidad de código.
Empieza por aquí para los trabajos comunes.
La mayor parte de lo que necesitan los equipos, enviar plantillas, capturar respuestas de Flow, activar la automatización, ya está cubierto sin tocar la API. Busca el código solo cuando necesites algo más.
- Form to Flow, sincronización nativa con HubSpot
- Acciones de flujo de trabajo y bandeja de entrada
- No hay que escribir código
Busca el código cuando necesites más.
Cuando necesite conectar WhatsApp a un sistema personalizado, sincronizarlo con una herramienta sin conector nativo o reaccionar a eventos en su propio backend, la API y los webhooks le ofrecen un control total.
- Aplicaciones personalizadas e integraciones a medida
- Reaccionar a eventos sin sondeo
- Envíos masivos con estrangulamiento en el servidor
- ⏱️ 30 seconds · Card on file
- 👤 With · Membership team
- 📩 Receipt sent here after renewal
Choose your plan
- 🏆 Annual · £49 ✓
- 🎯 Quarterly · £15 ✓
- 📅 Monthly · £6 ✓
Powered by Flowella · Secure renewal
Respuestas directas.
Las preguntas que se hacen los desarrolladores.
¿Cómo me autentifico?
Una clave de portador válida para toda la organización, creada desde «Configuración» > «Claves de API» por un propietario o un administrador. Solo se muestra una vez al crearla, así que guárdala en un lugar seguro y cámbiala cuando algún compañero de equipo deje la empresa.
¿Qué puede hacer la API?
Envía mensajes y plantillas de WhatsApp, gestiona contactos y bajas, crea listas y envía plantillas de forma masiva, y obtén datos analíticos. La lista completa de puntos de conexión se genera automáticamente a partir de la especificación OpenAPI.
¿Puedo hacer grandes envíos masivos?
Sí. Utiliza el punto final de envío de plantillas con un parámetro de limitación por hora y Flowella se encargará de controlar el ritmo del lado del servidor, por lo que no tendrás que gestionar tú mismo los límites de tiempo ni de frecuencia de solicitudes.
¿Cómo verifico que un webhook es auténtico?
Cada webhook se firma con un resumen HMAC-SHA256 del cuerpo de la solicitud sin procesar. Calcula el mismo resumen con tu clave de firma y compáralo, firmando los bytes sin procesar antes de realizar cualquier análisis de JSON.
¿Qué pasa si mi endpoint no funciona?
Flowella realiza hasta tres intentos con retrasos progresivos y desactiva automáticamente el punto final tras diez fallos consecutivos. Vuelve a activarlo en «Configuración», «Webhooks» una vez que hayas solucionado el problema del punto final.
¿Cómo evitar el tratamiento de duplicados?
Utiliza el identificador del evento como clave de idempotencia, mantén una caché de corta duración con las claves procesadas y trata las repeticiones como operaciones sin efecto. Los reintentos implican que el mismo evento puede llegar más de una vez.
Lee la documentación para desarrolladores
Todo el contenido de esta página, incluidas las referencias completas y los ejemplos de código, se encuentra en la documentación.
La referencia completa para desarrolladores se encuentra en la base de conocimientos.
La introducción a la API abarca la URL base, la autenticación, los errores, la paginación, los límites de frecuencia y la especificación OpenAPI.
La sección sobre webhooks salientes trata la configuración de un webhook, la lista completa de eventos, la verificación de firmas, los reintentos y la idempotencia, con ejemplos de código.
