Nó de IVR: Reconhecimento de voz

O nó Reconhecimento de voz reproduz uma mensagem e grava uma resposta falada do chamador durante uma janela curta de tempo. O áudio é transcrito automaticamente e o texto fica disponível como variável para usar mais adiante no fluxo (por exemplo em um nó Bifurcar ou Condição). É útil quando pedir para o chamador dizer algo ("Diga seu nome", "Como podemos ajudar?") é mais natural do que pedir para pressionar um número.

Requisitos

• O workspace precisa ter habilitado o serviço de transcrição de voz que este nó usa.
• Defina antecipadamente em qual variável você vai salvar o texto reconhecido, para referenciá-la em nós posteriores.

Passos

1. Abra Configurações → Canais → (seu canal de chamadas) → Editor de fluxo IVR.
2. Arraste o nó Reconhecimento de voz para o canvas.
3. Escreva a Mensagem que toca antes de gravar (por exemplo: "Nos diga brevemente como podemos ajudar").
4. Escolha a voz e ajuste a Duração máxima.
5. Preencha Salvar transcrição na variável com um nome (por exemplo motivo_chamada).
6. Opcional: indique um Idioma sugerido se você já souber o idioma do chamador.
7. Deixe ativado Voltar para DTMF se a transcrição falhar, a menos que tenha outro tratamento para esse caso.
8. Conecte a saída ao próximo nó (por exemplo um Bifurcar que use a variável salva, ou direto para Enviar para IA).
9. Salve e publique.

Configuração

• Mensagem: o que é perguntado ao chamador antes de gravar.
• Duração máxima (segundos): quanto tempo grava após a mensagem. Limite rígido de 30 segundos, porque o processo de transcrição tem um limite de espera de 10 segundos.
• Salvar transcrição na variável: nome da variável onde fica o texto reconhecido, para usar depois em Bifurcar, Condição ou Enviar para IA.
• Idioma sugerido (ISO 639-1): um código como "es", "en" ou "pt"; vazio = detecção automática.
• Voltar para DTMF se a transcrição falhar: se a transcrição sair vazia ou falhar, é recomendável encaminhar a chamada para um prompt com dígitos como alternativa.

Exemplo

Na saudação inicial você pergunta "Como podemos ajudar?" com Reconhecimento de voz, salva a resposta em motivo_chamada, e um nó Enviar para IA usa essa variável como contexto para que o agente de IA entenda a solicitação sem pedir que o chamador repita tudo.

Dicas

• Combine com um nó Enviar para IA ou Bifurcar que leia a variável salva para tomar decisões com base no que o chamador disse.
• Se você espera respostas curtas e previsíveis (números, opções de menu), Aguardar dígito (DTMF) costuma ser mais confiável que este nó.

Solução de problemas

• A transcrição chega vazia: o chamador não falou, falou muito baixo, ou o áudio não chegou a tempo dentro do limite de 10 segundos — verifique se o caminho de fallback por DTMF está conectado.
• A variável aparece vazia em nós posteriores: confirme que o nome em Salvar transcrição na variável corresponde exatamente ao usado depois.