A integração de uma inteligência de conteúdo é feita com apenas alguns passos. Neste guia, explicaremos o que é necessário.
Acessando as informações necessárias
Antes da confecção do fluxo, separe as informações quer serão utilizadas:
Na Plataforma Weni, acesse a inteligência de conteúdo que você quer integrar, no módulo de Inteligência Artificial;
Em seguida, vá até a página API, localizada na barra lateral esquerda:
Na caixa suspensa, selecione a Base de Conhecimento que você deseja integrar:
Ao selecionar a Base de Conhecimento, as informações da mesma serão carregadas na área abaixo:A URL é o link para a API relacionada a este tipo da inteligência. O Access Token é o código necessário para autenticar o seu usuário e o POST corpo Informa o código da Base de Conhecimento, a pergunta a ser feita (pode-se usar variáveis aqui) e o idioma da Base de Conhecimento.
Por fim, a página de API também conta com um mini-guia para integração e um exemplo de retorno da API:
Como integrar a inteligência ao Weni Fluxos ou Rapidpro
No Weni Fluxos ou Rapidpro, siga os passos abaixo:
Crie um fluxo, ou abra o fluxo no qual você fará a integração
Adicione um card de Aguarde por Resposta. Este card receberá a pergunta feita por quem utilizar o seu chatbot. Para facilitar a identificação, nomeie o resultado como pergunta, ou outro termo que identifique que ele armazenará uma pergunta:
Em seguida, adicione o card de fluxo Chamar um webhook
Quando o card for aberto, selecione o POST no seletor de método e cole a URL informada no campo URL:
Clique no botão Headers HTTP e insira o Access Token:
Clique no botão POST Corpo e insira as informações de POST Corpo. Em question, inclua a variável que contém o resultado. Neste exemplo a variável se chama "pergunta", então inserimos "@results.pergunta":
Dica: Saiba mais sobre variáveis de fluxo neste artigo.
Tratando as respostas recebidas
Após configurar o card Chamar Webhook, as informações recebidas pelo fluxo podem ser tratadas e utilizadas. Segue um exemplo de utilização:
Uma vez que o card Chamar Webhook seja executado, você pode utilizar os valores da resposta inserindo estas fórmulas em seu fluxo:
@(results.result.extra.answers.0.text) - A resposta que possui a maior confiança
@(results.result.extra.answers.0.confidence) - A confiança da primeira resposta retornada
@(results.result.extra.answers.1.text) - A resposta que possui a segunda maior confiança
@(results.result.extra.answers.1.confidence) - A confiança da segunda resposta retornada
@(results.result.extra.answers.2.text) - A resposta que possui a terceira maior confiança
@(results.result.extra.answers.2.confidence) - A confiança da terceira resposta retornada
Dica: Saiba mais sobre variáveis de fluxo neste artigo.