> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Cambios para desarrolladores: API, webhooks, OAuth y MCP > Cambios en la API REST, los webhooks, las apps OAuth y el servidor MCP de Flowella, con los cambios incompatibles y qué actualizar en tu integración. Cambios que afectan a las integraciones creadas con la API REST de Flowella, los webhooks, las aplicaciones OAuth y el servidor MCP de Flowella, del más reciente al más antiguo. Las entradas con la etiqueta **Breaking** requieren un cambio por tu parte, y cada una indica qué debes actualizar. Para ver los cambios en la aplicación Flowella, consulta el [registro de cambios](https://knowledge.flowella.io/es/changelog.md). La versión actual de la API es `2026-08-11`. [Más información: Versionado](https://knowledge.flowella.io/es/api-reference/introduction.md#versioning) **6 de noviembre de 2026** v2.8.0 ## 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](https://knowledge.flowella.io/es/api-reference/webhooks.md#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](https://knowledge.flowella.io/es/api-reference/introduction.md#check-your-credentials) * Las respuestas idempotentes repetidas incluyen la cabecera `Idempotent-Replayed: true`. [Idempotencia](https://knowledge.flowella.io/es/api-reference/introduction.md#idempotency) ## 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](https://knowledge.flowella.io/es/settings/developer-apps.md) * **Installed apps** ahora se llama **AI assistants** y tiene una columna **Last token**. [Revisar y revocar aplicaciones instaladas](https://knowledge.flowella.io/es/settings/developer-apps.md#revisar-y-revocar-aplicaciones-instaladas) **2 de noviembre de 2026** v2.7.0 * **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](https://knowledge.flowella.io/es/settings/api-keys.md) * `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](https://knowledge.flowella.io/es/api-reference/introduction.md) * 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](https://knowledge.flowella.io/es/settings/webhooks.md) * 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](https://knowledge.flowella.io/es/settings/developer-apps.md#registrar-una-aplicación) **16 de octubre de 2026** v2.6.5 ## Cambios incompatibles * **`API-Version` solo acepta `2026-08-11`.** Cualquier otro valor devuelve `400`. Omite la cabecera o envía `2026-08-11`. [Versionado](https://knowledge.flowella.io/es/api-reference/introduction.md#versioning) * **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](https://knowledge.flowella.io/es/settings/webhooks.md#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](https://knowledge.flowella.io/es/settings/developer-apps.md) ## API * Las respuestas de error incluyen un `requestId` dentro de `error`, que puedes indicar al soporte. [Errores](https://knowledge.flowella.io/es/api-reference/introduction.md#errors) * 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](https://knowledge.flowella.io/es/api-reference/webhooks.md#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](https://knowledge.flowella.io/es/api-reference/webhooks.md#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](https://knowledge.flowella.io/es/api-reference/webhooks.md#deduplicar-eventos) * Los propietarios de la organización reciben una sola notificación cuando Flowella pausa un endpoint que falla. [Reintentos y espera progresiva](https://knowledge.flowella.io/es/settings/webhooks.md#reintentos-y-espera-progresiva) **13 de octubre de 2026** v2.6.0 * **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](https://knowledge.flowella.io/es/api-reference/introduction.md#base-url) * 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](https://knowledge.flowella.io/es/api-reference/introduction.md#openapi-spec) * 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](https://knowledge.flowella.io/es/app/template-reference.md#plantillas-de-carrusel) * Los valores de respaldo de las variables de plantilla se aplican a los envíos por API. [Valores de respaldo](https://knowledge.flowella.io/es/app/template-variables.md#fallback-values) * El **Developer hub** incluye guías completas y una colección de Postman. [Developer hub](https://knowledge.flowella.io/es/settings/developer-hub.md) **21 de septiembre de 2026** * 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](https://knowledge.flowella.io/es/api-reference/introduction.md#rate-limits) **26 de agosto de 2026** * **`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](https://knowledge.flowella.io/es/api-reference/introduction.md#bulk-template-sends) * **`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](https://knowledge.flowella.io/es/api-reference/introduction.md#idempotency) **2 de agosto de 2026** * La API REST v1 está documentada y se sirve en el host dedicado de la API en `/v1/...`. [API REST de Flowella](https://knowledge.flowella.io/es/api-reference/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.