Esta documentação cobre todos os códigos de erro (101-106) que podem ocorrer durante a seleção de números do WhatsApp, com guias de solução de problemas passo a passo e estratégias de resolução.
Códigos de Erro e Tratamento
Erro 101: Nenhuma Instância Conectada
Este erro significa que não há instâncias de WhatsApp disponíveis para a localização. As mensagens não podem ser enviadas até que pelo menos uma instância esteja conectada.
{ "errorCode": "101", "message": "Error 101: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance for this location"}
[ERROR] Error 101: No connected WhatsApp instances found!
Vá para o seu painel de administração → Selecione a Localização
Verifique o status das instâncias da localização
Reconecte quaisquer instâncias desconectadas escaneando os códigos QR
Verifique se pelo menos uma instância mostra o status “Conectada”
Erro 102: A Instância da Substituição Manual Não Existe
Você está tentando usar uma instância de WhatsApp que não existe na configuração da sua localização.
{ "errorCode": "102", "message": "Error 102: Manual override specified {WA#5}, but that instance does not exists.", "resolution": "Use a valid instance index or remove the manual override pattern"}
{ WA#7 }”, mas a localização tem apenas as instâncias #1, #2 e #3 configuradas.
O que você verá no erro:
[ERROR] Error 102: Manual override specified {WA#7}, but that instance does not exists.
Verifique as instâncias disponíveis
Consulte o painel de administração para ver quais números de instância existem (ex.: 1, 2, 3)
Atualize a mensagem
Altere “{ WA#7 }” para uma instância válida, como “{ WA#2 }”
Remova a substituição
Exclua o padrão “{ WA#7 }” para usar a seleção automática
Crie a instância
Se necessário, crie a instância #7 no painel de administração
Erro 103: Instância da Substituição Manual Não Conectada
A instância de WhatsApp especificada existe, mas está desconectada no momento. Você precisa reconectá-la ou usar uma instância diferente.
{ "errorCode": "103", "message": "Error 103: Manual override specified {WA#2}, but the instance 2 is not connected!", "resolution": "Connect instance 2 or remove the manual override pattern"}
"Please call me back { WA#3 }", mas a instância de WhatsApp #3 está desconectada.
O que você verá no erro:
[ERROR] Error 103: Manual override specified {WA#3}, but the instance 3 is not connected!
Opção A
Conecte a instância #3 no painel de administração
Opção B
Edite a mensagem para remover o padrão “{ WA#3 }”
Opção C
Mude para uma instância conectada, como “{ WA#1 }”
O contato tem uma tag com um número de WhatsApp, mas a instância com esse número não está conectada.
{ "errorCode": "104", "message": "Error 104: Whatsapp number +15551234567 is not connected. Either connect the number or remove the tag 'wa: +15551234567' from the contact!", "resolution": "Connect the WhatsApp number or remove the tag from contact"}
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
Opção A
Reconecte a instância de WhatsApp com o número +15559876543
Opção B
Remova a tag wa: +15559876543 do contato John Doe
Opção C
Atualize a tag para usar um número conectado, como wa: +15551111111
Erro 105: Instância do Usuário Atribuído Não Conectada
O contato está atribuído a um usuário, mas a instância de WhatsApp desse usuário não está conectada.
{ "errorCode": "105", "message": "Error 105: Contact was assigned to John Doe (user123) but the Whatsapp Instance - 3 for that User was not connected!", "resolution": "Connect the assigned user's WhatsApp instance"}
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
Opção A
Peça para Sarah Williams reconectar a instância de WhatsApp #2 dela
Opção B
Reatribua o contato a um usuário com uma instância conectada
Opção C
Remova Sarah Williams da Atribuição de Instância para que qualquer outro número possa ser usado para contatos atribuídos a Sarah Williams no CRM
Erro 106: Nenhuma Instância Disponível
O sistema percorreu todos os níveis de prioridade, mas não conseguiu encontrar nenhuma instância de WhatsApp disponível para usar.
{ "errorCode": "106", "message": "Error 106: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"}
[ERROR] Error 106: No connected WhatsApp instances found!
Verifique a conectividade das instâncias
Confirme que as instâncias não estão todas desconectadas
Defina a instância padrão
Marque pelo menos uma instância conectada como “default: true”
Verifique os números de telefone
Garanta que as instâncias conectadas tenham números de telefone válidos
Guia de Solução de Problemas
A maioria dos problemas de mensagens do WhatsApp vem de instâncias desconectadas. Sempre verifique primeiro o status de conexão das suas instâncias!
Problemas Comuns
No connected WhatsApp instances found
- Verifique: Status de conexão das instâncias no painel de administração
- Correção: Reconecte as instâncias desconectadas
- Prevenção: Configure alertas por email para desconexões de instâncias (verifique a pasta de spam e marque como Importante se o email cair no spam)
Manual override instance not connected
- Verifique: Status da instância do índice especificado
- Correção: Conecte a instância ou remova a substituição manual
- Prevenção: Valide as substituições manuais antes de enviar
- Verifique: Status da instância atribuída ao usuário
- Correção: Reatribua o contato ou reconecte a instância
- Prevenção: Verificações regulares de integridade das instâncias
Estratégias de Prevenção de Erros
Monitoramento Proativo
Configure alertas para desconexões de instâncias
Teste os fluxos de trabalho regularmente para detectar problemas cedo
Melhores Práticas de Configuração
Sempre mantenha uma instância padrão para cada localização
Mantenha as tags de contato atualizadas quando as instâncias mudarem
Valide as substituições manuais antes de implementá-las em fluxos de trabalho
Documente sua estratégia de instâncias para referência da equipe
Documentação Relacionada
Para suporte adicional na solução de erros, entre em contato com nossa equipe pelo botão do WhatsApp abaixo.
Suporte
Se você precisar de ajuda com a configuração ou o onboarding:
