Testar - Westhetics · Desenvolvedores

Antes de esperar um evento de verdade, teste o endereço e a verificação da assinatura com o evento webhook.test.

Pela tela
Pela API

No app, em Integrações, abra a aba Webhooks e toque em Enviar teste no webhook. O teste entra na fila e sai no próximo minuto; a entrega aparece na aba Entregas com o código HTTP que o seu endereço respondeu e quanto tempo levou. Um teste por vez: enquanto o anterior está na fila, o novo é recusado com 409.

curl -X POST https://api.westhetics.io/v1/webhooks/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f/test \
  -H "Authorization: Bearer $WESTHETICS_API_KEY"

A resposta (201) é a entrega, ainda pendente: ela sai no próximo minuto. Acompanhe em GET /v1/webhooks/{id}/deliveries. Com outro teste do mesmo webhook ainda na fila, 409.

O que chega:

{
  "id": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
  "type": "webhook.test",
  "createdAt": "2026-10-15T14:40:00Z",
  "clinicId": "0b9a8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d",
  "actor": { "type": "user", "id": "8a7b6c5d-4e3f-4a2b-9c1d-0e9f8a7b6c5d" },
  "data": {
    "webhookId": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
    "message": "Evento de teste da Westhetics. Responda com 2xx."
  }
}

O teste vai só para este webhook, e só se ele estiver ativo.
webhook.test não aparece em GET /v1/events e não precisa constar na lista de eventos do webhook.
O teste é assinado como qualquer entrega: é a melhor hora de conferir o seu código de verificação.

Desenvolvendo na sua máquina

O endereço precisa ser https:// público, na porta 443. Para receber na sua máquina, use um túnel que publique um endereço https:// e aponte para o seu servidor local. Endereços localhost, IP e .local não são aceitos.