How can we help?
Practical guides for your account, your team and your chat widget.
Getting started
Install the chat widget
Add SupportWhale to HTML, React or Nuxt and choose which domains may load it.
Account
Appearance and dark mode
Choose a comfortable appearance for SupportWhale and your chat widget.
Delete your account
Remove your personal account while protecting organizations that still need an owner.
Opening hours and away replies
Set weekly hours, holidays and an automatic reply for your workspace.
Team & organization
Create another organization
Keep teams, a widget and conversations separate under one login.
Delete an organization
Permanently remove an organization and schedule its customer data for deletion.
Invite and manage teammates
Manage invitations, roles and organization access.
Format chat messages
Use the formatting toolbar in your inbox and customer chat.
Transfer organization ownership
Let an active teammate accept responsibility for an organization.
API & integrations
Your first API integration
Read organization conversations from your own server.
Create an API key
Create a secret for one organization and one integration.
Restrict API access
Understand organization, widget and domain boundaries.
Rotate or revoke an API key
Replace secrets and stop access immediately.
Manage API scopes
Give each integration only the access it needs.
Realtime event contract
Socket.IO subscriptions, authorization and reconnection.
API reference
Explore the public REST API, authentication and response contracts.