> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/configuracao-de-webhook-api-de-saida.md).

# Configuração de Webhook (API de saída)

A **API Webhook** (também conhecida como API de saída) é a ferramenta que permite ao Chat Center notificar seus sistemas externos instantaneamente sempre que ocorre uma ação importante na plataforma.

Imagine que o Webhook é como um "**sensor de movimentos**": em vez de você ter que entrar no Chat Center para checar se um atendimento terminou, o próprio sistema "telefona" para o seu servidor e avisa: "Ei, o protocolo 123 acaba de ser finalizado pelo agente João, aqui estão todos os dados da conversa!".

{% hint style="warning" %}
**##Importante**

Diferente da [<mark style="color:$primary;">API REST (onde você precisa configurar o componente RPA no fluxo</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/automacao-com-api-rest-conectando-sistemas.md)<mark style="color:$primary;">)</mark>, o **Webhook** funciona de forma global ou vinculada ao canal. Uma vez configurado e ativado, ele rodará automaticamente sempre que o evento selecionado ocorrer, sem que você precise mexer no desenho do robô.
{% endhint %}

### Criando uma nova API/Webhook

Para acessar a área de API, utilize o menu lateral esquerdo e navegue até Integrações > API, como mostra a imagem abaixo.

<img src="/files/i9A6HwxvdPx4FcPlqDkT" alt="" height="411" width="602">

Ao acessar a tela, você verá uma lista completa de APIs criadas. Para criar um novo webhook, clique no botão **“+”** no rodapé, no lado direito da página, para abrir o formulário de cadastro abaixo.

<img src="/files/7WkXnFAGT6g9PvBqYFPv" alt="" height="655" width="553">

Para criar uma nova integração, preencha os campos conforme detalhado abaixo:

**Nome:** Um título para você identificar a finalidade deste Webhook (ex.: "Notificar\_Venda\_Concluída" ou "Alerta\_Novo\_Lead").

**Host:** É a **URL do seu sistema de destino**. É o endereço que está preparado para receber e processar as informações que o Chat Center enviará.

**Cabeçalho (Header)**: Define como os dados serão formatados. Você pode escolher entre **Formulário** ou **JSON**. O padrão mais utilizado para Webhooks é o JSON.

**Método:** Define como a requisição será feita. O método **POST** é o padrão recomendado, pois permite o envio de volumes maiores de dados (corpo da mensagem).

**Timeout (segundos)**: Define quanto tempo o Chat Center deve esperar por uma resposta do seu servidor confirmando que recebeu o dado. Se o seu sistema for lento para processar, aumente esse valor para evitar erros de "timeout".

**URL de Retorno (Callback)**: Campo opcional. É utilizado caso o seu sistema precise enviar uma resposta de confirmação para uma URL específica após processar o Webhook.

Para concluir a configuração da sua **API de Saída (Webhook)**, é fundamental selecionar corretamente os gatilhos. Cada checkbox marcado define qual ação dentro do Chat Center fará com que a plataforma dispare automaticamente os dados para o seu sistema externo.

Com base na imagem enviada, aqui está a lista completa de todos os gatilhos disponíveis e o que cada um representa:

**Gatilhos de eventos**

* **Status do telefone:** Notifica mudanças no estado de conexão do aparelho ou canal.
* **Conversa entre agentes**: Dispara dados quando ocorre uma interação interna (chat) entre dois operadores.
* **Aceita atendimento da espera**: Avisa quando um agente retira um cliente da fila e inicia o diálogo.
* **Transferência de atendimento**: Notifica quando um cliente é movido de um departamento ou agente para outro.
* **Aceitar conferência:** Dispara um alerta quando um terceiro agente entra em uma conversa já existente.
* **Pausa iniciada**: Informa o momento exato em que um agente ativa o status de pausa na plataforma.
* **Login do agente**: Notifica quando um operador entra no sistema.
* **Contato na espera**: Dispara um aviso sempre que um novo cliente entra na fila aguardando atendimento (útil para dashboards de tempo real).
* **Mensagem do cliente:** Envia cada mensagem recebida do cliente para o seu sistema externo.
* **Atendimento finalizado**: O gatilho principal envia o resumo e histórico assim que a conversa é encerrada.
* **Convite para conferência**: Avisa quando um agente solicita a entrada de outro colega na conversa.
* **Finalizar conferência:** Notifica o encerramento de uma interação conjunta entre múltiplos agentes.
* **Pausa finalizada**: Informa quando o agente encerra seu intervalo e volta a ficar disponível.
* **Logoff do agente**: Notifica quando o operador desconecta do sistema.
* **Atendimento automático iniciado**: Avisa quando o robô (automação) assume a interação com o cliente.

Após completar os campos e selecionar os eventos, basta clicar em **salvar** para criar o webhook. Após salvar, você será redirecionado para a lista de APIs cadastradas com a nova API na lista.

<br>


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/configuracao-de-webhook-api-de-saida.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.