> ## 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. # Enviar o seu primeiro WhatsApp Flow a partir de um formulário HubSpot > Transforme um formulário HubSpot num WhatsApp Flow, adicione-o a um modelo, teste-o no seu telemóvel e depois envie-o a partir de um workflow do HubSpot para que as respostas cheguem ao HubSpot. 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](https://knowledge.flowella.io/pt/before-you-start.md) 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](https://knowledge.flowella.io/pt/meta/business-verification.md). * 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. ```mermaid theme={null} sequenceDiagram actor M as Profissional de marketing participant HS as HubSpot participant F as Flowella participant WA as WhatsApp actor C as Cliente M->>HS: Cria o formulário de marketing HS-->>F: O formulário aparece na página Flows M->>F: Create WA Flow F->>HS: Lê o formulário F->>WA: Cria ou atualiza o Flow e depois publica M->>F: Create template with this Flow F->>WA: Submete o modelo para aprovação HS->>F: O workflow executa Send WhatsApp Template F->>C: Mensagem de modelo com botão Flow C->>WA: Abre o Flow e submete WA->>F: Respostas F->>HS: Submissão do formulário no contacto correspondente F-->>C: Ecrã de agradecimento, ou um erro a corrigir F->>HS: O evento Form Completed inicia workflows de seguimento ``` ## 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](https://knowledge.flowella.io/pt/onboarding.md). ## 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](https://knowledge.flowella.io/pt/app/inbox.md) 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](https://knowledge.flowella.io/pt/app/flows.md) e [Boas práticas de design de formulários](https://knowledge.flowella.io/pt/app/form-design-best-practices.md). ## 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](https://knowledge.flowella.io/pt/account/pricing-and-conversation-categories.md). ### 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](https://knowledge.flowella.io/pt/app/template-variables.md#valores-de-recurso). 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](https://knowledge.flowella.io/pt/troubleshooting/template-rejected.md). ## 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. > [!NOTE] > > 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. > [!NOTE] > > 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](https://knowledge.flowella.io/pt/app/bulk-send.md). **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](https://knowledge.flowella.io/pt/hubspot/phone-number-format.md). **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](https://knowledge.flowella.io/pt/hubspot/workflow-actions.md#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](https://knowledge.flowella.io/pt/hubspot/workflows/overview.md). ## Resolução de problemas > **Create WA Flow está a cinzento** > > 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](https://knowledge.flowella.io/pt/app/flows.md) e [Problemas de integração](https://knowledge.flowella.io/pt/troubleshooting/onboarding.md). > **A sincronização falha** > > 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](https://knowledge.flowella.io/pt/app/flows.md). > **O meu formulário não está na página 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](https://knowledge.flowella.io/pt/app/flows.md). > **O modelo não está na lista da ação do HubSpot** > > 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](https://knowledge.flowella.io/pt/hubspot/workflow-actions.md). > **O Flow mostra um erro quando o submeto** > > "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**. > **A submissão não está associada a um contacto** > > 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. > **A ação Send WhatsApp Template falha** > > 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](https://knowledge.flowella.io/pt/hubspot/phone-number-format.md) e [Ações de workflow do HubSpot](https://knowledge.flowella.io/pt/hubspot/workflow-actions.md). ## Relacionado > **[Flows](https://knowledge.flowella.io/pt/app/flows.md)** > > Estado de sincronização, conversão de campos e limites dos WhatsApp Flows. > **[Modelos](https://knowledge.flowella.io/pt/app/templates.md)** > > Crie, teste e submeta modelos WhatsApp. > **[Ações de workflow do HubSpot](https://knowledge.flowella.io/pt/hubspot/workflow-actions.md)** > > Todas as ações e eventos do Flowella disponíveis nos workflows do HubSpot. > **[Guias de workflows](https://knowledge.flowella.io/pt/hubspot/workflows/overview.md)** > > Receitas de workflows do HubSpot prontas a usar com Flows. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.