Skip to main content
All CollectionsAssistants
Deploying assistants via Embed
Deploying assistants via Embed

Embed Cassidy assistants on your website

Jake Rosenthal avatar
Written by Jake Rosenthal
Updated over 3 weeks ago

How to deploy assistants via Embed

To seamlessly integrate Cassidy assistants into your application via embed, follow these step-by-step instructions:

  1. Navigate to the Assistants page: Click on the "Assistants" tab in the left sidebar to access your list of assistants.

  2. Select the assistant: Choose the assistant you want to deploy via embed by clicking on its card or opening the ellipses (more options) menu and selecting "Edit."

  3. Access the External Deployments tab: In the assistant's settings, navigate to the "External Deployments" tab, then click on "Deploy via Embed" in the sidebar.

  4. Enable embedded chat deployment: Toggle on "Enable Embedded Chat Deployment".

  5. Whitelist domains (optional): Click "Add Whitelisted Domain" to specify which domains are allowed to embed the assistant. You can add multiple domains and remove them as needed.

  6. Enter assistant display name: In the "Assistant Display Name" field, type in the name that will appear in the embedded chat. This name will be visible to users interacting with the assistant on your website.

  7. Customize the first message: In the "First Message" field, enter the initial message that greets users when they open the embedded chat. This message can be used to welcome visitors, provide a brief introduction to the assistant's capabilities, or prompt users to ask a question.

  8. Choose reference mode: Select the appropriate "Reference Mode" for your use case:

    • Disable References: Your assistant will not include any references in its responses.

    • Public Sources Only: Your assistant will include references only to publicly accessible sources, such as web pages.

    • Include All References (Default): Your assistant will provide references to all documents, including private ones, but users will need proper permissions to view them.

    • Generate Public Links: Your assistant will create public URLs for any referenced documents. Caution: This could expose sensitive information. Make sure your assistant does not have access to private documents.

  9. Save settings: Click the "Save Settings" button to apply your configuration changes.

  10. Copy embed code: In the "Embed Code" section, choose between the "Static IFrame Embed" or "Modal" options:

    • Static IFrame Embed: This option will display the Cassidy chat component directly on your website, always visible on the screen. It's ideal for providing quick access to the assistant without requiring user interaction.

      Example code snippet

      Preview on sample website

    • Modal: This option provides a button that, when clicked, will open the Cassidy chat as an overlay on top of your website's content. This is suitable for cases where you want to offer the assistant's help without taking up permanent space on the page.

      Example code snippet

      Preview on sample website

    Copy the provided code snippet for your chosen embed method. You can click "Preview" to see what the embedded chat will look like.

  11. Add to your website: Paste the embed code into your website's HTML where you want the chat to appear. If you're using a website builder, add the code to a custom HTML block or follow their instructions for embedding third-party scripts.

By following these steps, you can easily embed your Cassidy assistant on your website, allowing visitors to interact with it directly. This integration enables you to provide instant support, automate tasks, and enhance user engagement.

Did this answer your question?