Skip to main content
Flowella forms synced from HubSpot
A página Formulários mostra todos os formulários HubSpot que o Flowella está a seguir para a sua organização, o WhatsApp Flow que o Flowella construiu a partir de cada um deles e se esse Fluxo está em sincronia com o Meta. Para saber como configurar a integração do HubSpot em primeiro lugar, consulte Configuração do HubSpot. Esta página abrange o ecrã Formulários da aplicação, não a configuração da integração.

​
Como abrir

Aceda a Formulários na navegação à esquerda, ou:
Também é possível abrir Formulários com escopo para um canal específico no /{org}/{waba}/{phone}/forms. A lista é a mesma - o escopo do canal é usado quando você sincroniza um Fluxo com o Meta.

​
O que a lista mostra

Cada linha representa um formulário HubSpot. As colunas incluem:
  • Nome do formulário e um ID de formulário HubSpot truncado com um botão de cópia com um clique.
  • Contagem de campos** - quantos campos o formulário tem, com um sinalizador se algum não for suportado.
  • Última modificação no HubSpot** - extraído do próprio HubSpot do updatedAt para que possa saber quando a definição do formulário foi alterada.
  • Catalog updated - quando o Flowella actualizou pela última vez a definição do formulário a partir do HubSpot.
  • Status do WhatsApp Flow** - sincronizado, rascunho ou obsoleto (o HubSpot foi alterado desde a última sincronização).
  • Criar WhatsApp Flow / Sincronizar WhatsApp Flow - a ação principal. A etiqueta muda para Sync quando um Fluxo já existe e para Stale - Sync needed quando o formulário HubSpot foi editado desde a última sincronização.
O botão é pré-desativado com uma dica de ferramenta quando não pode ser executado - por exemplo: HubSpot não ligado, nenhum canal WhatsApp ativo, faturação inativa, ou o formulário contém tipos de campos não suportados. A dica de ferramenta explica exatamente qual o pré-requisito em falta. Se a sua conta HubSpot ainda não tiver formulários sincronizados, o Flowella bootstraps o catálogo automaticamente na primeira visita, para que não tenha de ativar um pull inicial. Pode filtrar e pesquisar a lista para encontrar rapidamente um formulário específico.

​
Detalhe do formulário

Clique numa linha para abrir a respectiva página de detalhes. O cabeçalho de detalhe mostra a mesma ação primária Criar / Sincronizar WhatsApp Flow que a linha da lista, para que não tenha de voltar atrás para fazer alterações. A partir da página de detalhes, é possível:
  • Rever o mapeamento campo a campo entre o formulário HubSpot e o WhatsApp Flow.
  • Ver as execuções de sincronização anteriores - quando cada uma foi iniciada, o estado (em fila de espera, em execução, bem sucedida, falhada) e quaisquer erros devolvidos pelo Meta.
  • Acione uma nova sincronização, repetir uma execução com falha ou cancelar uma sincronização que ainda está em andamento.
  • Abrir o Fluxo correspondente no Meta Business Suite.

​
Sincronizando um formulário para um WhatsApp Flow

Ao clicar em Criar WhatsApp Flow ou Sincronizar WhatsApp Flow, o Flowella:
  1. Executa uma verificação prévia - confirma que o HubSpot está ligado, o canal ativo é verificado, o formulário tem pelo menos um campo suportado e a faturação está ativa.
  2. Lê a definição de formulário mais recente do HubSpot.
  3. Gera o JSON equivalente do WhatsApp Flow.
  4. Carrega-o para o Meta no canal que selecionou (channel-scoped).
  5. Regista a execução de sincronização na página de detalhes.
A maioria das sincronizações demora alguns segundos. Se o Meta rejeitar o Fluxo, o motivo da falha aparece na linha de execução como uma mensagem de erro segura para o utilizador (traduzida do Gráfico do Meta) - normalmente devido a um tipo de campo não suportado, a um problema de verificação no canal ou a uma incompatibilidade de categoria. Tente novamente a partir da mesma linha quando tiver corrigido a causa.

​
Gating por escopo de canal

Os formulários são abrangentes à organização na lista, mas têm escopo de canal quando sincroniza — um Fluxo tem de ser carregado para uma combinação específica de WABA + número de telefone. Se clicar em Sincronizar a partir do URL abrangente à organização e o Flowella não conseguir decidir que canal utilizar (nenhum canal ligado, vários canais sem escopo definido ou uma sessão entre organizações desactualizada), o botão permanece pré-desativado com uma dica de ferramenta a explicar o que falta. Mude para o canal correto a partir do alternador de canais, ou abra /{org}/{waba}/{phone}/forms diretamente.

​
UX de erros de sincronização

Quando uma sincronização falha, o Flowella transforma a linha da execução num único botão de ação delineado para que possa corrigir avançando a partir da mesma linha: A linha também transporta um emblema de erro seguro para o utilizador:
  • FLOW_SYNC_PREFLIGHT + erro Meta #133010 (telefone não registado) — o emblema mostra a mensagem armazenada do Meta e uma sugestão de registo do telefone, e não um genérico “não pronto”. Conclua o registo do telefone em Definições → Meta e tente novamente.
  • QUEUE_FAILED — a fila de sincronização não conseguiu pegar no trabalho. Normalmente transitório; tente novamente. Se persistir, a página de estado da plataforma é o próximo local a verificar (consulte Estado e incidentes).
  • validation_errors do Meta — o emblema resume que campos o Meta rejeitou, para que possa ajustar o formulário HubSpot (ou o mapeamento de campos) e tentar novamente sem sair da linha.
O histórico de execuções é preservado entre as tentativas, para que possa ver quantas tentativas um formulário levou e o que mudou entre elas.

​
Dados de amostra

Se ainda não tiver uma ligação ao HubSpot, a página Formulários é apresentada com linhas ilustrativas por detrás de um texto explicativo “Dados de amostra”. Ligue o HubSpot para mudar para os seus formulários reais.
Os formulários HubSpot com tipos de campo não suportados (carregamento de ficheiros, assinatura) não podem ser sincronizados tal como estão. Ajuste o formulário no HubSpot ou ignore esses campos no WhatsApp Flow.

​
Relacionado

Configuração do HubSpot

Ligar o portal a partir do qual o Flowella lê os formulários.

Acções de fluxo de trabalho

Desencadear fluxos a partir de um fluxo de trabalho HubSpot.

Guias de fluxo de trabalho

Receitas de ponta a ponta que combinam formulários, modelos e fluxos de trabalho.

Falhas de sincronização do HubSpot

Diagnosticar problemas de sincronização de formulários e envios em falta.

Multicanal

Os formulários são sincronizados por canal - entenda o escopo.

Segurança dos dados

Como os envios de formulários são encriptados em trânsito e em repouso.
Última modificação em 5 de julho de 2026