❓FAQ

Um resumo sobre as principais dúvidas relacionadas à integracão.

Ficou com alguma dúvida? A resposta para ela pode estar aqui, mas não hesite em nos contatar caso esteja com alguma dificuldade.

Estou recebendo código de erro 401 ao tentar chamar a API. O que pode ser?

Código 401 significa falha de autenticacão, verifique se o token foi utilizado corretamente. Para mais detalhes, ver seção autenticacão.

Chamada à API retorna erro, mas não recebo nenhuma mensagem informando o motivo.

Certifique-se de que há o item Content-Type: application/json presente no header de sua requisicão.

Minha API possui autenticação por token, posso utilizá-la na integracão de IA?

Atualmente não enviamos nenhum token na requisicão POST ao direcionarmos um contato para uma API via Intencão de IA, então não seria possível. Para manter um nível de seguranca viável neste ponto recomendamos uma regra de acesso via domínio para os endpoints a serem utilizados em integracões de Intencão de IA.

Por exemplo, em seu endpoint que irá ser adicionado em uma IA da Suri, existir regra de acesso por domínio, aceitando apenas chamadas vindas da URL do chatbot, garantindo assim que aquele endpoint só será utilizado pela Suri.

Lembrando que a URL do seu chatbot pode ser encontrada na página Configurações do Portal e tem o seguinte formato:

https://xxx.azurewebsites.net

O Portal não permite salvar a url para recebimento dos Webhooks.

Para permitir o salvamento de URLs de recebimento de webhooks, sua aplicação deve estar preparada para aceitar uma requisição GET que retorne código 200 (de sucesso) e como conteúdo, o ID de sua Suri. Isso funciona como um handshake, onde sabemos que sua aplciação está preparada para receber os eventos.

Note que esse mesmo endpoint também deve permitir requisições POST, que serão enviadas juntamente com o conteúdo dos webhooks. Para mais informações, veja a seção Habilitando webhooks neste manual.

O que a IA envia quando redireciono para meu serviço externo?

Ao criar uma Intenção de IA com redirecionamento para seu serviço externo, a Suri envia uma requisição POST cujo body contém o contato que está acessando aquele fluxo. Tal contato possui um Id, nome, telefone, dentre outros dados interessante que você pode cruzar co sua base de dados e fazer inúmeras ações.

Um contato é definido como User em nossa documentação no Postman, a definiçao dos atributos de contato e demais entidades utilizadas na integração podem ser encontradas lá.

O ID do contato é único ou muda a cada fluxo?

O ID do contato é único por canal de atendimento. Isso significa que se você só tiver um canal conectado, como WhatsApp, por exemplo, sempre que uma pessoa falar com sua empresa através dele será identificada pelo mesmo ID, sem possibilidade de mudança. Caso você tenha dois ou mais canais WhatsApp conectados, a mesma pessoa terá dois ou mais contatos criados no Portal, mas cada um com um ID diferente.

Como posso saber o ID de um contato?

Você pode verificar o ID de um contato acessando o Portal da Suri, na página de conversas e procurando pelo contato em questão (por nome, telefone, ou tags) entre as filas de atendimento.

Na coluna mais à direita, o ID se encontra mais abaixo na tela, na seção Atendimento.