Introdução DTMF
Lê as teclas marcadas por quem liga e guarda o resultado numa variável: um código de cliente, um número de processo, uma referência a verificar depois.
Em resumo
| Saídas | uma única, utilizada quer quem liga tenha marcado ou não |
| Campos | Variável (resultado), Mensagem (opcional), Número de algarismos, Timeout (s) |
| Número de algarismos | de 1 a 20, 1 por predefinição |
| Timeout | 3, 5, 10, 15, 20 ou 30 segundos, 5 por predefinição |
| Efeito na chamada | o módulo atende a chamada se ainda não estiver atendida |
O texto de ajuda mostrado na janela é: «Lê as teclas DTMF de quem liga e guarda o valor introduzido numa variável (utilizável via {{nome}}).»
Como funciona
DTMF é o nome técnico dos tons emitidos por um teclado telefónico. O módulo escuta esses tons, monta os algarismos marcados e guarda-os numa variável que se nomeia.
Reproduz primeiro o anúncio escolhido. Quem liga pode marcar durante o anúncio: este para no primeiro algarismo. A introdução termina quando o número de algarismos esperado é atingido, ou quando o prazo se esgota.
Depois, em todos os casos, a chamada segue pela saída única do módulo. Uma introdução ausente não é um erro: dá uma variável vazia, que cabe testar mais adiante, com uma Condição (Se) ou um Switch / Case.
O que preencher
| Campo | O que é esperado | Se o deixar vazio |
|---|---|---|
| Variável (resultado) | o nome sob o qual guardar a introdução, em letras sem acento, algarismos e travessão baixo | a introdução é lida mas não é guardada em lado nenhum, e o módulo não serve para nada |
| Mensagem (opcional) | o anúncio que convida a marcar, escolhido entre os sons; uma entrada no topo da lista permite não reproduzir nenhum | um segundo de silêncio, depois a espera, sem uma palavra para quem liga |
| Número de algarismos | de 1 a 20 | 1 |
| Timeout (s) | 3, 5, 10, 15, 20 ou 30 segundos | 5 |
Passo a passo
- Coloque o módulo Introdução DTMF e ligue o nó anterior à sua entrada.
- Abra-o e nomeie a Variável (resultado), por exemplo
processo. - Escolha a Mensagem (opcional) entre os anúncios. Deve dizer a quem liga o que marcar e quantos algarismos.
- Regule o Número de algarismos para o tamanho real do que se espera.
- Regule o Timeout (s). Cinco segundos bastam para um código curto, mais tempo para uma referência longa a procurar num documento.
- Clique em Guardar, depois ligue a saída única à continuação do plano.
- Coloque um módulo Depuração logo a seguir, com a mensagem
processo={{processo}}, para ler o que foi realmente marcado. - Trate a introdução vazia: uma Condição (Se) com o operador «está vazio» em
{{processo}}permite repetir o anúncio ou passar a um humano. - Clique em Guardar, depois em Aplicar as alterações na faixa superior.
- Ligue para o número, marque um código, depois abra o Registo de depuração do plano e compare o valor escrito com o que foi marcado.
Se não funcionar
A variável está vazia mesmo quem liga tendo marcado algo. Verifique primeiro que o campo Variável (resultado) tem mesmo um nome, e que esse nome está escrito de forma idêntica entre chavetas mais adiante. Verifique depois o prazo: se demasiado curto, expira antes de quem liga terminar de marcar.
Um código composto só por zeros nunca é gravado. É uma limitação conhecida do módulo: uma introdução que contém apenas zeros não se distingue de uma ausência de introdução, e a variável fica vazia. Um zero no início de um código mais longo, esse, é conservado normalmente. Evite códigos inteiramente compostos por zeros.
Quem liga não ouve nada e não sabe o que fazer. Nenhuma Mensagem (opcional) está escolhida: o módulo espera depois de um segundo de silêncio. Escolha um anúncio, e anuncie nele o número de algarismos esperado.
A introdução demora, apesar de ter indicado seis algarismos. Quem liga marcou menos do que isso. O módulo espera então todo o prazo antes de continuar. Reduza o Timeout (s), ou anuncie mais claramente o tamanho esperado.
A chamada é cortada depois da introdução. A saída única não está ligada a nada. Um módulo cuja saída acionada não leva a lado nenhum termina a chamada, mesmo quando a introdução correu bem.
Como se constrói o plano de chamadas, explicado em imagens
Ver a página Planos de numeração