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
- Configure a URL do seu servidor usando o endpoint correspondente ao tipo de evento desejado
- A Bliper API enviará uma requisição POST para essa URL sempre que o evento ocorrer
- O payload da requisição será um JSON com os dados do evento
- 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.Todos os webhooks recebem requisições POST com payload JSON no URL configurado.