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

# Webhooks

> Visão geral dos webhooks da Bliper API

## Descrição

Webhooks são notificações HTTP enviadas automaticamente pela Bliper API para o seu servidor sempre que um evento ocorre na instância. Ao configurar uma URL de webhook, você receberá requisições POST com payload JSON contendo os dados do evento em tempo real.

## Tipos de Webhook

A Bliper API suporta 7 tipos de webhooks, cada um associado a um evento específico:

| Webhook             | Evento                       | Endpoint de configuração          |
| ------------------- | ---------------------------- | --------------------------------- |
| Delivery            | Mensagem entregue            | /update-webhook-delivery          |
| Received            | Mensagem recebida            | /update-webhook-received          |
| Received + Delivery | Mensagem recebida e entregue | /update-webhook-received-delivery |
| Disconnected        | Instância desconectada       | /update-webhook-disconnected      |
| Connected           | Instância conectada          | /update-webhook-connected         |
| Message Status      | Status de mensagens          | /update-webhook-message-status    |
| Chat Presence       | Presença no chat             | /update-webhook-chat-presence     |

## Como funciona

1. Configure a URL do seu servidor usando o endpoint correspondente ao tipo de evento desejado
2. A Bliper API enviará uma requisição POST para essa URL sempre que o evento ocorrer
3. O payload da requisição será um JSON com os dados do evento
4. Seu servidor deve responder com status HTTP 200 para confirmar o recebimento

## Configuração

Cada tipo de webhook é configurado individualmente através de seu respectivo endpoint. Consulte as páginas de cada webhook para ver exemplos de configuração e os payloads enviados.

<Note>Todos os webhooks recebem requisições POST com payload JSON no URL configurado.</Note>
