Documentação
Acessar plataforma

Solução de Problemas

Problemas comuns e como resolver sem precisar abrir suporte.

QR Code desconectou / número offline

Sintomas

Causas comuns

Como resolver

1
Acesse Conexões no menu lateral
2
Clique no botão QR Code da conexão desconectada Um QR Code novo será gerado na tela.
3
No celular, abra o WhatsApp → Configurações → Aparelhos conectados → Conectar aparelho Escaneie o QR Code exibido na tela.
4
Aguarde o status ficar verde Leva alguns segundos. Se não conectar, atualize a página e tente novamente.
Evite desconexões frequentes Mantenha o celular sempre conectado ao Wi-Fi e carregado. Ative a opção "Nunca dormir" para a tela do WhatsApp nas configurações de bateria do celular. Isso reduz significativamente as desconexões.
Usando API Oficial? Conexões via WhatsApp API Oficial (WABA) não dependem de celular e não desconectam por esse motivo. Se sua conexão oficial estiver offline, verifique se o token e as credenciais na configuração da conexão ainda são válidos no Meta Business Manager.

Mensagens não estão sendo entregues

Verifique primeiro

  1. A conexão está com status verde (conectada)?
  2. O número do cliente tem WhatsApp ativo? Use a função Verificar número no contato.
  3. Você não está enviando para um número bloqueado ou que bloqueou você?

Causas e soluções

SituaçãoO que fazer
Conexão desconectada Reconecte via QR Code (veja seção acima)
Número não tem WhatsApp Verifique o número antes de enviar. Use apenas números com WhatsApp ativo.
Número com formato errado Use sempre o formato internacional: 55 + DDD + número. Ex: 5511999991234
Mensagem enviada mas não entregue (um check apenas) O celular do cliente pode estar sem internet. A mensagem será entregue quando ele conectar.
Número bloqueou sua conta Nada pode ser feito. O cliente bloqueou o número intencionalmente.

Número banido / limitado pelo WhatsApp

Sinais de que o número foi banido ou limitado

Causas mais comuns

O que fazer

  1. Acesse o WhatsApp no celular — se houver aviso de suspensão, siga as instruções para recurso dentro do próprio app
  2. Se for limitação temporária, aguarde 24–48h e tente novamente
  3. Ajuste os intervalos de campanha para evitar que aconteça de novo
  4. Se o ban for permanente, o número não pode ser recuperado — será necessário usar um novo número
Prevenção é melhor que remediação Configure intervalos entre mensagens em Configurações de Campanhas. Evite enviar para listas com números desconhecidos. Prefira contatos que já interagiram com você.

Flow Builder não está iniciando

Checklist de configuração

  1. O flow está marcado como Ativo (toggle verde no topo do FlowBuilder)?
  2. A conexão tem o Fluxo de boas-vindas configurado? Acesse Conexões → edite a conexão → aba Integrações → campo "Fluxo de boas-vindas".
  3. O contato já tem histórico de conversa? O fluxo de boas-vindas só dispara para contatos novos ou contatos sem ticket ativo.
  4. Existe um nó Início no flow conectado ao primeiro nó?
Fluxo de boas-vindas vs. Fluxo por frase
  • Fluxo de boas-vindas — dispara quando um contato novo manda a primeira mensagem
  • Fluxo por frase — dispara quando qualquer contato envia uma palavra específica
Os dois campos são independentes. Configure o que se aplica ao seu caso.

Variáveis do Flow Builder não estão sendo substituídas

Sintoma

A mensagem enviada mostra ${nomeDaVariavel} literalmente em vez do valor real.

Causas e soluções

CausaSolução
Nome da variável no nó Pergunta escrito com ${ e } No campo "Salvar resposta em", coloque apenas o nome simples. Ex: cpf, não ${cpf}
Caminho JSON errado no nó HTTP Request Verifique se a API retorna objeto {} ou array []. Para arrays use campo.0.subCampo, para objetos use campo.subCampo
Mapeamento de variável não salvo Reabra o nó HTTP Request, verifique se o mapeamento está preenchido e clique em Salvar
Sintaxe errada na mensagem Use ${nomeVariavel} (com cifrão e chaves). Não use {{nomeVariavel}} para variáveis do flow.

Ticket não está sendo criado

Verifique

  1. A conexão está conectada (status verde)?
  2. A conexão tem ao menos uma fila vinculada? Acesse Conexões → edite → aba Integrações → selecione as filas.
  3. O horário de atendimento está dentro do período configurado? Fora do horário, tickets podem não ser criados dependendo da configuração. Veja Horário de Atendimento.
  4. O contato não está em um ticket já aberto? Um contato não gera dois tickets simultâneos na mesma conexão.

Atendente não recebe os tickets da fila

Verifique

  1. O atendente está vinculado à fila? Acesse Filas → edite a fila → seção "Usuários vinculados à fila".
  2. O atendente está com status online na plataforma?
  3. O ticket foi assumido por outro atendente antes? Tickets assumidos não aparecem para os demais.
  4. O atendente tem o filtro de fila errado na tela de atendimentos? Verifique se está filtrando pela fila certa.

Campanha travada ou não disparando

Status da campanhaO que significaO que fazer
Programada Aguardando a data/hora configurada Aguarde ou cancele e recrie com novo horário
Em andamento mas sem progresso Possível travamento por conexão desconectada Verifique se a conexão está online. Cancele e reinicie a campanha.
Cancelada Foi interrompida manualmente ou por erro Crie uma nova campanha com os contatos restantes

Não consigo fazer login

Soluções por ordem

  1. Verifique se está usando o e-mail correto (sem espaços extras)
  2. Tente redefinir a senha pelo link "Esqueci minha senha" na tela de login
  3. Limpe o cache do navegador (Ctrl+Shift+Del) e tente novamente
  4. Tente em uma aba anônima ou em outro navegador
  5. Se a conta foi bloqueada por fatura em atraso, regularize o pagamento em Financeiro

Ainda com problema?

Se nenhuma das soluções acima resolveu, entre em contato com o suporte pelo WhatsApp (18) 99794-1144 informando: