> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de voz

> Registre uma URL para receber um aviso a cada evento de chamada da sua organização.

Os **webhooks** avisam os seus sistemas sempre que ocorre um evento de chamada. A Jelou envia uma requisição `POST` para a URL que você registrar, o que permite levar o resultado de cada chamada ao seu CRM, ao seu data warehouse ou a qualquer fluxo interno sem precisar consultar o registro manualmente.

Ficam na aba **Webhooks** do Voice.

<Frame caption="Aba Webhooks com uma URL registrada">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/centro-de-voz-webhooks.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=a1d7bce3b802af564b17d81194e4426f" alt="Seção Registrar um webhook com o campo de URL e o botão Registrar, e abaixo a tabela de webhooks com URL, tipo e data de criação" width="1917" height="1065" data-path="assets/images/voice/centro-de-voz-webhooks.png" />
</Frame>

## Registrar um webhook

Você cola a URL do seu endpoint no campo e confirma com **Registrar**. A Jelou enviará uma requisição `POST` para essa URL a cada evento de chamada da sua organização.

A tabela abaixo lista os webhooks já registrados com três dados:

| Coluna     | Conteúdo                                                    |
| ---------- | ----------------------------------------------------------- |
| **URL**    | O endpoint que recebe os eventos.                           |
| **Tipo**   | A categoria de eventos que ele recebe, por exemplo `calls`. |
| **Criado** | Quando foi registrado.                                      |

<Note>
  O alcance é **toda a organização**, não um agente ou um número específico. Um webhook registrado aqui recebe os eventos de chamada de todos os seus agentes.
</Note>

## Preparar o seu endpoint

O seu endpoint deve aceitar requisições `POST` com corpo JSON e responder rápido. Algumas considerações que valem para qualquer receptor de webhooks:

**Responda antes de processar.** Devolva uma resposta de sucesso assim que receber o evento e faça o trabalho pesado de forma assíncrona. Se o seu endpoint demorar, você arrisca novas tentativas e duplicatas.

**Projete para a idempotência.** Um mesmo evento pode chegar mais de uma vez diante de uma falha temporária. Use o identificador da chamada ou da conversa para reconhecer o que já processou.

**Use HTTPS e não confie apenas no segredo da URL.** O painel não expõe um segredo de assinatura nem documenta um cabeçalho de verificação, portanto a URL é a única coisa que separa o seu endpoint do exterior. Proteja-o por conta própria: use um caminho difícil de adivinhar, restrinja o acesso por IP se a sua arquitetura permitir e trate tudo o que receber como não confiável até validar contra os seus próprios dados.

<Note>
  Se você precisa de verificação criptográfica da origem, confirme com a equipe da Jelou antes de construir sobre este webhook: não há um mecanismo de assinatura documentado nesta tela.
</Note>

**Registre o que recebe.** Guardar o evento cru junto com a resposta que você deu economiza muito tempo quando algo não fecha.

<Warning>
  Os eventos de chamada podem incluir dados da conversa e do interlocutor. Trate o endpoint e o que você armazenar com o mesmo cuidado que qualquer outro dado pessoal dos seus clientes.
</Warning>

## O que fazer com os eventos

O evento de fim de chamada é o ponto natural para fechar o ciclo com os seus sistemas: registrar o resultado do contato, atualizar o estado de um caso ou disparar o próximo passo de um processo.

Se você definiu [critérios de avaliação e coleta de dados](/pt/guias/voice/analysis) no agente, essa análise é o que transforma uma chamada em um registro utilizável: o motivo do contato, a classificação do resultado, se houve transferência.

<Tip>
  Antes de construir a integração completa, registre um endpoint que apenas guarde o corpo da requisição e faça uma [chamada de teste](/pt/guias/voice/numbers). Ver um evento real é mais rápido que deduzir a forma dele.
</Tip>

## Pelo CLI

<Card title="jelou voice webhooks" icon="terminal" href="/pt/guias/cli/voice">
  Liste, consulte, crie e exclua webhooks pelo terminal, indicando o tipo de evento.
</Card>
