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

# Testar

> Ponha um evento de teste na fila do webhook e veja a entrega no minuto seguinte, com o código HTTP e a duração.

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

> [tab] Pela tela
>
> 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.

> [tab] Pela API
>
> ```bash theme={null}
> 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:

```json theme={null}
{
  "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](https://docs.westhetics.io/webhooks/verificar-assinatura.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.