Waterr Ai Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.waterr.ai/api-reference/webhooks.md
sources:
- https://docs.waterr.ai/api-reference/webhooks.md
- https://docs.waterr.ai/capabilities/notifications.md
- https://docs.waterr.ai/api-reference/meeting-events.md
- https://docs.waterr.ai/api-reference/live-website-events.md
description: Waterr AI provides per‑account webhooks that POST JSON payloads to a configured HTTPS endpoint. Each delivery includes a `Waterr-Signature`
  header containing a timestamp (`t`) and an HMAC‑SHA256 (`v1`) computed over `${t}.${rawBody}` using the endpoint’s `signing_secret`. Deliveries
  are signed with replay protection and are retried durably until they succeed, with an audit log per attempt.
events:
- event: meeting.created
  description: A meeting row is created via `POST /v1/meetings`.
- event: meeting.ended
  description: Meeting's `ended_at` is set (before analysis runs).
- event: participant.joined
  description: A participant's `joined_at` transitions from null → set.
- event: participant.left
  description: A participant's `left_at` transitions from null → set.
- event: transcript.ready
  description: Full sentenced transcript is persisted.
- event: recording.ready
  description: Video recording row is created (Daily.co finished upload).
- event: session.analysis_complete
  description: AI analysis with goal scores is saved.
- event: analysis.failed
  description: Analysis pipeline threw an error.
- event: meeting.started
  description: The first participant's client is ready to hear the agent.
- event: screen_share.started
  description: A participant starts sharing their screen.
- event: screen_share.stopped
  description: A participant stops sharing their screen or leaves while sharing.
- event: camera.on
  description: A participant's camera turns on.
- event: camera.off
  description: A participant's camera turns off.
- event: stage.opened
  description: A screen app is put on the stage.
- event: stage.closed
  description: A screen app is closed.
- event: stage.interaction
  description: A participant interacts with the presented screen app.
delivery:
  signature: 'Waterr-Signature header with HMAC‑SHA256 using the endpoint''s `signing_secret` (format: t=timestamp,v1=hex)'
  retries: Durable retries per endpoint with an audit log; deliveries are retried until a 2xx response is received.
docs: https://docs.waterr.ai/api-reference/webhooks.md