CX Assistant Integration

1. Introduction

This documentation describes how to integrate the CX Assistant into your platform via iframe, allowing your users to access the support assistant directly within the logged-in area of your system.

Why integrate the CX Assistant? By embedding the assistant in your application, you provide instant 24/7 support to your users without them having to leave the platform. This significantly reduces the volume of basic support tickets (up to 70%), accelerates onboarding of new users, and improves overall satisfaction while your team can focus on more complex and strategic cases. The result is a smoother experience for the user and more efficient operations for your company.

2. Adding the iframe

Use the following URL for integration:

https://cx-agent.gke-prd.solucx.com.br/{your-instance}/chat/

2.1 Implementation Example

<iframe
  src="https://cx-agent.gke-prd.solucx.com.br/{your-instance}/chat/"
  width="100%"
  height="600"
  frameborder="0"
></iframe>

3. Automatic Authentication via Cookies

The CX Assistant uses transparent authentication through SoluCX session cookies.

3.1 Authentication Flow

  1. User logs into the SoluCX platform
  2. Authentication cookies are established
  3. When loading the iframe, cookies are sent automatically
  4. CX Assistant validates the session
  5. Chat opens in the context of the authenticated user

3.2 Advantages of this Approach

  • Zero additional implementation on your platform
  • No token manipulation required

3.3 Technical Requirements

  • The iframe must be in the logged-in area of the application
  • Cross-domain cookie sending enabled (already configured)

4. Support and Questions

For questions about implementation or testing, contact the SoluCX team.

CSV
Base files with CSV extension are spreadsheets where data is standardized and separated by commas, instead of using columns.
Security FAQ