Web Widget

Seamlessly integrate AI Agent into your website to provide visitors with conversational assistance, calls, and voice-to-text.

Embed AI Agent on your website.

General

• Audio Transcription - Enables converting voice inputs into text directly within the widget.

• AI Web Call - Allows users to make calls directly from the web widget. Activating this feature consumes platform credits.

• AI Agent Position - Adjust the AI Agent's position on your website as needed.

  Enable voice-to-text, calls, and adjust your AI Agent's position easily.

• Draggable - Enables users to drag and reposition the AI Agent widget on the screen.

• Mobile Device Visibility - Ensures the widget is accessible and functional for users on mobile devices.

  Enable voice-to-text, calls, and adjust your AI Agent's position easily.

• Logged In Users Only - When the Logged In Users Only toggle is enabled, the widget will only be visible to users who have signed in. This ensures that only authenticated users can access the widget.

  Enable Logged In User toggle

  • Set User - To activate this feature, use the setUser event to provide user details for authentication. If the details are not passed, the user will not be able to interact with the AI Agent chatbot.

    window?.copilot?.users.set({
    hostId: "12312", // Mandatory
    email: "example@gmail.com",
    name: "Smith",
    additionalFields: {
        orgId: 123,
    },
    });
    
    // Either `email` or `name` (or both) must be provided along with `hostId` for user identification.

    Field	DataType	Description
    hostId	String	Unique identifier assigned to each user (mandatory).
    email	String	User’s email address. Optional but useful for identification and communication.
    name	String	User’s full name. Used to personalize interactions.
    phone	Integer	User’s phone number. Optional but useful for contact purposes.
    profilePicUrl	String	URL to the user’s profile picture. Optional but enhances user profiles visually.
    additionalFields	Object	Additional details like age, gender, or interests for improved chatbot responses.

  • Unset User - When a user logs out, use the unsetUser event to clear their session from the widget.

    window?.copilot?.users.unset();

• Resume Conversation - When enabled, the AI Agent resumes the last conversation with the user. If disabled, it starts a new conversation each time the page is opened.

• Allowed Domains and Paths - Define specific domains and paths where the widget is allowed to function. This helps maintain security and ensures the widget is only accessible from approved locations.

Embed Code

To add the AI Agent to your website, copy and paste the following code into your webpage:

Copy and paste this code to add the AI Agent to your website

Integrate AI Actions

Explore more about AI Actions — including Workflows, Web Client Action, and MCP Server — in the AI Actions Guide.

---

React Copilot Widget

For the official React integration and advanced usage, see the React Copilot Widget Guide.