Como integrar seu sistema com o webphone hidden da TotalVoice

Olá pessoal, tudo bem?

Neste tutorial iremos apresentar como integrar seu sistema com o webphone hidden (escondido) da TotalVoice.

Após a criação da sua conta, você deve pegar seu Access-Token na página inicial da TotalVoice. Feito isso, basta acessar o método /webphone para buscar a URL de uso do seu ramal. Segue exemplo abaixo:

 

O método/webphone possui os seguintes parâmetros:

  • tipo
    • floating = Popup
    • embedded = Embutido no site
    • hidden = Sem interface e com funções de callback
  • Id_ramal = ID do ramal para pré-configurar o widget
  • ramal = Número do ramal para pré-configurar o widget
  • ligar_para = Abrir o webphone ligando para o número, formato DDD + Número exemplo: 4832830151
  • fechar_fim = Fechar a janela do webphone quando a chamada for encerrada?

 

Até aqui tudo bem 🙂

A próxima etapa é adicionar essa URL numa tag  do javascript para conectar o seu webphone, visualize o exemplo do github clicando aqui. Observe o trecho abaixo:

<!– URL que foi pega pela API no /webphone – cria o iframe e injeta o webphone–>
<script src=”URL_WEBPHONE_API_TOTALVOICE”></script>

Substitua URL_WEBPHONE_API_TOTALVOICE pelo conteúdo de sua URL. Ao executar o arquivo de exemplo o resultado esperado é o da imagem abaixo:

 

 

Funções javascript disponíveis para implementação

 

Nome do método: desligaChamada()

Descrição: Função para desligar uma chamada ativa.

Utilização:

 

Nome do método: chamaNumero(numero)

Descrição: Função que realiza uma ligação para um número destino

Utilização:

OBS: Neste caso é preciso passar o número por parâmetro

 

Nome do método: atender()

Descrição: Função para atender uma ligação

Utilização:

 

Nome do método: enviaDTMF(meuDTMF)

Descrição: Função para utilizar com URAS, enviar valores para o destino.

Utilização:

 

Nome do método: mute()

Descrição: Função para colocar o telefone no modo mudo

Utilização:

 

Nome do método: transferir(numeroTelefone)

Descrição: Transferência blind – Encerra a ligação no número ativo e transfere para o número passado por parâmetro

Utilização:

 

Nome do método: transferirConsulta(numeroTelefone)

Descrição: Transferência com consulta- Transfere a chamada para o número de telefone passado por parâmetro e, ao finalizar a chamada transferida, volta para a ligação para o número que realizou a transferência.

Utilização:

 

Nome do método: conectar()

Descrição: Função para ativar o webphone. Não é necessário executar ao abrir pela primeira vez, pois ele se conecta automaticamente.

Utilização:

 

Nome do método: desconectar()

Descrição: Função para desligar o webphone e parar de receber ligações. Para reativar, deve ser executado o comando de conectar()

Utilização:

 

Nome do método: recStart()

Descrição: Função para iniciar uma nova gravação durante a chamada.

Utilização:

 

Nome do método: recStop()

Descrição: Função para parar a nova gravação durante a chamada. Se iniciar a gravação de várias, o stop termina a mais antiga cada vez que roda.

Utilização:

 

 

 

Exemplo completo de como integrar no seu ambiente

 

Carlos Santos
Postagens relacionadas
Como encantar seus clientes e vender mais com o poder do SMS e TTS
Enviando SMS/TTS em NodeJS com a TotalVoice
Criando um relatório .csv com a API da TotalVoice
Como automatizar atendimento e integrar telefonia com seu sistema
TotalVoice lança versão para integrar com Freshdesk

Pin It on Pinterest