POST
/webhookDefine a configuração de webhook
Descrição
Define a URL de webhook da conexão e quais eventos serão enviados para ela.
O corpo aceita Webhook (URL de destino) e Subscribe (lista de eventos).
Eventos disponíveis:
| Evento | O que envia |
|---|---|
All | Todos os eventos abaixo de uma só vez. |
Message | Mensagens recebidas e enviadas: texto, mídia, áudio, botões, listas e reações. |
ReadReceipt | Confirmações de entrega e de leitura das mensagens enviadas. |
Presence | Contato ficou online/offline ou atualizou o "visto por último". |
ChatPresence | Indicadores dentro da conversa: "digitando…" e "gravando áudio…". |
HistorySync | Carga do histórico após conectar: conversas, contatos, grupos e participantes. |
Call | Chamadas recebidas: oferta, aceite, rejeição e encerramento. |
Newsletter | Atualizações de canais/newsletters acompanhados pela conexão. |
Enviar ["All"] substitui qualquer seleção individual. Para trocar apenas os eventos, sem
reconectar a sessão, use POST /session/update-events.
Parâmetros
Corpo da requisição
| Nome | Tipo | Localização | Obrigatório |
|---|---|---|---|
WebhookURL | string | body | Sim |
Exemplo de requisição
curl -X POST 'https://api-server.dichat.com.br/webhook' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"Subscribe": [
"All"
],
"Webhook": "https://meu-site.com.br/webhook"
}'Testar endpoint
...
Respostas
200Response
application/json
{
"code": 200,
"data": {
"webhook": "https://example.net/webhook"
},
"success": true
}