Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jurichat.com/llms.txt

Use this file to discover all available pages before exploring further.

Os webhooks permitem que sua aplicação receba notificações automáticas sempre que eventos importantes acontecerem dentro do JuriChat. Com eles, você pode integrar CRMs, automações, ERPs, planilhas, bots e sistemas internos em tempo real.
Os endpoints relacionados à criação e gerenciamento de webhooks estão disponíveis em API Reference.

Como funciona

Quando um evento configurado acontece, o JuriChat envia uma requisição POST para a URL configurada por você. O payload é enviado em formato JSON contendo os dados do evento.

1. Evento acontece

Um evento é disparado dentro do JuriChat.

2. Webhook enviado

O JuriChat envia uma requisição POST para sua URL.

3. Seu sistema processa

Sua aplicação recebe e processa o payload enviado.

4. Confirmação

Sua API responde com status HTTP 2xx.

Requisitos da sua aplicação

Para garantir o funcionamento correto dos webhooks:

HTTPS

Utilize HTTPS para receber eventos com segurança.

Resposta rápida

Seu endpoint deve responder em até 30 segundos.

Status 2xx

Retorne qualquer status HTTP 2xx para confirmar o recebimento.

JSON

Sua aplicação deve aceitar payloads JSON.

Cabeçalhos enviados

Cada webhook enviado pelo JuriChat contém headers adicionais.
HeaderDescrição
X-JuriChat-EventNome do evento
X-JuriChat-SignatureAssinatura HMAC SHA256
X-JuriChat-DeliveryID único da entrega
X-JuriChat-TimestampTimestamp da tentativa
Content-TypeSempre application/json

Exemplo de payload

{
  "event": "message.created",
  "timestamp": "2026-05-09T12:00:00Z",
  "data": {
    "id": "msg_123",
    "conversationId": "conv_456",
    "content": "Olá, preciso de ajuda",
    "createdAt": "2026-05-09T12:00:00Z"
  }
}

Política de retry

Caso sua aplicação não responda corretamente, o JuriChat tentará reenviar o webhook automaticamente.
1

1ª tentativa

Reenvio após 5 minutos.
2

2ª tentativa

Reenvio após 30 minutos.
3

3ª tentativa

Reenvio após 2 horas.
Após as tentativas de retry, o webhook será marcado como falho.