> For the complete documentation index, see [llms.txt](https://sejasuri.gitbook.io/manual-de-integracao/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sejasuri.gitbook.io/manual-de-integracao/faq.md).
# 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](https://wa.me/558540427062) 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](/manual-de-integracao/api.md#autenticacao).
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](https://portal.chatbotmaker.io) 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](/manual-de-integracao/webhooks.md#habilitando) neste manual.
O que a IA envia quando redireciono para meu serviço externo?
Ao criar uma [Intenção de IA](/manual-de-integracao/intencao-de-ia-legado.md) 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](https://documenter.getpostman.com/view/18281413/2sBYHXQdNn#29fb29a7-9f2c-4fd9-b728-7f73830d4774), 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.