> ## 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. # Seleção de Números > O algoritmo compartilhado, baseado em prioridades, que decide de qual número uma mensagem de saída é enviada - comum a WhatsApp, iMessage e SMS - e a sintaxe de tags e substituições de cada canal. A seleção de números funciona da **mesma forma para todos os canais**. Quando você envia uma mensagem de saída, a integração percorre uma hierarquia de prioridades fixa e escolhe a primeira instância que corresponde. Apenas a **sintaxe** de tags e substituições muda entre WhatsApp, iMessage e SMS - a lógica de decisão não. ## Hierarquia de Prioridade de Seleção O sistema avalia estas regras em ordem e usa a primeira que resolver para uma instância conectada: | Prioridade | Regra | Como é acionada | | -------------- | ------------------------- | ------------------------------------------------------------------------------------------ | | 1 (mais alta) | **Substituição Manual** | A mensagem contém um padrão de substituição (ex.: `{ WA#N }`, `{IM#N}`) | | 2 | **Troca Temporária** | A mensagem contém um padrão de troca temporária (ex.: `{TEMP-IM#N}`) - apenas uma mensagem | | 3 | **Tags de Contato** | O contato está marcado com uma tag de número (ex.: `wa:`, `im:`, `sms:`) | | 4 | **Atribuição de Usuário** | O contato está atribuído a um usuário que tem uma instância atribuída a ele | | 5 | **Instância Padrão** | Há uma instância padrão configurada para a localização | | 6 (mais baixa) | **Qualquer Disponível** | Recorre a qualquer instância conectada | Em todos os casos, o sistema considera apenas instâncias **conectadas**. Se a regra resolver para uma instância desconectada, ele gera um erro em vez de seguir adiante silenciosamente - consulte [Erros de Seleção de Números](/pt-BR/multiple-instances/number-selection-errors). ## Referência de Sintaxe por Canal Os padrões abaixo são intercambiáveis em conceito - escolha a linha do canal pelo qual você está enviando. `N` é o índice da instância; `+1234567890` é o número de destino. | Capacidade | WhatsApp | iMessage | SMS | | ------------------------------- | ----------------- | ----------------- | ------------------ | | Substituição manual | `{ WA#N }` | `{IM#N}` | - | | Troca temporária (uma mensagem) | - | `{TEMP-IM#N}` | - | | Tag de contato | `wa: +1234567890` | `im: +1234567890` | `sms: +1234567890` | Os padrões de substituição e troca temporária são removidos do corpo da mensagem antes de ela ser entregue, então o destinatário nunca os vê. ## Regras de Prioridade em Detalhes ### 1. Substituição Manual Adicione o padrão de substituição do seu canal em qualquer parte da mensagem - `{ WA#N }` para WhatsApp ou `{IM#N}` para iMessage - onde `N` é o índice da instância, para forçar uma instância específica. * **Quando é usada:** A mensagem contém um padrão de substituição manual. * **Exemplo:** `"This message will go via the 2nd instance { WA#2 }"` * **Comportamento:** * Extrai o índice da instância do padrão. * Valida que a instância existe e está conectada. * Remove o padrão da mensagem antes do envio. O sistema gera um erro se a instância especificada não existir ou não estiver conectada. ### 2. Troca Temporária (iMessage) Use `{TEMP-IM#N}` para enviar uma única mensagem de uma conta diferente sem alterar permanentemente a conta atribuída ao contato. * **Quando é usada:** Você quer enviar uma mensagem de um número diferente sem alterar a atribuição de conta normal do contato. * **Exemplo:** `"Quick update from our support line {TEMP-IM#3}"` * **Comportamento:** * Roteia temporariamente a mensagem pela conta especificada. * **Não** altera a atribuição de conta padrão do contato. * Remove o padrão da mensagem antes do envio. * Mensagens futuras para esse contato continuam usando a conta normal dele. ### 3. Tags de Contato Marque um contato com a tag `wa: +1234567890` (ou `im:` / `sms:`) para sempre usar um número específico para esse contato. * **Quando é usada:** O contato tem uma tag de número para o canal. * **Exemplo:** Contato com a tag `wa: +15551234567` * **Comportamento:** 1. O sistema examina as tags do contato em busca do padrão de número do canal (`wa:`, `im:` ou `sms:`). 2. Ele encontra a instância conectada cujo número de telefone corresponde ao número da tag. 3. Se houver correspondência, essa instância é usada para a mensagem. Ocorre um erro se a instância do número da tag não estiver conectada. ### 4. Atribuição de Usuário Quando um contato está atribuído a um usuário no seu CRM, o sistema usa a instância desse usuário para o canal pelo qual o envio está sendo feito. * **Quando é usada:** O contato está atribuído a um usuário específico que tem uma instância atribuída a ele. * **Comportamento:** 1. O sistema procura o usuário ao qual o contato está atribuído no seu CRM. 2. Ele encontra a instância atribuída a esse usuário para o canal pelo qual o envio está sendo feito. 3. Se essa instância estiver conectada, ela é usada para a mensagem. Ocorre um erro se a instância do usuário atribuído não estiver conectada. ### 5. Instância Padrão Sempre defina uma instância como "padrão" para cada localização, para garantir um comportamento de fallback confiável. * **Quando é usada:** Nenhuma substituição, tag ou atribuição de usuário específica é resolvida. * **Comportamento:** * Usa a instância marcada como "padrão" para a localização. * Considera apenas instâncias conectadas. ### 6. Qualquer Instância Disponível * **Quando é usada:** Como fallback final. * **Comportamento:** * Seleciona qualquer instância conectada com um número de telefone. Se nenhuma instância conectada estiver disponível neste ponto, a mensagem falha (o WhatsApp retorna o Erro 106). Consulte [Erros de Seleção de Números](/pt-BR/multiple-instances/number-selection-errors). ## Exemplos de Configuração Avançada ### Exemplo 1: Configuração de E-commerce ```text theme={null} Instance #1: +1-555-ORDERS (Order confirmations) - Assigned to: Order Management User - Usage: Automated order workflows Instance #2: +1-555-SUPPORT (Default - Customer service) - Marked as: Default Instance - Usage: General customer inquiries Instance #3: +1-555-BILLING (Billing inquiries) - Contact Tags: VIP customers tagged with "wa: +1-555-BILLING" - Usage: Payment and billing communications ``` ### Exemplo 2: Gestão de Clientes de Agência ```text theme={null} Instance #1: Client A Brand Number - Manual Override: Workflows use { WA#1 } for Client A Instance #2: Client B Brand Number - User Assignment: Client B team members assigned to Instance #2 Instance #3: Agency Main Line (Default) - Default Instance: Used for all other communications ``` ## Melhores Práticas ### Recomendações de Configuração Garanta que uma instância esteja marcada como padrão para cenários de fallback. Mantenha um registro de quais números são usados para quais propósitos. Envie mensagens de teste para verificar se a seleção de números funciona como esperado. Verifique diariamente o status de conexão das instâncias. ### Prevenção de Erros Garanta que os padrões `{ WA#N }` / `{IM#N}` façam referência a instâncias existentes e conectadas. Mantenha as tags `wa:`, `im:` e `sms:` atualizadas quando as instâncias mudarem. Verifique regularmente se os usuários atribuídos têm instâncias conectadas. Configure alertas para desconexões de instâncias. ### Fluxo de Solução de Problemas Identifique o erro específico (101-106). Confirme quais instâncias estão conectadas. Verifique as atribuições de usuários, tags e configurações padrão. Envie uma mensagem de teste para verificar se a correção funcionou. Mantenha um registro de problemas comuns e soluções. ## O que Vem a Seguir? * [**Erros de Seleção de Números**](/pt-BR/multiple-instances/number-selection-errors): Códigos de erro 101-106 e como resolvê-los * [**Visão Geral de Múltiplas Instâncias**](/pt-BR/multiple-instances/overview): Casos de uso, benefícios e configuração * [**Guia de Configuração Completa**](/pt-BR/getting-started/full-setup): Conecte instâncias e configure atribuições *** ## 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.) * Email: [**support@goghl.ai**](mailto:support@goghl.ai)