Integrações
As integrações com a assistente virtual Anuva dizem respeito aos canais em que o administrador irá disponibilizar a assistente. Essa funcionalidade permitirá a inserção dos links das plataformas desejadas para haver a integração da assistente virtual com o sistema selecionado.
Veremos adiante que o chat pode ser integrado nativamente ao CITSmart, além do Facebook ou sistema próprio do usuário através de API Rest.
- Após acessar a plataforma, acesse o menu “Integrações”;
- Serão apresentadas as seguintes opções de integração: Facebook Messenger, CITSmart e API Rest;
- Selecione qual opção você deseja integrar.
A Anuva já se integra nativamente ao CITSmart, então é muito fácil adicioná-la ao seu ambiente.
Para realizar a integração, é necessário que você configure os parâmetros necessários no seu próprio ambiente de produção. Para isso, acesse o sistema e no menu de processos, selecione Parametrização > Parâmetros CITSmart.
Localize e preencha os seguintes parâmetros:
Parâmetro | Valor |
402 Anuva Assistant - External URL | http://[nome-servidor].Anuvaassistant.com |
441 Anuva Assistant - Conversation API | http://[nome-servidor][sigla-idioma].Anuvaassistant.com/webhooks/rest/webhook |
442 Anuva Assistant - Parameters API | http://[nome-servidor][sigla-idioma].Anuvaassistant.com/conversations/ |
Importante: Os valores a serem preenchidos nos parâmetros acima dependerão do valor apresentado na ferramenta Anuva. Para isso, acesse a sua assistente virtual e selecione “Integrações”. Para integrar com a plataforma, selecione “CITSmart” e serão apresentados os valores para copiar e colar no valor na própria plataforma CITSmart. Esses parâmetros não podem ser alterados pelo cliente.
Facebook Messenger
Também é possível de integrar a assistente virtual Anuva ao chat do Facebook Messenger. Nesse caso as instruções são fornecidas pelo próprio Facebook e fornecemos as informações necessárias para realizar a integração:
- Callback URL
- Verify Token
- Secret
- Page Access Token
API Rest
Nessa funcionalidade o cliente pode customizar a assistente virtual para outro canal. Por exemplo, se o cliente já possuir um site institucional e deseja incluir a assistente virtual para o seu chat. Para isso, basta selecionar a opção de comunicação API Rest.
O API Rest é o protocolo de comunicação da assistente virtual. Nela são apresentadas as seguintes informações para realizar a integração com sucesso:
- Endpoint
- Método
- Media Type
E os formatos necessários para integração:
- Formato de envio de mensagem ao bot:
{ "sender": "joao", "message": "conte-me algumas coisas sobre você" }
- Formato de retorno da mensagem do bot em texto:
{ "recipient_id": "joao", "text": "Eu posso ajudá-lo a trabalhar de maneira mais inteligente, em vez de mais" }
- Formato de retorno da mensagem do bot em botão:
{ "recipient_id": "joao", "text": "Você poderia avaliar o meu atendimento?", "buttons": [ { "title": "Sim", "payload": "sim" }, { "title": "Não", "payload": "não" } ] }
- Formato de retorno da mensagem do bot em imagem:
{ "image": "https://anuvaassistantimages.s3.amazonaws.com/dev/fe711b50-d974-11e9-9622-94de80f33bee.png", "recipient_id": "joao" }
Ou
{ "attachment": "https://anuvaassistantimages.s3.amazonaws.com/dev/fe711b50-d974-11e9-9622-94de80f33bee.png", "recipient_id": "joao" }