Telefonia

Introdução

A Sophie possui um sistema de telefonia para integração, neste artigo você encontrará instruções para realizar esta integração em seu sistema de voz.

Caso deseje utilizar o sistema de voz fornecido pela Woopi, entre em contato com o suporte para falar com nossa equipe.

Integração

O primeiro passo para começar a realizar a integração com o sistema de voz é acessar o gerenciador da Sophie e acessar a aba de serviços – interfaces.

Em seguida clique no botão de “Adicionar Interfaces” e uma tela abrirá.

No campo “Canal” selecione a opção de telefonia, a tela se expandirá e dois novos campos serão mostrados: Parâmetros e Guid ID, esses campos serão extremamente importantes para realizarmos a integração.

O campo parâmetro é a URL para onde serão feitas as requisições para a Sophie, para fazer essas requisições será necessário enviar um JSON com as informações preenchidas corretamente.

Requisição de Login

O primeiro passo para nos comunicarmos com a API da Sophie será realizarmos uma requisição de Login, para isso será necessário utilizar a URL copiada seguido de “/login”.

Neste exemplo a URL ficaria assim: https://mt.parli.com.br/Inter/ph/api/Phone/Sophie/Login

Além disso precisamos enviar junto uma cópia do JSon abaixo preenchida com as informações da sua Sophie:

{    
    "Name": "usuário",   
    "Password": "senha",    
    "Channel": "Phone",    
    "SessionId": "",    
    "Tenant": "Nome do seu BOT",    
    "Guid": "Guid fornecido na criação da interface"
}

Após o envio destas informações a Sophie nos responderá com um ID de Sessão, ou SessionId.

Utilizaremos essa SessionId para realizar as próximas requisições com a Sophie, desta maneira fazer construindo uma troca de mensagem.

Requisição de Respond

Para isso iremos enviar um requisição para a mesma URL porém substituindo o “/Login” por “/Respond” como no exemplo: https://ph.api.cloud.sophie.chat/api/Phone/Respond

A requisição deverá enviar algo similar ao JSon abaixo:

{    
    "sessionId": "SessionId",
    "userInput": "Entrada do usuário",    
    "system": "phone",    
    "tenant": "Nome do seu BOT"
}

A resposta dessa requisição será a mensagem que a Sophie enviaria de acordo com a entrada do usuário, desta forma é possível manter uma conversa com a Sophie em qualquer interface de telefone.

A partir deste ponto sua comunicação com a Sophie já está finalizada, entretanto as regras que possuírem comandos estarão sem tratamento, para isso é necessário interpretar os comandos trazidos.

Para ter acesso a lista de todos os comandos de telefonia e o que eles fazem acesse este link.

Was this post helpful?

Previous Post Next Post
Lorem amet, ut Sed commodo pulvinar venenatis
× Como posso te ajudar?
Share via
Copy link
Powered by Social Snap