Saltar para o conteúdo principal
A maioria dos problemas entre o Flowella e o HubSpot enquadra-se em três grupos: a ligação, as respostas dos Flows que chegam ao HubSpot e as ações de workflow que falham. Avance para a secção que corresponde ao que vê. Para a configuração, consulte Ligar o HubSpot. Para saber o que faz cada ação, consulte Ações de workflow do HubSpot.

​
Verificar a ligação

1

Abra as definições do HubSpot

No Flowella, aceda a Settings → HubSpot. O cartão Connection mostra Connected ou Not connected, com o seu Portal (Hub) ID. O estado do HubSpot na barra superior da aplicação mostra o mesmo estado.
2

Ligue novamente se indicar Not connected

Um owner ou admin seleciona Connect HubSpot e aprova as permissões no HubSpot. O Flowella também mostra Not connected quando o HubSpot deixa de aceitar o acesso do Flowella, por exemplo depois de alguém desinstalar a aplicação no HubSpot. Enquanto o HubSpot não estiver ligado, o Flowella envia um lembrete HubSpot connection: “Reconnect or review HubSpot so CRM sync keeps working.”
3

Verifique as capacidades se uma funcionalidade não funcionar

Se o cartão indicar Connected mas uma funcionalidade não funcionar, consulte o cartão Capabilities. As funcionalidades em Not available precisam de permissões que o HubSpot não concedeu. Para obter novas permissões, desligue e volte a ligar: não existe um botão de religação separado. Consulte Religar para desbloquear novas capacidades.
Enquanto o HubSpot estiver desligado, as ações de workflow não conseguem enviar, nenhuma atividade chega ao HubSpot e o canal Flowella na caixa de entrada do HubSpot deixa de funcionar. Se utiliza o canal personalizado, volte a ligá-lo depois de religar o HubSpot.
Para erros apresentados durante a ligação, consulte a resolução de problemas de Ligar o HubSpot.

​
Respostas de Flows em falta no HubSpot

Quando um contacto submete um WhatsApp Flow, o Flowella submete as respostas ao formulário HubSpot a partir do qual o Flow foi criado. Primeiro, verifique se a submissão chegou. Consulte Verificar se uma submissão chegou.
O Flow permanece aberto e mostra o erro, para que o contacto possa tentar novamente.
  • “Missing required field:” seguido do rótulo de um campo significa que o formulário HubSpot tem um campo obrigatório que o Flow não recolhe, por exemplo um que adicionou depois da última sincronização. Selecione Sync WA Flow na página Flows ou torne o campo opcional no HubSpot.
  • “Could not submit to HubSpot. Try again.” significa que o HubSpot não aceitou a submissão. Verifique a ligação, conforme descrito acima.
Consulte Erros que o cliente vê.
O HubSpot associa uma submissão de formulário a um contacto através do endereço de e-mail. Quando o Flowella faz corresponder a submissão a um contacto HubSpot, adiciona o e-mail desse contacto. Se nem o Flow nem o contacto correspondente tiverem endereço de e-mail, o HubSpot lista a submissão sem contacto.Adicione um campo de e-mail ao formulário HubSpot e selecione Sync WA Flow. Ou certifique-se de que os seus contactos têm endereço de e-mail no HubSpot.
O Flowella associa a submissão ao primeiro contacto que encontrar, por esta ordem:
  1. O contacto inscrito no workflow
  2. O contacto já associado ao número WhatsApp
  3. Um contacto com o mesmo número de telefone
  4. Um contacto com o mesmo endereço de e-mail
Se nenhum corresponder, o Flowella cria um contacto.Guarde os números de telefone em formato internacional sem espaços, como +447700900123, para que o Flowella consiga encontrar contactos pelo telefone. Consulte Formato do número de telefone.
O Flowella não tem um mapeamento de campos para editar. Cria o Flow a partir dos campos do formulário HubSpot, e o HubSpot guarda cada resposta na propriedade que o campo do formulário utiliza. Se um campo é obrigatório ou não também é definido pelo HubSpot.Para alterar o que o Flow recolhe, edite o formulário no HubSpot e selecione Sync WA Flow. Os campos que o WhatsApp não consegue mostrar ficam fora do Flow. Consulte Como os campos HubSpot são convertidos.
Aguarde o evento Form Completed e filtre-o por Form name. Form Completed só é disparado quando alguém submete um WhatsApp Flow, nunca para uma submissão de formulário do site. Consulte Form Completed.

​
Ações de workflow que falham

​
Ler a falha no HubSpot

Abra o workflow no HubSpot e encontre o contacto no histórico de inscrições. Um passo Send WhatsApp Template, Send WhatsApp Message ou Send WhatsApp Reply falhado mostra a mensagem de erro do Flowella. O resultado Error code da ação contém um código curto, e o workflow continua com o passo seguinte. Consulte Resultados das ações de envio. Um passo de envio termina quando o WhatsApp comunica pela primeira vez um estado para a mensagem, normalmente sent. Se o WhatsApp comunicar uma falha depois disso, o passo continua a mostrar sucesso. Para ver o que aconteceu a seguir, abra a conversa na Inbox do Flowella.

​
Códigos de falha das ações de envio

Todos os códigos, com o respetivo significado, estão listados em Códigos de erro. Utilize esta tabela para decidir onde procurar primeiro.

​
Envio de modelo suprimido como duplicado

Se um passo Send WhatsApp Template falhar com DUPLICATE_TEMPLATE_SEND_SUPPRESSED, o Flowella ignorou o envio de propósito. O mesmo modelo, no mesmo idioma, foi enviado para o mesmo número de telefone a partir do mesmo número WhatsApp menos de 15 segundos antes. Esse número de telefone recebeu o modelo uma vez. A causa habitual são dois contactos HubSpot que partilham um número de telefone, como um registo pessoal e um profissional, a inscreverem-se no mesmo workflow ao mesmo tempo. O passo falha de imediato, pelo que o contacto passa para o passo seguinte sem esperar. No Send log do modelo, a repetição aparece como Suppressed, com “Duplicate send suppressed within 15 seconds.” Para o distinguir de uma falha real:
  • Suprimido como duplicado: o código é exatamente DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Não é necessária nenhuma ação.
  • Uma falha real: qualquer outro código. Consulte Códigos de falha das ações de envio.
Para enviar o mesmo modelo para o mesmo número duas vezes de propósito, deixe mais de 15 segundos entre os envios ou utilize um modelo diferente.

​
O passo continua à espera

Se um passo Send WhatsApp Template permanecer em curso, o WhatsApp pode ter pausado ou desativado o modelo. O Flowella retém o envio e envia-o quando o WhatsApp restaurar o modelo. Verifique a etiqueta do modelo na página Templates. Consulte Etiquetas de saúde de entrega.

​
O passo foi bem-sucedido, mas não chegou nada

Encontre a mensagem na Inbox do Flowella. Send WhatsApp Message e Send WhatsApp Reply enviam sempre a partir do seu número WhatsApp predefinido. Se a mensagem mostrar Failed, leia o motivo por baixo e consulte Mensagens não entregues.

​
O que o Flowella escreve no HubSpot

O Flowella adiciona estes elementos ao HubSpot, consoante as capacidades da sua ligação:
  • Respostas de Flows, como uma submissão do formulário HubSpot a partir do qual o Flow foi criado.
  • Atividade na cronologia do contacto: mensagem enviada, mensagem lida, resposta recebida e formulário concluído.
  • As propriedades de contacto Last WhatsApp reply message e Last WhatsApp reply at.
  • Novos contactos para pessoas que lhe enviam mensagens e ainda não estão no HubSpot.
  • Conversas na caixa de entrada do HubSpot, através do canal personalizado do Flowella.
O Flowella não escreve opt-outs nem estados de mensagens em propriedades de contacto. Para agir com base no que um contacto respondeu, crie uma ramificação com base em Last WhatsApp reply message. Consulte Atividade do contacto e O que o Flowella adiciona ao HubSpot.

​
Continua com problemas?

Contacte o suporte do Flowella com:
  • A mensagem de erro e o Error code do histórico de inscrições do workflow
  • O ID do registo do contacto HubSpot e o nome do workflow
  • A data e a hora do passo falhado
  • O seu Portal (Hub) ID em Settings → HubSpot

​
Relacionado

Ligar o HubSpot

Ligação, capacidades e religação.

Ações de workflow do HubSpot

O que faz cada ação, os seus resultados e todos os códigos de erro.

Códigos de erro do WhatsApp

O que significam os códigos do WhatsApp e como os corrigir.

Flows

Sincronize formulários HubSpot com WhatsApp Flows e verifique as submissões.
Última modificação em 24 de outubro de 2026