Docs
Dorna Chats is a separate product from Dorna Forms and Dorna Ads Manager. Later we can optionally forward conversations into Dorna’s lead inbox — that is not built here.
Two hostnames
- chats.dorna.dev — public website and API. Host the SDK and conversation endpoints. Map this name to Cloud Run.
- notifications.dorna.dev — mail identity only. Emails are sent from
<chats@notifications.dorna.dev>. Do not point this name at the app.
Paste the snippet
<script
src="https://chats.dorna.dev/v1/sdk.js"
data-site-key="pk_…"
data-inbox="inbox_…"
></script>Theming
The bubble follows the OS theme by default. Force a palette with data-theme="light|dark" and tint the bubble, header, and buttons with data-accent="#0f766e" (any #rgb / #rrggbb; text ink is picked for contrast). The Turnstile widget matches the theme. For full control, override the --dc-bg, --dc-surface, --dc-ink, --dc-muted, --dc-line, --dc-card, --dc-input, --dc-accent, --dc-accent-ink, --dc-online, and --dc-danger variables on #dorna-chats-root in your own CSS.
<script
src="https://chats.dorna.dev/v1/sdk.js"
data-site-key="pk_…"
data-inbox="inbox_…"
data-theme="dark"
data-accent="#0f766e"
></script>Widget options
Set the header copy with data-title and data-subtitle, and dock the widget on either side with data-position="left|right".
<script
src="https://chats.dorna.dev/v1/sdk.js"
data-site-key="pk_…"
data-inbox="inbox_…"
data-title="Acme support"
data-subtitle="Typically replies in minutes"
data-position="left"
></script>Sites console
Open /admin to add, change, or remove sites. Sign in with Google; only allowlisted owner emails can get in. Creating a site also creates a Website chat inbox and a public key for the snippet.
Create a site
curl -s https://chats.dorna.dev/v1/admin/sites \
-H "authorization: Bearer $CHATS_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{
"name": "Dorna Studio",
"allowed_origins": ["https://studio.dorna.dev"],
"notify_emails": ["hello@studio.dorna.dev"]
}'Then create an inbox under that site. Modes: hybrid (default), ai, human.
Public API
- POST /v1/conversations
- POST /v1/conversations/:id/messages
- GET /v1/conversations/:id/messages
- POST /v1/conversations/:id/handoff
- POST /v1/conversations/:id/new-chat
- GET /v1/sdk.js
- POST /v1/webhooks/resend
- GET /v1/console-config
- GET /health (also GET /v1/health)
DNS for Resend
Reuse the domain already verified for Forms: notifications.dorna.dev. Add the chats@ sender. SPF, DKIM, and DMARC stay on that name. Keep chats.dorna.dev DNS-only on Cloudflare so Google can issue the Cloud Run certificate.
Cloud Run
us-central1, min instances 0, max 2, 512Mi, 1 CPU. Secrets in Secret Manager: TURNSTILE_SECRET, TURNSTILE_SITE_KEY, RESEND_WEBHOOK_SECRET, CHATS_ADMIN_EMAILS, FIREBASE_WEB_CONFIG_JSON, plus optional RESEND_API_KEY, CHAT_TOGETHER_API_KEY, and CHAT_NVIDIA_API_KEY. Firestore via the service's attached service account. Apart from the Resend and AI keys, every secret is required; the service fails closed when one is missing.