Werkmail Docs
Contents

Guides

Practice mail

Werkmail treats typical practice outbound as first-class kinds — not generic marketing.

Kinds and channels

Kind Channel Default tracking Legal basis hint
termin termin off contract
recall recall off contract
doi newsletter off consent
newsletter newsletter on consent
transactional transactional off contract
quality transactional off contract

GET /api/practices/{id}/practice-semantics returns the same table plus default channel preferences.

Compliance check

POST /api/practices/{id}/practice-mail/check

json
{ "kind": "termin", "subject": "Ihre Terminbestätigung", "text": "…", "html": "…" }

Returns kind hints plus issues (error / warn / info). This is a vertical review on top of the inbox-risk score (POST …/send/score). Appointment mail must not mix discounts; recall stays clinical; DOI asks for confirmation.

Presets

POST /api/practices/{id}/presets/seed writes German starters (tracking off except newsletter). Re-run is safe.

Practice-management systems (PVS)

There is no vendor SDK. Connect the systems you already run:

  1. ICS — pass calendar on send, or use Send → Integrations → Test Termin + ICS
  2. Inbound send hookPOST /api/public/hooks/{id}/send with message_kind and X-Werkmail-Hook-Secret
  3. Recipesdocs/integrations (n8n form → DOI, calendar → Termin, bounce → Slack)

That is the vertical moat: kinds + consent + presets + checks + hooks, not a locked-in PVS connector.

View this page as Markdown · llms.txt · full corpus