Skip to main content
A maioria dos problemas do HubSpot enquadra-se num destes três grupos: a integração está desligada, um mapeamento de campo está errado ou uma ação de fluxo de trabalho está mal configurada. Esta página analisa-os por ordem. Para a configuração inicial, consulte HubSpot setup. Para acções de fluxo de trabalho, consulte Acções de fluxo de trabalho.

1. Verificar a ligação

1

Abrir Definições → HubSpot

A partir da aplicação Flowella, aceda a Configurações → HubSpot.
2

Ler o distintivo de estado

Um emblema verde Ligado significa que o token OAuth é válido. Uma faixa vermelha Reconectar significa que o token foi revogado ou expirou.
3

Voltar a ligar, se necessário

Clique em Reconectar e execute novamente o HubSpot OAuth. Em seguida, tente novamente a ação que falhou.
Causas comuns para o mau funcionamento de uma ligação HubSpot:
  • O utilizador HubSpot que autorizou o Flowella foi removido do portal.
  • O HubSpot rodou o token porque não tinha sido utilizado recentemente.
  • Um Super Admin desactivou a integração do Flowella nas definições da aplicação do HubSpot.

2. Os envios de formulários não aparecem no HubSpot

Se um contacto completar um WhatsApp Flow mas não conseguir ver a submissão no HubSpot:

Incompatibilidade no mapeamento de campos

O fluxo pode incluir um campo que não é mapeado para uma propriedade HubSpot de um tipo compatível. Abra o formulário na página Forms e reveja o mapeamento de cada campo.

O campo obrigatório está vazio

Se um campo do formulário HubSpot estiver marcado como obrigatório e o WhatsApp Flow permitir que o utilizador o ignore, a submissão será rejeitada pelo HubSpot. Tornar o campo opcional no HubSpot, ou obrigatório no Fluxo.

Formato do número de telefone

O HubSpot é rigoroso quanto ao formato do número de telefone. Ver Phone number format - a maior parte dos problemas de “contacto em falta” resumem-se ao formato E.164 vs. nacional.

A pesquisa ocorre após a execução da ação do fluxo de trabalho

Se o seu fluxo de trabalho HubSpot for executado imediatamente após a submissão do formulário, as condições de corrida podem fazer com que o fluxo de trabalho seja disparado antes de o Flowella ter terminado de escrever o contacto. Adicione um pequeno atraso (1-2 minutos) no início do fluxo de trabalho, ou dispare a alteração da propriedade do contacto em vez da submissão do formulário.

3. Acções de fluxo de trabalho paradas ou a falhar

Se um fluxo de trabalho HubSpot que inclui uma ação Flowella estiver bloqueado:

Abrir o histórico de acções do fluxo de trabalho

No HubSpot, localize o contacto, desloque-se para Histórico do fluxo de trabalho e clique na execução que falhou. O HubSpot mostra a resposta que o Flowella devolveu para cada ação.

Respostas de erro comuns

A ação existe mas não faz nada

Se o fluxo de trabalho for executado sem erros, mas não chegar nenhuma mensagem, verifique novamente:
  • A ação está activada (não está em pausa).
  • O destinatário está inscrito no fluxo de trabalho no passo correto.
  • Os critérios de inscrição do HubSpot ainda correspondem ao contacto.

4. Confusão na direção da sincronização

A sincronização do Flowella é bidirecional mas parcial:
  • Envios WhatsApp Flow → escrevem propriedades de contacto para o HubSpot.
  • As acções de fluxo de trabalho do HubSpot → enviam mensagens e modelos do WhatsApp.
  • Respostas de entrada do WhatsApp → registar na linha de tempo do contacto (não actualiza automaticamente as propriedades).
Se esperava que uma resposta WhatsApp de forma livre actualizasse uma propriedade, é necessário um passo extra da sua parte - um fluxo de trabalho HubSpot que observe o evento de conversação e analise a resposta, ou uma integração personalizada através da API.

Ainda está preso?

Capture o seguinte antes de contactar o suporte:
  • O carimbo de data e hora da última sincronização de Configurações → HubSpot
  • A mensagem de erro exacta (ou captura de ecrã) devolvida pelo Flowella ou HubSpot
  • O ID do contacto e o ID do fluxo de trabalho afectados
Última modificação em 4 de julho de 2026