Skip to main content
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:
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.
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

​
Exemplo 2: Gestão de Clientes de Agência

​
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: