O módulo foi renomeado de Formulários para Flows na v2.6.31. Os objetos de origem no HubSpot continuam a chamar-se formulários — a renomeação apenas afeta a entrada na barra lateral do Flowella, o cabeçalho da página e o URL. Os marcadores para
/{org}/forms continuam a funcionar: o Flowella emite um redirecionamento permanente 308 para /{org}/flows.Como abrir
Aceda a Flows na navegação à esquerda, ou:/{org}/{waba}/{phone}/flows. A lista é a mesma. O escopo do canal é usado quando sincroniza um Flow com a 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
updatedAtdo HubSpot para que possa saber quando a definição do formulário foi alterada. - Estado do WhatsApp Flow — sincronizado, rascunho ou obsoleto (o HubSpot foi alterado desde a última sincronização).
- Indicador de deriva — quando o formulário HubSpot foi editado desde a última construção do Flow, a linha mostra uma etiqueta âmbar Formulário HubSpot alterado desde que este Flow foi criado — sincronize novamente para o incorporar. Acione uma nova sincronização para o limpar.
- Criar WhatsApp Flow / Sincronizar WhatsApp Flow — a ação principal. A etiqueta muda para Sincronizar quando já existe um Flow e para Obsoleto — Necessária sincronização quando o formulário HubSpot foi editado desde a última sincronização.
Sincronização do catálogo em segundo plano
O Flowella mantém a lista Flows atualizada automaticamente, para que formulários HubSpot recém-adicionados ou renomeados apareçam sem que precise de clicar em nada:- Quando abre a página, o Flowella serve o catálogo em cache imediatamente e coloca em fila uma nova sincronização em segundo plano se o catálogo tiver mais de 5 minutos.
- A cada 20 minutos, uma varredura em segundo plano ressincroniza o catálogo para cada organização cuja integração HubSpot está CONECTADA, para que as listas permaneçam atuais mesmo para separadores que ninguém abriu.
- Enquanto uma sincronização em segundo plano está a correr, o cabeçalho mostra A atualizar… ao lado do ícone de atualização. Quando termina, a etiqueta muda para Última sincronização há 2 minutos (ou o equivalente relativo). A lista atualiza no lugar.
Detalhe do formulário
Clique numa linha para abrir a sua página de detalhe. O cabeçalho de detalhe mostra a mesma ação principal 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 detalhe pode:- Rever o mapeamento campo a campo entre o formulário HubSpot e o WhatsApp Flow.
- Ver execuções de sincronização anteriores — quando cada uma começou, o estado (em fila, a correr, bem-sucedida, falhada) e quaisquer erros que a Meta devolveu.
- Acionar uma nova sincronização, tentar de novo uma execução falhada ou cancelar uma sincronização ainda em curso.
- Abrir o Flow correspondente no Meta Business Suite.
- Verificar de que versão do formulário HubSpot foi construído o Flow publicado. Quando um Flow foi sincronizado, o cabeçalho mostra Flow construído a partir do formulário HubSpot em 12 set, 14:03. Compare-o com o valor atual Última modificação no HubSpot para decidir se precisa de ressincronizar.
Sincronizar um formulário para um WhatsApp Flow
Quando clica em Criar WhatsApp Flow ou Sincronizar WhatsApp Flow, o Flowella:- Executa uma verificação prévia — confirma que o HubSpot está ligado, o canal ativo está verificado, o formulário tem pelo menos um campo suportado e a faturação está ativa.
- Lê a definição mais recente do formulário do HubSpot.
- Gera o JSON do WhatsApp Flow equivalente.
- Faz upload para a Meta no canal que selecionou (com âmbito de canal).
- Regista a execução de sincronização na página de detalhe e carimba o timestamp Flow construído a partir do formulário HubSpot em para que a deriva possa ser detetada em edições posteriores.
Restrição por âmbito de canal
Os Flows são da organização em toda a lista mas com âmbito de canal quando sincroniza — um Flow tem de ser carregado contra uma combinação específica de WABA + número de telefone.
Se clicar em Sincronizar a partir do URL da organização e o Flowella não conseguir decidir que canal usar (sem canais ligados, múltiplos canais sem âmbito definido ou uma sessão obsoleta entre organizações), o botão permanece pré-desativado com uma dica a explicar o que falta. Mude para o canal correto a partir do seletor de canais, ou abra
/{org}/{waba}/{phone}/flows 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 de contorno para que possa corrigir a partir da mesma linha:
A linha também traz um selo de erro seguro para o utilizador:
FLOW_SYNC_PREFLIGHT+ erro Meta#133010(telefone não registado) — o selo mostra a mensagem Meta armazenada e uma dica de registo de telefone, não um “não pronto” genérico. Termine o registo do telefone em Definições → Meta e tente novamente.QUEUE_FAILED— a fila de sincronização não conseguiu recolher o trabalho. Normalmente transitório; tente novamente. Se persistir, a página de estado da plataforma é o próximo lugar a verificar (consulte Estado e incidentes).validation_errorsda Meta — o selo resume que campos a Meta rejeitou, para que possa ajustar o formulário HubSpot (ou o mapeamento de campo) e tentar novamente sem sair da linha.
Submissões de Flow anexam-se ao contacto HubSpot inscrito
Quando um WhatsApp Flow é enviado a partir de um fluxo de trabalho HubSpot, o Flowella passa agora o ID do contacto HubSpot inscrito através do Flow e inclui-o comohs_object_id quando a submissão é escrita de volta no HubSpot. Isto faz com que a submissão se anexe ao contacto exato que o HubSpot inscreveu — não a um registo semelhante — mesmo quando o número de telefone corresponde a vários contactos, e remove o último caso em que a pesquisa de telefone HubSpot poderia recair para o registo errado.
Se a sua organização já tem Flows publicados, ressincronize cada Flow uma vez para que o novo campo oculto seja incluído no JSON do Flow carregado para a Meta:
1
Abra a página Flows
Aceda a Flows e abra qualquer formulário cujo WhatsApp Flow tenha sido criado antes desta alteração.
2
Acione uma nova sincronização
Clique em Sincronizar WhatsApp Flow na linha (ou na ação principal na página de detalhe). O Flowella recarrega o JSON do Flow para a Meta com o campo oculto de ID do contacto.
3
Repita para cada formulário ativo
Apenas formulários enviados a partir de fluxos de trabalho HubSpot precisam disto. Formulários enviados fora de um contexto de fluxo de trabalho não são afetados.
Texto de pergunta em blocos de rich text
O HubSpot permite colocar um elemento de rich text acima de um grupo de campos para que o texto da pergunta fique acima da entrada em vez de dentro do rótulo do campo. O Flowella mapeia esses blocos para o WhatsApp Flow ao lado das entradas:
O rich text aparece antes das entradas no grupo de campos, para que os clientes vejam a pergunta e depois a respondam. Os rótulos dos campos continuam a ser mostrados na aplicação, portanto mantenha-os curtos — consulte Boas práticas de design de formulário.
Se já tem formulários HubSpot que usam rich text acima de grupos de campos, ressincronize-os a partir da página de detalhe do formulário. Execuções de sincronização mais antigas apenas captavam rótulos de campos, portanto o texto de pergunta em rich text estava em falta do Flow publicado até que sincronize novamente.
Formatação do ecrã de agradecimento
O mesmo mapeamento HTML → componente do Flow aplica-se agora ao texto de agradecimento de um formulário HubSpot. Cabeçalhos, texto a negrito, espaços não separáveis e listas com marcadores sobrevivem à sincronização em vez de serem reduzidos a texto simples, e o rodapé Concluído é preservado.
Cada marcador é renderizado como uma única linha, portanto marcação HubSpot bem formatada (um
<p> aninhado dentro de cada <li>) já não produz linhas de marcadores órfãs no WhatsApp. Cabeçalhos com mais de 80 caracteres continuam a recair para corpo de texto, o mesmo que noutras partes do Flow.
Se um formulário foi sincronizado antes desta alteração, o seu Flow ainda leva o texto de agradecimento em texto simples. Abra a página de detalhe do formulário e ressincronize para incorporar a nova formatação.
Dados de exemplo
Se ainda não tem uma ligação HubSpot, a página Flows renderiza com linhas ilustrativas por trás de um aviso “Dados de exemplo”. Ligue o HubSpot para passar para os seus formulários reais.Um formulário pode sincronizar-se perfeitamente e ainda assim ler-se mal num telemóvel. Rótulos de campo longos são encurtados no ecrã, sobretudo no iPhone, e o tipo de pergunta errado piora ainda mais. Consulte Boas práticas de design de formulário antes de construir um formulário.
Relacionado
Configuração HubSpot
Ligue o portal do qual o Flowella lê formulários.
Design de formulário
Construa formulários HubSpot que se renderizam limpo em qualquer dispositivo.
Ações de fluxo de trabalho
Acione Flows 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 HubSpot
Diagnostique problemas de sincronização de formulários e submissões em falta.
Multicanal
Os Flows são sincronizados por canal — compreenda o âmbito.
Segurança de dados
Como as submissões de formulários são cifradas em trânsito e em repouso.