Connectors and Integrations

The raia platform is designed to sit at the center of your existing technology stack. Rather than replacing your tools, raia connects to them. We organize these connections into four distinct categories.

The most common integration task is deploying the raia Live Chat widget to a website or web application. There are two ways to do this.

The JS SDK (Recommended)

For 95% of deployments, the JS SDK is the correct choice. You paste a single <script> tag into your HTML just before the closing </body> tag. The script automatically injects the floating chat launcher and handles all UI rendering.

<script
  async
  src="https://raiabot.raia2.com/assets/raia-chatbot-widget.js"
  data-api-key="YOUR_AGENT_ID">
</script>

Note: The data-api-key attribute requires your Agent ID, not an API key.

The iFrame SDK (Advanced)

If you are building a custom web application and need the chat interface to sit inline within a specific <div> rather than floating over the page, use the iFrame SDK. This gives you complete layout control while raia still handles the chat rendering inside the frame.

If you deploy the widget using only the basic script tag, anyone who inspects your source could theoretically copy your Agent ID and embed your agent on their own website. To prevent this, you must implement a Security Key.

When you generate a Security Key in raia Command, your chat widget is immediately blocked from loading anywhere until that key is passed during initialization. Pass the key via the onload attribute on the script tag:

<script>
  async function onRaiaChatLoaded() {
    raiaChat.sendCommand("INIT", {
      apiKey: "YOUR_SECURITY_KEY_HERE"
    });
  }
</script>

<script
  async
  src="https://raiabot.raia2.com/assets/raia-chatbot-widget.js"
  data-api-key="YOUR_AGENT_ID_HERE"
  onload="onRaiaChatLoaded()">
</script>

A secure, embedded chat is good, but a context-aware chat is better. If a user is logged into your application, pass their identity to the agent so they do not have to introduce themselves. Once the widget is loaded, use the SET_USER command:

raiaChat.sendCommand("SET_USER", {
  user: {
    firstName: "Jane",
    email: "jane.doe@example.com",
    fkId: "customer-12345",
    customData: {
      plan: "Premium",
      isLoggedIn: true
    }
  }
});