Condição: detectar idioma

Saiba como usar o nó Detectar idioma nos seus workflows para rotear cada conversa pelo idioma do contato, sem escrever nenhuma regra manual.

Jun 26, 2026

Veja este passo no vídeo · Detectar idioma e agente na equipe

O que é e quando usar

O nó Detectar idioma é um nó de condição (roteador) que identifica o idioma do contato e direciona a conversa por uma saída diferente para cada idioma. É ideal quando você atende clientes de vários países e quer que cada um receba respostas, atribuições ou agentes de IA no próprio idioma, sem precisar perguntar.

Diferente do nó de URA para chamadas (que só conhece o país do telefone), esta versão entende todos os canais: WhatsApp, Webchat, Telegram, Messenger, Instagram, e-mail e mais.

Requisitos

  • Um workflow criado em Automações com um gatilho ativo (por exemplo, Conversa criada ou Mensagem recebida).
  • O contato precisa de pelo menos uma mensagem recebida ou um número de telefone válido para a detecção funcionar.

Como funciona a detecção

Com o método Automático (cascata por canal) o nó escolhe a melhor pista conforme o canal:

  • WhatsApp, SMS e voz: pelo código de país do telefone (+593 → es, +55 → pt, +49 → de, +1 → en).
  • Webchat: pelo idioma do navegador do visitante.
  • Telegram: pelo language_code da conta do Telegram.
  • Messenger, Instagram, e-mail e outros: pelo texto da última mensagem do contato.

Se escolher o método Apenas texto, o nó sempre classifica pelo texto da última mensagem. Ative Usar IA para uma detecção de texto mais precisa (consome o crédito de IA do plano); sem marcar, usa uma heurística gratuita por palavras-chave.

Passos para configurar

  1. Abra Automações e entre no editor do seu workflow.
  2. Arraste o nó Detectar idioma da paleta (categoria Condição) e conecte-o depois do seu gatilho.
  3. No painel Configurar escolha o Método: Automático (recomendado) ou Apenas texto.
  4. Marque Usar IA se quiser mais precisão na detecção por texto.
  5. Em Idiomas suportados marque os que precisar (es, en, pt, fr, de, it…). Cada um cria a própria saída; além disso sempre existe a saída Outro.
  6. Defina o Idioma padrão para quando nada for detectado.
  7. (Opcional) Em Salvar na variável deixe detected_language e ative Salvar no contato para reutilizar o dado depois.
  8. Conecte cada saída (es / en / pt / … / Outro) aos próximos nós: uma mensagem, um agente de IA ou uma atribuição diferente por idioma.

Verificação

Salve e ative o workflow. Envie uma mensagem de teste de um número ou navegador no idioma esperado e abra o histórico de execução do workflow: você verá o ramo seguido e a variável $detected_language com o código ISO (por exemplo es). O nó também expõe $detected_language_confidence e $detected_language_source.

Se não funcionar

  • Cai sempre em Outro: o idioma detectado não está em Idiomas suportados. Adicione-o ou revise o idioma padrão.
  • WhatsApp detecta mal: a detecção usa o código de país do telefone; um número internacional pode não corresponder ao idioma real. Troque o método para Apenas texto.
  • Detecção por texto fraca: ative Usar IA para textos curtos ou ambíguos.

Dicas

  • Coloque o nó o mais cedo possível no fluxo para que tudo depois herde o idioma.
  • Salve o idioma no contato: a próxima conversa já começa roteada sem detectar de novo.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp