​
Overview

Clerk Chat can run in a reduced form in other applications. This is very useful for creating a chat experience within your own app, a CRM such as Salesforce, or a ticketing system such as Zendesk.

​
How to embed the Clerk Chat App

To embed the Clerk Chat App, you first need a Clerk Chat account. You can sign up for a free account here.

Once you have an account, you can embed the Clerk Chat App into your own app using an iframe shown below.

<iframe src="https://app.clerk.chat" width="100%" height="100%"></iframe>

​
Authentication

To authenticate with the Clerk Chat App from your own application, you need to pass in a token parameter in the iframe URL. This token is a JWT that you can generate using the Clerk Chat API.

<iframe src="https://app.clerk.chat?k=your-jwt-token" width="100%" height="100%"></iframe>

​
Providing Context from CRMs

Clerk Chat integrates with a number of CRMs including Salesforce, Microsoft Dynamics and Hubspot. After enabling the integration, you can pass in context from your CRM to the Clerk Chat App. This is done by passing a externalContactId and that same param in the iframe URL.

<iframe src="https://app.clerk.chat?externalContactId=hubspotId&hubspotId=1234" width="100%" height="100%"></iframe>