Talki

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.

1

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.

2

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)
3

Add the snippet to your site

Paste this before the closing </body> tag. Replace the placeholder values with your real credentials.

html
<!-- 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

For React/Next.js apps, add the script in your root layout or _document.tsx. The widget docs have a Next.js example.
4

(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.

javascript
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.

5

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.