Getting Started
Quick start
Add live support chat to any website in under 5 minutes. No frameworks, no build step — copy one snippet and you're live.
Create your Talki account
Sign up at talki.tech/login with Google. The onboarding flow takes under 60 seconds — you'll name your support organization and land on your Inbox.
Copy your Organization ID and API key
In your Console, go to Admin → API Keys. You'll see two values — copy both:
orgId— your organization's unique identifier (a UUID like 550e8400-e29b-41d4-a716-446655440000)apiKey— a public key used to authenticate the widget (safe to put in frontend code)
Add the snippet to your site
Paste this before the closing </body> tag. Replace the placeholder values with your real credentials.
<!-- Talki Widget -->
<script>
window.TalkiConfig = {
orgId: 'YOUR_ORG_ID',
apiKey: 'YOUR_PUBLIC_API_KEY',
};
</script>
<script src="https://cdn.talki.tech/widget.js" async></script>The script loads asynchronously — it won't block your page. The chat button appears in the bottom-right corner once it loads.
✦Framework users
_document.tsx. The widget docs have a Next.js example.(Optional) Pass user identity
If your users are logged in, pass their identity so operators immediately see who's writing — no need to ask for a name or email.
window.TalkiConfig = {
orgId: 'YOUR_ORG_ID',
apiKey: 'YOUR_PUBLIC_API_KEY',
// Pass logged-in user identity so operators see who's writing
identity: {
userId: currentUser.id,
name: currentUser.name,
email: currentUser.email,
},
};For full customer data enrichment (plan, MRR, custom fields) see Backend Connect.
Customize the widget
No re-deploy needed. Go to Admin → Widget Setup and configure:
- Brand color and logo
- Welcome message and bot name
- Position (bottom-right or bottom-left)
- Theme (auto / light / dark)
For full parameter reference see the Widget embed docs.
You're live
Customers now see a chat button on your site. Messages land in your Inbox in real-time. Reply, assign, and resolve from the Console — or let AI handle it automatically.
