> 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 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 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 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 envie consuma APIs externas, tratando o retorno dentro do fluxo; Serviço externo também pode chamar ativamente um fluxo da Suri 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*.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sejasuri.gitbook.io/manual-de-integracao/inicio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.