> 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/inicio.md).

# Início

Integrações são uma excelente maneira de turbinar o atendimento, com elas é possível unir tudo o que a Suri oferece com os serviços que sua empresa já utiliza, como bancos de dados ou CRMs. A partir daqui te guiaremos nesta jornada para utilizar o máximo de sua **Suri Shop by Totv**s da melhor maneira possível.

{% hint style="info" %}
Recomendamos um prévio conhecimento técnico em algumas partes, pois utilizaremos termos, como *API* ou *webhook*, que são necessários para o total entendimento dos conceitos aqui repassados.
{% endhint %}

Segue abaixo uma representação gráfica das possibilidades de integração, que são 3:

<figure><img src="/files/jgAEhzZgQXqaP8Orsgig" alt="" width="563"><figcaption></figcaption></figure>

* ***Webhook*****:** Suri Shop by Totvs ativamente chama determinado serviço após eventos importantes no chatbot, como nova mensagem recebida;
* **API:** Serviço externo realiza consultas ou ações na Suri Shop by Totvs através de chamada de API, por exemplo, listar histórico de contato ou enviar mensagem;
* **Fluxo:** Uma via de mão dupla: Contato cai em um determinado fluxo conversacional que possui ações de [Requisição HTTP](/manual-de-integracao/flow/requisicao-http.md), permitindo que a Suri Shop by Totvs envie consuma APIs externas, tratando o retorno dentro do fluxo; Serviço externo também pode chamar ativamente um fluxo da Suri Shop by Totvs por meio de [Gatilhos de Webhook](/manual-de-integracao/flow/gatilhos/webhooks.md), fazendo com que o contato em questão seja ativado e já execte determinado fluxo conversacional.

Uma lista completa de definições e *endpoints* pode ser encontrada em nossa documentação no Postman, por isso constantemente traremos referências a ela, dando dicas e exemplos de possibilidades de integração. Confira aqui nossa documentação na íntegra:

<https://documenter.getpostman.com/view/17684221/UUxz9mt5>

Começaremos detalhando o funcionamento dos *Webhooks*.