---
title: "Webhooks · API e MCP · Agendria"
description: "Situação dos webhooks de saída e como acompanhar uma reserva hoje."
last_updated: 2026-10-10
canonical: "https://agendria.com.br/desenvolvedores/webhooks"
---

# Webhooks · API e MCP · Agendria

[Desenvolvedores](/desenvolvedores)

[Referência](/desenvolvedores/referencia)

## Situação

Webhooks de saída ainda não existem

A Agendria não envia eventos para o seu servidor hoje. Não há URL para cadastrar, evento para assinar nem assinatura para verificar. Quando existirem, esta página traz os eventos, o formato e o código de verificação.

Enquanto isso, a API pública cobre o caso mais comum, saber se uma reserva com sinal foi paga, por consulta.

## Acompanhar uma reserva

Reservas com sinal nascem `pending` e trazem um Pix em `payment`, com `expires_at`. Consulte `getBooking` até o status mudar ou o Pix expirar.

- Consulte a cada 10 segundos, no máximo, e pare em `payment.expires_at`.
- Se o Pix expirar e o horário seguir livre, `renewPixCharge` gera outro.
- Sem pagamento, a reserva vira `expired` e o horário volta a ficar livre.

```
`async function waitForPayment(id, token, until) { while (Date.now() < until) { const b = await fetch(`${base}/shops/sandbox-agendria/bookings/${id}`, { headers: { "X-Booking-Token": token }, }).then((r) => r.json()); if (b.status !== "pending") return b; await new Promise((r) => setTimeout(r, 10_000)); } return null; }`
```

```
`import time, requests def wait_for_payment(booking_id, token, deadline): while time.time() < deadline: b = requests.get( f"{base}/shops/sandbox-agendria/bookings/{booking_id}", headers={"X-Booking-Token": token}, ).json() if b["status"] != "pending": return b time.sleep(10) return None`
```

Detalhes de limites e erros estão em [Limites e erros](/desenvolvedores/limites-e-erros).

## Quer ser avisado?

Se uma integração sua depende de eventos em tempo real, diga qual em [contato@agendria.com.br](mailto:contato@agendria.com.br). Isso ajuda a decidir o que sai primeiro.

## Sitemap

Veja o [mapa do site](https://agendria.com.br/sitemap.md) com todas as páginas em Markdown.
