Changelog para programadores: API, webhooks, OAuth e MCP

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

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
• As respostas idempotentes repetidas incluem o cabeçalho Idempotent-Replayed: true. Idempotência

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
• Installed apps chama-se agora AI assistants, com uma coluna Last token. Rever e revogar aplicações instaladas

• 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
• 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
• Os Flows criados no Flowella podem enviar cada submissão para um dos seus endpoints de webhook, definido no separador Settings do Flow. Webhooks
• Registar uma aplicação de programador com um URI de redirecionamento inválido devolve um erro em linguagem simples. Registar uma aplicação

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
• 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
• 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

API

• As respostas de erro incluem um requestId dentro de error, que pode indicar ao suporte. Erros
• 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
• 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
• 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
• 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

• 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
• O primeiro servidor no documento OpenAPI é https://api.flowella.io, para que as coleções importadas chamem o URL base correto. Especificação OpenAPI
• 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
• Os valores de recurso das variáveis de modelos aplicam-se aos envios pela API. Valores de recurso
• O Developer hub inclui guias completos e uma coleção Postman. Developer hub

• 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

• 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
• 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

• A API REST v1 está documentada e disponível no anfitrião dedicado da API em /v1/.... API REST do Flowella