Pular para o conteúdo principal
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:
PrioridadeRegraComo é acionada
1 (mais alta)Substituição ManualA mensagem contém um padrão de substituição (ex.: { WA#N }, {IM#N})
2Troca TemporáriaA mensagem contém um padrão de troca temporária (ex.: {TEMP-IM#N}) - apenas uma mensagem
3Tags de ContatoO contato está marcado com uma tag de número (ex.: wa:, im:, sms:)
4Atribuição de UsuárioO contato está atribuído a um usuário que tem uma instância atribuída a ele
5Instância PadrãoHá uma instância padrão configurada para a localização
6 (mais baixa)Qualquer DisponívelRecorre 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.

​
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.
CapacidadeWhatsAppiMessageSMS
Substituição manual{ WA#N }{IM#N}-
Troca temporária (uma mensagem)-{TEMP-IM#N}-
Tag de contatowa: +1234567890im: +1234567890sms: +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.

​
Exemplos de Configuração Avançada

​
Exemplo 1: Configuração de E-commerce

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

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

1

Sempre defina um padrão

Garanta que uma instância esteja marcada como padrão para cenários de fallback.
2

Documente sua estratégia

Mantenha um registro de quais números são usados para quais propósitos.
3

Teste sua configuração

Envie mensagens de teste para verificar se a seleção de números funciona como esperado.
4

Monitore regularmente

Verifique diariamente o status de conexão das instâncias.

​
Prevenção de Erros

1

Valide as substituições manuais

Garanta que os padrões { WA#N } / {IM#N} façam referência a instâncias existentes e conectadas.
2

Mantenha as tags de contato

Mantenha as tags wa:, im: e sms: atualizadas quando as instâncias mudarem.
3

Revise as atribuições de usuários

Verifique regularmente se os usuários atribuídos têm instâncias conectadas.
4

Monitoramento de integridade

Configure alertas para desconexões de instâncias.

​
Fluxo de Solução de Problemas

1

Verifique o código de erro

Identifique o erro específico (101-106).
2

Verifique o status da instância

Confirme quais instâncias estão conectadas.
3

Revise a configuração

Verifique as atribuições de usuários, tags e configurações padrão.
4

Teste a resolução

Envie uma mensagem de teste para verificar se a correção funcionou.
5

Documente os problemas

Mantenha um registro de problemas comuns e soluções.

​
O que Vem a Seguir?

​
Suporte​

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