Criando uma URA no Asterisk para Geração de Protocolos
Introdução
Neste artigo, damos continuidade à série sobre a criação de uma URA (Unidade de Resposta Audível) no Asterisk para geração de protocolos de atendimento. O objetivo é apresentar de forma conceitual como configurar o ambiente, preparar áudios personalizados e capturar os dígitos informados pelo cliente para integrar com o sistema de geração de protocolos.
Cenário Proposto
O cenário envolve três elementos principais:
-
O cliente, que entra em contato pela central telefônica.
-
O servidor Asterisk, responsável pelo atendimento.
-
A aplicação de back-end, onde são consultados os dados do beneficiário e gerado o número de protocolo.
Nesse fluxo, o cliente informa o número da carteirinha e o sistema precisa capturar esses dígitos para seguir com o atendimento.
Criação do Áudio de Saudação
O primeiro passo é configurar a mensagem de boas-vindas para orientar o usuário. Para isso, utilizamos a ferramenta Eleven Labs para gerar o áudio a partir de texto, com a mensagem:
“Olá, você ligou para o Plano X. Informe o número da carteirinha, por favor.”
Esse áudio precisa ser convertido para o formato WAV, compatível com o Asterisk (mono, 8kHz).
Envio do Áudio para o Servidor
Com o áudio pronto, ele é transferido para o servidor Asterisk utilizando ferramentas como o FileZilla. Por padrão, os áudios ficam armazenados no diretório do Asterisk, seguindo a convenção de pastas estabelecida para facilitar a organização.
Captura dos Dígitos Informados
Para coletar os números da carteirinha digitados pelo usuário, utilizamos scripts AGI (Asterisk Gateway Interface) em Python. Nesse contexto, a biblioteca PyST2 simplifica a interação com o Asterisk, fornecendo métodos para:
-
Atender chamadas.
-
Capturar dados informados pelo cliente.
-
Reproduzir mensagens de áudio.
Com ela, é possível desenvolver scripts que processam a entrada do usuário e armazenam os dígitos digitados.
Isolando o Ambiente Python
Uma boa prática é utilizar um ambiente virtual (VirtualEnv) para instalar as dependências do projeto, evitando conflitos com o interpretador global do Python.
Nesse ambiente, instalamos a biblioteca PyST2 via pip e registramos as dependências em um arquivo requirements.txt, garantindo controle sobre versões utilizadas.
Desenvolvimento do Script AGI
O script principal (main.py) é configurado para:
-
Tocar o áudio de saudação.
-
Definir parâmetros como timeout e limite de dígitos.
-
Capturar a entrada do usuário.
-
Reproduzir os dígitos informados para validação.
Esse processo garante que os dados da carteirinha sejam corretamente coletados para posterior integração com o servidor de aplicação.
Testes no DialPlan
No Asterisk, o script AGI é associado ao DialPlan, permitindo que, ao receber uma chamada, o sistema execute automaticamente as etapas de saudação e coleta de dados. Em testes práticos, o áudio foi reproduzido, os dígitos foram capturados e exibidos no console do Asterisk, validando o funcionamento do processo.
Conclusão
O objetivo deste passo foi atingido: coletar corretamente os dígitos informados pelo cliente. No próximo estágio, esses dados serão integrados com o servidor de aplicação para realizar a consulta do beneficiário e gerar o protocolo de atendimento.
Assista ao Vídeo Completo
O passo a passo detalhado com os comandos e testes práticos está disponível em nosso canal do YouTube. Confira o vídeo completo para acompanhar cada etapa na prática.
