1. Verificar a ligação
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.
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
| Erro | O que fazer |
|---|---|
Channel not found | O fluxo de trabalho aponta para um canal que não existe mais. Edite a ação e escolha um canal atual. Consulte Multi-canal. |
O modelo referenciado mudou de status para REJECTED, PAUSED ou DISABLED. Consulte Template rejected. | |
Contact opted out | O contacto optou por sair deste canal. Honre o opt-out - não trabalhe em torno dele. |
Phone number invalid | O telefone do contacto não está em E.164. Consulte Formato do número de telefone. |
Subscription required | O seu plano Flowella não inclui esta ação ou a sua subscrição expirou. Consulte Faturação. |
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).
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

