> ## 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. # Changelog para programadores: API, webhooks, OAuth e MCP > Alterações à API REST, aos webhooks, às apps OAuth e ao servidor MCP do Flowella, com as alterações incompatíveis assinaladas e o que deve atualizar. Alterações que afetam integrações criadas com a API REST do Flowella, os webhooks, as apps OAuth e o servidor MCP do Flowella, das mais recentes para as mais antigas. As entradas com a etiqueta **Breaking** exigem uma alteração do seu lado, e cada uma indica o que deve atualizar. Para alterações à aplicação Flowella, consulte o [changelog](https://knowledge.flowella.io/pt/changelog.md). A versão atual da API é `2026-08-11`. [Saiba mais: Versionamento](https://knowledge.flowella.io/pt/api-reference/introduction.md#versioning) **6 de novembro de 2026** v2.8.0 ## Ciclo de vida dos Flows * `GET /v1/flows/{id}` devolve o estado do Flow na Meta (`metaStatus`), os seus ecrãs, campos e ação de submissão. * `POST /v1/flows/{id}/publish?dry_run=true` verifica um Flow sem o publicar. * `POST /v1/flows/{id}/deprecate` retira um Flow na Meta. A Meta não consegue anular esta ação. O Flowella bloqueia-a enquanto houver modelos a usar o Flow, a menos que envie `force`. * `DELETE /v1/flows/{id}` devolve `409` `HUBSPOT_FLOW_MANAGED` para um Flow criado a partir de um formulário HubSpot, e `409` `FLOW_REFERENCED_BY_TEMPLATES` enquanto um rascunho de modelo ainda usar o Flow. Eliminar um Flow nunca o elimina na Meta: descontinue-o primeiro para o retirar lá. Publicar um Flow descontinuado devolve `409` `FLOW_DEPRECATED`. * Quando cria um modelo, um botão de Flow pode apontar para um Flow do Flowella com `flowellaFlowId` em vez de um ID de Flow da Meta. * Os Flows que cria através da API são publicados com o ecrã de entrada `MAIN_FORM`. Os Flows que publicou antes continuam a funcionar. Volte a publicá-los antes de os usar com `flowellaFlowId`. ## Webhooks * Novo evento `flow.status_updated` quando o estado de um Flow muda na Meta, por exemplo quando é descontinuado. Subscreva-o em **Settings** → **Webhooks**. [Tipos de eventos](https://knowledge.flowella.io/pt/api-reference/webhooks.md#tipos-de-eventos) ## Credenciais * `GET /v1/ping` indica como tem sessão iniciada, os seus âmbitos e, para aplicações, o ID de cliente. [Verificar as suas credenciais](https://knowledge.flowella.io/pt/api-reference/introduction.md#check-your-credentials) * As respostas idempotentes repetidas incluem o cabeçalho `Idempotent-Replayed: true`. [Idempotência](https://knowledge.flowella.io/pt/api-reference/introduction.md#idempotency) ## Servidor MCP * Os assistentes de IA podem ligar-se ao servidor MCP do Flowella iniciando sessão, sem chave de API. O utilizador escolhe uma organização e seleciona **Allow access** no ecrã de consentimento do Flowella. As ligações de membros que não são Owner ou Admin são só de leitura. [Aplicações de programador](https://knowledge.flowella.io/pt/settings/developer-apps.md) * **Installed apps** chama-se agora **AI assistants**, com uma coluna **Last token**. [Rever e revogar aplicações instaladas](https://knowledge.flowella.io/pt/settings/developer-apps.md#rever-e-revogar-aplicações-instaladas) **2 de novembro de 2026** v2.7.0 * **Servidor MCP do Flowella.** Os assistentes de IA compatíveis com o Model Context Protocol podem ler os seus canais, modelos e Flows. O servidor é só de leitura e usa uma chave de API da organização. [Chaves de API](https://knowledge.flowella.io/pt/settings/api-keys.md) * `GET /v1/flows/{id}` aceita o ID de formulário do Flowella. Editar o esquema de um Flow criado a partir de um formulário HubSpot devolve `409`: faça a alteração no HubSpot e volte a sincronizar. [API REST do Flowella](https://knowledge.flowella.io/pt/api-reference/introduction.md) * Os Flows criados no Flowella podem enviar cada submissão para um dos seus endpoints de webhook, definido no separador **Settings** do Flow. [Webhooks](https://knowledge.flowella.io/pt/settings/webhooks.md) * Registar uma aplicação de programador com um URI de redirecionamento inválido devolve um erro em linguagem simples. [Registar uma aplicação](https://knowledge.flowella.io/pt/settings/developer-apps.md#registar-uma-aplicação) **16 de outubro de 2026** v2.6.5 ## Alterações incompatíveis * **`API-Version` aceita apenas `2026-08-11`.** Qualquer outro valor devolve `400`. Omita o cabeçalho ou envie `2026-08-11`. [Versionamento](https://knowledge.flowella.io/pt/api-reference/introduction.md#versioning) * **Os endpoints de webhook precisam de um URL HTTPS público.** Endereços privados, de loopback e de metadados da cloud não são aceites. Verifique todos os endpoints antes de atualizar. [Adicionar um endpoint de webhook](https://knowledge.flowella.io/pt/settings/webhooks.md#adicionar-um-endpoint-de-webhook) * **Apps OAuth.** Reveja estes requisitos antes de atualizar uma aplicação criada com o OAuth do Flowella: * Os pedidos sem âmbito recebem acesso só de leitura, e os âmbitos desconhecidos são rejeitados. * Os endpoints de token, introspeção e revogação exigem autenticação do cliente. * O pedido de autorização exige `state`. * As concessões client credentials não devolvem um refresh token. * Revogar um token revoga apenas a família desse token. [Aplicações de programador](https://knowledge.flowella.io/pt/settings/developer-apps.md) ## API * As respostas de erro incluem um `requestId` dentro de `error`, que pode indicar ao suporte. [Erros](https://knowledge.flowella.io/pt/api-reference/introduction.md#errors) * Criar um contacto devolve `201` e atualizar um devolve `200`. Um `externalId` duplicado devolve `409`, e um contacto eliminado devolve `404`. ## Webhooks * Novos eventos `contact.created`, `contact.updated` e `contact.deleted`. [Tipos de eventos](https://knowledge.flowella.io/pt/api-reference/webhooks.md#tipos-de-eventos) * Dê um nome a cada endpoint com **Name (optional)**. O nome aparece acima do URL na lista. * Durante as 24 horas seguintes à rotação de um segredo de assinatura, o Flowella assina também cada entrega com o segredo antigo e envia-a em `X-Flowella-Signature-Previous`, para que possa trocar de segredo sem perder eventos. [Rodar um segredo de assinatura](https://knowledge.flowella.io/pt/api-reference/webhooks.md#rodar-um-segredo-de-assinatura) * Um evento reenviado mantém o ID e a data e hora originais. Os registos de entrega da API incluem o ID de correlação, os cabeçalhos da resposta e a hora da próxima tentativa. [Eliminar eventos duplicados](https://knowledge.flowella.io/pt/api-reference/webhooks.md#eliminar-eventos-duplicados) * Os proprietários da organização recebem uma única notificação quando o Flowella pausa um endpoint que está a falhar. [Novas tentativas e intervalo entre tentativas](https://knowledge.flowella.io/pt/settings/webhooks.md#novas-tentativas-e-intervalo-entre-tentativas) **13 de outubro de 2026** v2.6.0 * **Use `https://api.flowella.io`.** Os pedidos para `https://api.flowella.io/v1/...` devolvem JSON. Os URLs antigos `https://app.flowella.io/api/v1/...`, incluindo o documento OpenAPI, redirecionam permanentemente para o anfitrião da API. Atualize o seu URL base para não depender do redirecionamento. [URL base](https://knowledge.flowella.io/pt/api-reference/introduction.md#base-url) * O primeiro servidor no documento OpenAPI é `https://api.flowella.io`, para que as coleções importadas chamem o URL base correto. [Especificação OpenAPI](https://knowledge.flowella.io/pt/api-reference/introduction.md#openapi-spec) * A API rejeita componentes de modelo inválidos, e modelos acima dos limites de submissão da Meta, antes de chegarem à Meta. * Pode criar e enviar modelos de carrossel através da API. Se não passar multimédia para um cartão, o Flowella usa a amostra aprovada desse cartão. [Modelos de carrossel](https://knowledge.flowella.io/pt/app/template-reference.md#modelos-de-carrossel) * Os valores de recurso das variáveis de modelos aplicam-se aos envios pela API. [Valores de recurso](https://knowledge.flowella.io/pt/app/template-variables.md#fallback-values) * O **Developer hub** inclui guias completos e uma coleção Postman. [Developer hub](https://knowledge.flowella.io/pt/settings/developer-hub.md) **21 de setembro de 2026** * Os envios repetidos do mesmo modelo através da API saem mais depressa. * Quando a Meta limita uma chamada de gestão de modelos, o Flowella comunica-o como limite de taxa, para que as suas novas tentativas recuem corretamente. [Limites de taxa](https://knowledge.flowella.io/pt/api-reference/introduction.md#rate-limits) **26 de agosto de 2026** * **`POST /v1/templates/send` devolve `202`.** O Flowella aceita o pedido, devolve de imediato um ID de tarefa e entrega as mensagens em segundo plano, tentando de novo após erros temporários do WhatsApp. Se a sua integração verifica uma resposta `200`, atualize-a para esperar `202` com `"status": "accepted"`. Acompanhe a entrega no separador **Statistics** do modelo. [Envios de modelos em massa](https://knowledge.flowella.io/pt/api-reference/introduction.md#bulk-template-sends) * **`Idempotency-Key`.** Envie um cabeçalho `Idempotency-Key` com `POST /v1/templates/send` e o Flowella reconhece repetições do mesmo pedido durante sete dias, devolvendo o ID de tarefa original em vez de enviar de novo. [Idempotência](https://knowledge.flowella.io/pt/api-reference/introduction.md#idempotency) **2 de agosto de 2026** * A API REST v1 está documentada e disponível no anfitrião dedicado da API em `/v1/...`. [API REST do Flowella](https://knowledge.flowella.io/pt/api-reference/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.