> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros de Seleção de Números

<Info>
  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.
</Info>

## Códigos de Erro e Tratamento

### Erro 101: Nenhuma Instância Conectada

<Warning>
  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.
</Warning>

**Causa**: Não há instâncias de WhatsApp conectadas para a localização

Resposta de Erro

```text theme={null}
{  "errorCode": "101",  "message": "Error 101: No connected WhatsApp instances found!",  "resolution": "Connect at least one WhatsApp instance for this location"}
```

**Cenário de Exemplo**: Uma localização tem 3 instâncias de WhatsApp configuradas, mas todas estão desconectadas devido à expiração do código QR ou a problemas de rede.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 101: No connected WhatsApp instances found!
```

**Como corrigir**:

<Info>
  <Steps>
    <Step>
      Vá para o seu painel de administração → Selecione a Localização
    </Step>

    <Step>
      Verifique o status das instâncias da localização
    </Step>

    <Step>
      Reconecte quaisquer instâncias desconectadas escaneando os códigos QR
    </Step>

    <Step>
      Verifique se pelo menos uma instância mostra o status "Conectada"
    </Step>
  </Steps>
</Info>

### Erro 102: A Instância da Substituição Manual Não Existe

<Warning>
  Você está tentando usar uma instância de WhatsApp que não existe na configuração da sua localização.
</Warning>

**Causa**: A substituição manual especifica um índice de instância inexistente

Resposta de Erro

```text theme={null}
{  "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"}
```

**Cenário de Exemplo**: O usuário envia a mensagem "Use this number `{ WA#7 }`", mas a localização tem apenas as instâncias #1, #2 e #3 configuradas.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 102: Manual override specified {WA#7}, but that instance does not exists.
```

**Como corrigir**:

<Info>
  <Steps>
    <Step title="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)
    </Step>

    <Step title="Atualize a mensagem">
      Altere "`{ WA#7 }`" para uma instância válida, como "`{ WA#2 }`"
    </Step>

    <Step title="Remova a substituição">
      Exclua o padrão "`{ WA#7 }`" para usar a seleção automática
    </Step>

    <Step title="Crie a instância">
      Se necessário, crie a instância #7 no painel de administração
    </Step>
  </Steps>
</Info>

### Erro 103: Instância da Substituição Manual Não Conectada

<Warning>
  A instância de WhatsApp especificada existe, mas está desconectada no momento. Você precisa reconectá-la ou usar uma instância diferente.
</Warning>

**Causa**: A substituição manual especifica uma instância que não está conectada

Resposta de Erro

```text theme={null}
{  "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"}
```

**Cenário de Exemplo**: O usuário envia a mensagem `"Please call me back &#123; WA#3 &#125;"`, mas a instância de WhatsApp #3 está desconectada.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 103: Manual override specified {WA#3}, but the instance 3 is not connected!
```

**Como corrigir**:

<Info>
  <Steps>
    <Step title="Opção A">
      Conecte a instância #3 no painel de administração
    </Step>

    <Step title="Opção B">
      Edite a mensagem para remover o padrão "`{ WA#3 }`"
    </Step>

    <Step title="Opção C">
      Mude para uma instância conectada, como "`{ WA#1 }`"
    </Step>
  </Steps>
</Info>

### Erro 104: Instância do Número com Tag Não Conectada

<Warning>
  O contato tem uma tag com um número de WhatsApp, mas a instância com esse número não está conectada.
</Warning>

**Causa**: O contato tem uma tag de WhatsApp, mas a instância correspondente não está conectada

Resposta de Erro

```text theme={null}
{  "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"}
```

**Cenário de Exemplo**: O contato "John Doe" tem a tag "wa: +15559876543", mas nenhuma instância com esse número de telefone está conectada.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
```

**Como corrigir**:

<Info>
  <Steps>
    <Step title="Opção A">
      Reconecte a instância de WhatsApp com o número +15559876543
    </Step>

    <Step title="Opção B">
      Remova a tag `wa: +15559876543` do contato John Doe
    </Step>

    <Step title="Opção C">
      Atualize a tag para usar um número conectado, como `wa: +15551111111`
    </Step>
  </Steps>
</Info>

### Erro 105: Instância do Usuário Atribuído Não Conectada

<Warning>
  O contato está atribuído a um usuário, mas a instância de WhatsApp desse usuário não está conectada.
</Warning>

**Causa**: O contato está atribuído a um usuário cuja instância de WhatsApp não está conectada

Resposta de Erro

```text theme={null}
{  "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"}
```

**Cenário de Exemplo**: O contato "Jane Smith" está atribuído à usuária "Sarah Williams", mas a instância de WhatsApp #2 da Sarah está desconectada.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
```

**Como corrigir**:

<Info>
  <Steps>
    <Step title="Opção A">
      Peça para Sarah Williams reconectar a instância de WhatsApp #2 dela
    </Step>

    <Step title="Opção B">
      Reatribua o contato a um usuário com uma instância conectada
    </Step>

    <Step title="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
    </Step>
  </Steps>
</Info>

### Erro 106: Nenhuma Instância Disponível

<Warning>
  O sistema percorreu todos os níveis de prioridade, mas não conseguiu encontrar nenhuma instância de WhatsApp disponível para usar.
</Warning>

**Causa**: Todas as opções de fallback esgotadas, nenhuma instância disponível

Resposta de Erro

```text theme={null}
{  "errorCode": "106",  "message": "Error 106: No connected WhatsApp instances found!",  "resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"}
```

**Cenário de Exemplo**: O sistema percorreu todos os níveis de prioridade (sem substituição manual, sem tags de contato, sem atribuição, sem instância padrão) e ainda assim não encontrou instâncias disponíveis.

**O que você verá no erro**:

```text theme={null}
[ERROR] Error 106: No connected WhatsApp instances found!
```

**Como corrigir**:

<Info>
  <Steps>
    <Step title="Verifique a conectividade das instâncias">
      Confirme que as instâncias não estão todas desconectadas
    </Step>

    <Step title="Defina a instância padrão">
      Marque pelo menos uma instância conectada como "default: true"
    </Step>

    <Step title="Verifique os números de telefone">
      Garanta que as instâncias conectadas tenham números de telefone válidos
    </Step>
  </Steps>
</Info>

## Guia de Solução de Problemas

<Check>
  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!
</Check>

### 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

#### Contact assigned to disconnected instance

* **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

<Steps>
  <Step>
    **Configure alertas** para desconexões de instâncias
  </Step>

  <Step>
    **Teste os fluxos de trabalho** regularmente para detectar problemas cedo
  </Step>
</Steps>

### Melhores Práticas de Configuração

<Steps>
  <Step>
    **Sempre mantenha uma instância padrão** para cada localização
  </Step>

  <Step>
    **Mantenha as tags de contato atualizadas** quando as instâncias mudarem
  </Step>

  <Step>
    **Valide as substituições manuais** antes de implementá-las em fluxos de trabalho
  </Step>

  <Step>
    **Documente sua estratégia de instâncias** para referência da equipe
  </Step>
</Steps>

***

## Documentação Relacionada

* [**Introdução a Múltiplas Instâncias de WhatsApp**](/pt-BR/multiple-instances/overview): Visão geral e casos de uso
* [**Guia de Configuração Completa**](/pt-BR/whatsapp/full-setup): Como conectar instâncias de WhatsApp

Para suporte adicional na solução de erros, entre em contato com nossa equipe pelo botão do WhatsApp abaixo.

***

## Suporte[​](#suporte "Link direto para Suporte")

Se você precisar de ajuda com a configuração ou o onboarding:

* Suporte via WhatsApp: [Conversar no WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20Number%20Selection%20Errors.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)