ReferenciaGestão (painel)
Criar webhook de saída
O segredo HMAC é retornado **uma única vez** na criação. Use-o para validar a assinatura `X-HSDesk-Signature` das entregas.
Authorization
bearerAuth AuthorizationBearer <token>
Token JWT obtido via POST /api/auth/login
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/webhooks" \ -H "Content-Type: application/json" \ -d '{ "nome": "Produção ERP", "url": "https://parceiro.com/webhooks/hsdesk", "eventos": [ "ticket.resposta_publica" ] }'{ "success": true, "message": "Webhook criado. Guarde o segredo: ele não será exibido novamente.", "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "nome": "Produção ERP", "url": "https://parceiro.com/webhooks/hsdesk", "eventos": [ "ticket.resposta_publica" ], "ativo": true, "criado_em": "2019-08-24T14:15:22Z", "atualizado_em": "2019-08-24T14:15:22Z", "segredo": "whsec_AbCdEf12GhIjKl34MnOpQr56StUvWx78YzAbCd90" }, "errors": []}{ "success": false, "message": "Erro de validação", "errors": { "nome": [ "O campo nome é obrigatório." ], "categoria": [ "O campo categoria é obrigatório." ] }}{ "success": false, "message": "Não autenticado.", "status": 401, "data": null, "errors": { "field": "token", "message": "Token ausente, inválido ou expirado." }}{ "success": false, "message": "Acesso negado.", "status": 403, "data": null, "errors": { "field": "permissao", "message": "Você não tem permissão para esta ação." }}