Cambios para desarrolladores: API, webhooks, OAuth y MCP

Ciclo de vida de los Flows

• GET /v1/flows/{id} devuelve el estado del Flow en Meta (metaStatus), sus pantallas, sus campos y su acción de envío.
• POST /v1/flows/{id}/publish?dry_run=true comprueba un Flow sin publicarlo.
• POST /v1/flows/{id}/deprecate retira un Flow en Meta. Meta no permite deshacerlo. Flowella lo bloquea mientras haya plantillas que usen el Flow, salvo que envíes force.
• DELETE /v1/flows/{id} devuelve 409 HUBSPOT_FLOW_MANAGED para un Flow creado a partir de un formulario de HubSpot, y 409 FLOW_REFERENCED_BY_TEMPLATES mientras un borrador de plantilla siga usando el Flow. Eliminar un Flow nunca lo elimina en Meta: para retirarlo allí, retíralo primero con deprecate. Publicar un Flow retirado devuelve 409 FLOW_DEPRECATED.
• Cuando creas una plantilla, un botón de Flow puede apuntar a un Flow de Flowella con flowellaFlowId en lugar de un ID de Flow de Meta.
• Los Flows que creas a través de la API se publican con la pantalla de entrada MAIN_FORM. Los Flows que publicaste antes siguen funcionando. Vuelve a publicarlos antes de usarlos con flowellaFlowId.

Webhooks

• Nuevo evento flow.status_updated cuando cambia el estado de un Flow en Meta, por ejemplo cuando se retira. Suscríbete a él en Settings → Webhooks. Tipos de eventos

Credenciales

• GET /v1/ping devuelve cómo has iniciado sesión, tus scopes y, en el caso de las aplicaciones, el client ID. Comprobar tus credenciales
• Las respuestas idempotentes repetidas incluyen la cabecera Idempotent-Replayed: true. Idempotencia

Servidor MCP

• Los asistentes de IA pueden conectarse al servidor MCP de Flowella iniciando sesión, sin una clave de API. El usuario elige una organización y selecciona Allow access en la pantalla de consentimiento de Flowella. Las conexiones de miembros que no son Owner ni Admin son de solo lectura. Aplicaciones de desarrollador
• Installed apps ahora se llama AI assistants y tiene una columna Last token. Revisar y revocar aplicaciones instaladas

• Servidor MCP de Flowella. Los asistentes de IA compatibles con el Model Context Protocol pueden leer tus canales, plantillas y Flows. El servidor es de solo lectura y usa una clave de API de la organización. Claves de API
• GET /v1/flows/{id} acepta el ID de formulario de Flowella. Editar el esquema de un Flow creado a partir de un formulario de HubSpot devuelve 409: haz el cambio en HubSpot y vuelve a sincronizar. API REST de Flowella
• Los Flows creados en Flowella pueden enviar cada respuesta a uno de tus endpoints de webhook, configurado en la pestaña Settings del Flow. Webhooks
• Registrar una aplicación de desarrollador con un URI de redirección no válido devuelve un error en lenguaje sencillo. Registrar una aplicación

Cambios incompatibles

• API-Version solo acepta 2026-08-11. Cualquier otro valor devuelve 400. Omite la cabecera o envía 2026-08-11. Versionado
• Los endpoints de webhook necesitan una URL HTTPS pública. No se aceptan direcciones privadas, de loopback ni de metadatos de la nube. Comprueba cada endpoint antes de actualizar. Añadir un endpoint de webhook
• Aplicaciones OAuth. Revisa estos requisitos antes de actualizar una aplicación creada con OAuth de Flowella:
  • Las solicitudes sin scope obtienen acceso de solo lectura, y los scopes desconocidos se rechazan.
  • Los endpoints de token, introspección y revocación requieren autenticación del cliente.
  • La solicitud de autorización requiere state.
  • Las concesiones de credenciales de cliente no devuelven un token de actualización.
  • Revocar un token revoca solo la familia de ese token.
  Aplicaciones de desarrollador

API

• Las respuestas de error incluyen un requestId dentro de error, que puedes indicar al soporte. Errores
• Crear un contacto devuelve 201 y actualizarlo devuelve 200. Un externalId duplicado devuelve 409, y un contacto eliminado devuelve 404.

Webhooks

• Nuevos eventos contact.created, contact.updated y contact.deleted. Tipos de eventos
• Da un nombre a cada endpoint con Name (optional). El nombre aparece encima de la URL en la lista.
• Durante las 24 horas siguientes a la rotación de un secreto de firma, Flowella también firma cada entrega con el secreto anterior y la envía en X-Flowella-Signature-Previous, para que puedas cambiar de secreto sin perder eventos. Rotar un secreto de firma
• Un evento reenviado conserva su ID de evento y su marca de tiempo originales. Los registros de entrega de la API incluyen el ID de correlación, las cabeceras de respuesta y la hora del siguiente reintento. Deduplicar eventos
• Los propietarios de la organización reciben una sola notificación cuando Flowella pausa un endpoint que falla. Reintentos y espera progresiva

• Usa https://api.flowella.io. Las solicitudes a https://api.flowella.io/v1/... devuelven JSON. Las URL antiguas https://app.flowella.io/api/v1/..., incluido el documento OpenAPI, redirigen de forma permanente al host de la API. Actualiza tu URL base para no depender de la redirección. URL base
• El primer servidor del documento OpenAPI es https://api.flowella.io, para que las colecciones importadas llamen a la URL base correcta. Especificación OpenAPI
• La API rechaza los componentes de plantilla no válidos, y las plantillas que superan los límites de envío a revisión de Meta, antes de que lleguen a Meta.
• Puedes crear y enviar plantillas de carrusel a través de la API. Si no pasas contenido multimedia para una tarjeta, Flowella usa la muestra aprobada de esa tarjeta. Plantillas de carrusel
• Los valores de respaldo de las variables de plantilla se aplican a los envíos por API. Valores de respaldo
• El Developer hub incluye guías completas y una colección de Postman. Developer hub

• Los envíos repetidos de la misma plantilla a través de la API salen más rápido.
• Cuando Meta limita una llamada de gestión de plantillas, Flowella lo notifica como un límite de velocidad, para que tus reintentos esperen correctamente. Límites de velocidad

• POST /v1/templates/send devuelve 202. Flowella acepta la solicitud, devuelve un ID de trabajo de inmediato y entrega los mensajes en segundo plano, reintentando los errores temporales de WhatsApp. Si tu integración comprueba una respuesta 200, actualízala para que espere 202 con "status": "accepted". Sigue la entrega en la pestaña Statistics de la plantilla. Envíos masivos de plantillas
• Idempotency-Key. Envía una cabecera Idempotency-Key con POST /v1/templates/send y Flowella reconoce las repeticiones de la misma solicitud durante siete días, devolviendo el ID de trabajo original en lugar de volver a enviar. Idempotencia

• La API REST v1 está documentada y se sirve en el host dedicado de la API en /v1/.... API REST de Flowella