Docs

Quick Start

Add the Respondo chat widget to your website in under 2 minutes.

1

Add the script

Paste this snippet before </body> on every page where you want the widget:

HTMLhtml
<script>
  window.Respondo = window.Respondo || {};
  Respondo.init = Respondo.init || function(c) {
    window.RespondoAIConfig = c;
  };
  Respondo.init({
    agentId: 'YOUR_AGENT_ID'
  });
</script>
<script src="https://api.respondo.ai/widget/widget.js" async></script>
Replace YOUR_AGENT_ID with the Agent ID from your channel settings. The widget loads asynchronously and won't affect page performance.
2

Identify users (recommended)

After the user logs in, call identify() to link chat sessions to their profile:

JavaScriptjavascript
Respondo.identify({
  email: 'user@example.com',
  name: 'John Doe',
  userId: 'usr_12345',       // your internal user ID
  metadata: {                // any custom fields
    plan: 'premium',
    company: 'Acme Inc'
  },
  properties: {              // custom contact properties (defined in Agent Settings)
    account_type: 'enterprise',
    region: 'eu-west'
  }
});

Done!

The widget will appear in the bottom-right corner. All conversations flow into your Conversations dashboard automatically.