Saltar para o conteúdo principal
Neste tutorial transforma um formulário de marketing do HubSpot num WhatsApp Flow, envia-o para o seu próprio telemóvel e depois envia-o a partir de um workflow do HubSpot. No final, um Flow concluído aparece no HubSpot como uma submissão do formulário original. Demora cerca de 50 minutos de trabalho efetivo, com base nas estimativas do guia de configuração do Flowella, mais até 24 horas enquanto a Meta revê o seu modelo.

Antes de começar

  • Leia Antes de começar e tenha os seus acessos à Meta e ao HubSpot prontos.
  • A verificação empresarial da Meta tem de estar concluída antes de poder criar um Flow na etapa 3. Consulte Verificação empresarial.
  • Tenha o seu próprio telemóvel com WhatsApp, num número pessoal e não no número empresarial que vai ligar.
  • Escolha ou crie um formulário de marketing curto no HubSpot para testes. Inclua um campo de email: o HubSpot usa o endereço de email para associar uma submissão de formulário a um contacto.
  • A etapa 6 requer workflows do HubSpot, incluídos nos planos Professional e Enterprise do HubSpot. Sem eles, termina na etapa 5.
Se o WhatsApp e o HubSpot já estiverem ligados, avance para a etapa 3.

Como as peças se encaixam

O diagrama mostra a ordem pela qual um Flow é criado, aprovado, enviado e devolvido ao HubSpot.

Etapa 1: ligar o WhatsApp e o HubSpot

Cerca de 16 minutos.
1

Dê um nome à sua organização

Quando inicia sessão pela primeira vez, o Flowella pede-lhe Name your organisation. Introduza o nome e selecione Continue. Não pode ligar o WhatsApp até a organização ter um nome.
2

Ligue o WhatsApp

Aceda a Settings → WhatsApp (Meta) e selecione Connect WhatsApp. No fluxo de registo da Meta, escolha ou crie a sua Conta WhatsApp Business (WABA), a conta na Meta que contém os seus números e modelos, e depois verifique o seu número de telefone.
3

Ligue o HubSpot

Aceda a Settings → HubSpot e selecione Connect HubSpot. Escolha a sua conta HubSpot e aprove a ligação no HubSpot.
Verifique que funcionou: no topo da aplicação, os indicadores de estado WhatsApp e HubSpot mostram ambos Connected. Num ecrã pequeno, verifique Settings → WhatsApp (Meta), onde o seu número aparece em Connected WhatsApp numbers, e Settings → HubSpot, que mostra Connected. Para mais detalhes sobre cada passo, consulte Configurar o Flowella.

Etapa 2: enviar a sua primeira mensagem

Cerca de 2 minutos.
  1. A partir do seu telemóvel, envie qualquer mensagem WhatsApp para o seu número empresarial. Isto abre a janela de 24 horas, a janela de serviço ao cliente da Meta, durante a qual pode responder sem um modelo.
  2. No Flowella, abra Inbox e selecione a nova conversa.
  3. Escreva uma resposta em Type a message… e prima Enter.
Verifique que funcionou: a resposta chega ao seu telemóvel. Consulte Caixa de entrada para saber mais sobre conversas.

Etapa 3: criar o Flow

Cerca de 15 minutos.
  1. No HubSpot, crie ou escolha o seu formulário de marketing de teste. O Flowella converte campos de texto de uma linha, texto de várias linhas, email, telefone, número, lista pendente, botões de opção, caixas de verificação e data, e transforma campos de ficheiro num seletor de fotografias. Deixa de fora os campos que não consegue converter, e um campo obrigatório que não consegue converter impede a sincronização.
  2. No Flowella, abra Flows. O Flowella atualiza a lista de formulários HubSpot quando abre a página. Se o seu formulário não aparecer, selecione o botão de atualização no topo da página.
  3. Encontre o seu formulário e selecione Create WA Flow na coluna WhatsApp Flow. O botão mostra Syncing… enquanto o Flowella cria o Flow e o publica na sua WABA.
Verifique que funcionou: a linha mostra Created, ou Updated se a sua WABA já tinha um Flow com o mesmo nome, e o botão muda para Sync WA Flow. Selecione Open in Meta para pré-visualizar o Flow. O Flow tem um ecrã com as perguntas do seu formulário, com o nome do formulário como título, seguido de um ecrã de agradecimento. O Flowella não tem um editor de Flows: para alterar as perguntas mais tarde, edite o formulário no HubSpot e depois selecione Sync WA Flow. Consulte Flows e Boas práticas de design de formulários.

Etapa 4: adicionar o Flow a um modelo

Cerca de 5 minutos, mais a revisão da Meta. Os contactos abrem um Flow a partir de um botão Flow numa mensagem de modelo, por isso o Flow precisa de um modelo. Use qualquer uma das opções e depois submeta o modelo.

Opção A: começar na página Flows

Após a primeira sincronização bem-sucedida da sua organização, o Flowella mostra Your form is now a WhatsApp Flow. Selecione Create template with this Flow. Se não vir a caixa de diálogo, selecione Create template na linha do formulário. O editor de modelos abre-se com um botão Flow já ligado ao seu Flow. O texto do botão é Continue, que pode alterar. Escreva a mensagem, escolha uma Category e introduza um Template name com letras minúsculas, números e underscores.

Opção B: começar pelo modelo inicial do Flowella

  1. Em Templates, selecione New template e depois View starters em Flowella Templates.
  2. Encontre flowella_start_flow e selecione Use this starter. A mensagem diz Hi {{1}}, tap below to complete a short form and we will get back to you. e o botão Flow diz Open form.
  3. No campo WhatsApp Flow do botão, escolha o seu Flow. Os Flows aparecem listados com o nome do formulário HubSpot de onde provêm.
  4. Em Body variables, altere o Fallback value de {{1}} de Alex para algo que funcione para qualquer pessoa, como there. O Flowella envia-o quando um contacto não tem primeiro nome.
O modelo inicial usa a categoria Marketing. Escolha a categoria adequada à sua mensagem antes de submeter. Consulte Preços e categorias de mensagens do WhatsApp.

Submeter o modelo à Meta

  1. Selecione Save draft.
  2. Selecione Publish Template, verifique a categoria e depois selecione novamente Publish Template para o submeter à Meta. Se a mensagem tiver variáveis como {{1}}, atribua primeiro um Fallback value a cada uma. A Meta revê-o como exemplo da variável. Consulte Variáveis de modelos.
  3. Aguarde que o estado mude de Pending para Approved. A Meta indica que uma decisão pode demorar até 24 horas.
Verifique que funcionou: o estado do modelo é Approved. Se a Meta o rejeitar, consulte Modelo rejeitado.

Etapa 5: testar o Flow no seu telemóvel

Cerca de 3 minutos.
  1. Abra o seu modelo aprovado e vá ao separador Send.
  2. Em Test Template, escolha o seu Country, introduza o seu WhatsApp Number e preencha as variáveis do modelo.
  3. Selecione Send Test.
  4. No seu telemóvel, abra a mensagem e toque no botão Flow. Preencha o formulário com o seu próprio endereço de email e submeta-o.
Verifique que funcionou:
  • O WhatsApp mostra o ecrã de agradecimento com a mensagem de agradecimento do seu formulário HubSpot.
  • Na Inbox do Flowella, a conversa mostra um cartão com as suas respostas, marcado como Response sent. O título do cartão é o texto do botão Flow, ou Flow response.
  • No HubSpot, o formulário tem uma nova submissão a partir de uma página com o nome do formulário, por exemplo WhatsApp Flow · Contact us. O HubSpot atualiza as propriedades do contacto mapeadas pelo formulário.
  • A cronologia do contacto mostra um evento Form Completed com uma ligação View submission.
O Flowella submete as respostas ao formulário HubSpot original. A submissão e as propriedades do contacto aparecem no HubSpot tal como apareceriam para um formulário preenchido no seu website.
Este teste também assinala Send a Flow from HubSpot no guia de configuração, porque esse passo conta qualquer Flow concluído.

Etapa 6: enviar o Flow a partir de um workflow do HubSpot

Cerca de 10 minutos.
Esta etapa requer ações de workflow do HubSpot, que precisam de um plano HubSpot com workflows (Professional ou Enterprise). No Flowella, abra Settings → HubSpot e verifique se Custom workflow actions está em Unlocked. Se não estiver, terminou na etapa 5: envie Flows a partir do Flowella com um envio de teste ou um envio em massa.
1

Prepare um contacto de teste

No HubSpot, use um contacto com o seu próprio número WhatsApp em formato internacional, como +447700900123, e o seu endereço de email. A mensagem que enviou na etapa 2 pode já ter criado ou associado um contacto ao seu número. Consulte Formato do número de telefone.
2

Crie um workflow baseado em contactos

As ações do Flowella só funcionam com contactos. Defina um acionador de inscrição que, por agora, apenas o seu contacto de teste cumpra, como um valor de propriedade ou uma lista.
3

Adicione Send WhatsApp Template

Adicione a ação Send WhatsApp Template do Flowella. Em Template Name, escolha o seu modelo com Flow. Só os modelos aprovados aparecem na lista. Em Contact Phone Number, selecione a propriedade do contacto que contém o número WhatsApp. Se o seu modelo tiver uma variável, mapeie uma propriedade como o primeiro nome para Template Variable 1. Consulte Send WhatsApp Template.
4

Aguarde pelo Flow

Adicione um passo Delay until event no evento Form Completed do Flowella. Filtre-o por Form Name para que corresponda ao nome do seu formulário HubSpot e defina quanto tempo esperar, por exemplo um dia.
5

Decida o que acontece a seguir

Para os contactos que concluem o Flow, crie ramificações com base nas propriedades do contacto que o formulário preencheu, ou crie uma tarefa. O evento Form Completed regista o nome e a origem do formulário, não as respostas. Para os contactos que não o concluem a tempo, envie um modelo de lembrete ou crie uma tarefa.
6

Ative o workflow

Ative o workflow e inscreva o seu contacto de teste.
Verifique que funcionou:
  • O modelo chega ao seu telemóvel e o histórico de workflows do contacto mostra a ação Send WhatsApp Template como concluída. O Flowella conclui a ação quando o WhatsApp comunica o primeiro estado da mensagem, normalmente enviada.
  • Depois de concluir o Flow, o contacto avança do passo Delay until event e a submissão aparece no formulário HubSpot tal como na etapa 5.
  • No guia de configuração, Send a template from HubSpot está assinalado.
Form Completed só é acionado quando alguém submete um WhatsApp Flow através do Flowella, nunca para submissões do mesmo formulário no website. Para workflows completos baseados neste padrão, consulte os guias de workflows.

Resolução de problemas

Passe o cursor sobre o botão para ver o motivo. A mensagem mais comum é “Meta business verification is required before publishing flows.” O botão também fica indisponível quando o WhatsApp não está ligado, quando o formulário não tem campos suportados pelos WhatsApp Flows ou quando o seu plano não permite a sincronização. Consulte Flows e Problemas de integração.
A linha mostra uma etiqueta como Not ready. Passe o cursor sobre o ícone de informação ao lado para ver o motivo. Se um campo obrigatório do HubSpot não puder ser recolhido num WhatsApp Flow, torne o campo opcional ou altere o seu tipo no HubSpot e depois selecione Try again. Consulte Flows.
Selecione o botão de atualização no topo de Flows. Só aparecem formulários de marketing do HubSpot. Se a página mostrar Sample forms, o Flowella ainda não consegue ler os seus formulários HubSpot: verifique a ligação em Settings → HubSpot. Consulte Flows.
Só aparecem modelos com o estado Approved. Aguarde pela decisão da Meta e depois volte a abrir a ação. Consulte Ações de workflow do HubSpot.
“Missing required field” normalmente significa que foi adicionado um campo obrigatório ao formulário HubSpot depois da última sincronização. Selecione Sync WA Flow na página Flows e depois envie novamente o Flow. “Could not submit to HubSpot. Try again.” significa que o HubSpot não aceitou a submissão: tente novamente e verifique se Settings → HubSpot mostra Connected.
O HubSpot associa submissões de formulários a contactos através do endereço de email. Adicione um campo de email ao formulário ou certifique-se de que o contacto tem um endereço de email no HubSpot.
Abra o histórico de workflows do contacto para ver o motivo indicado pelo Flowella. Um número em falta ou mal formatado falha com CONTACT_PHONE_MISSING ou CONTACT_PHONE_INVALID. Consulte Formato do número de telefone e Ações de workflow do HubSpot.

Relacionado

Flows

Estado de sincronização, conversão de campos e limites dos WhatsApp Flows.

Modelos

Crie, teste e submeta modelos WhatsApp.

Ações de workflow do HubSpot

Todas as ações e eventos do Flowella disponíveis nos workflows do HubSpot.

Guias de workflows

Receitas de workflows do HubSpot prontas a usar com Flows.
Última modificação em 24 de outubro de 2026