Add a Custom Modal Trigger to your Webflow site

What is Webflow

Webflow is a visual web development platform that enables users to design, build, and launch websites without the need for coding.

Get an API key

Go to the Inkeep Dashboard
Select your project under Projects
Go to the Integrations tab
Click on Create integration
Select Web
Provide a Name.
Specify a URL for where this integration will be used.
For production API keys, leave Enforce referrer URL checked.
Click on Create
Click the Example < /> button to get your API key and view suggested settings

For local or staging API keys, see here.

Connect the script

Navigate to Site settings (not the designer)
Open the Custom code tab
Add the below to the Head code section

<script
  id="inkeep-script"
  type="module"
  src="https://cdn.jsdelivr.net/npm/@inkeep/cxkit-js@0.5/dist/embed.js"
  defer
></script>

Create a trigger

You need to create a trigger in your application with ID - inkeepButton. This can be done using Webflow's built-in designer.

Example:

Click on the Footer code section and add the below script.

<script type="text/javascript" defer>
   const inkeepButton = document.getElementById("inkeepButton");
   const inkeepDiv = document.createElement("div");
 
   inkeepDiv.id = "inkeepModal";
   inkeepDiv.style.position = "absolute";
   document.body.appendChild(inkeepDiv);
 
   // configure and initialize the widget
   const config = {
     baseSettings: {
       apiKey: "INKEEP_API_KEY", // required
       primaryBrandColor: "#26D6FF", // your brand color, widget color scheme is derived from this
       organizationDisplayName: "Inkeep",
       // ...optional settings
     },
     searchSettings: {
       // optional settings
     },
     aiChatSettings: {
       // optional settings
       aiAssistantAvatar: "/img/logo.svg", // use your own ai assistant avatar
       exampleQuestions: [
         "Example question 1?",
         "Example question 2?",
         "Example question 3?",
       ],
     },
     modalSettings: {
       onOpenChange: handleOpenChange,
       // optional settings
     },
   };
 
   // Initialize the widget using the `Inkeep.ModalSearchAndChat()` function.
   const inkeepWidget = Inkeep.ModalSearchAndChat(config);
 
  function handleOpenChange(newOpen) {
    inkeepWidget.update({ modalSettings: { isOpen: newOpen } });
  }
 
   // Add click event listener to custom trigger
   document.getElementById("custom-trigger").addEventListener("click", () => {
     inkeepWidget.update({ modalSettings: { isOpen: true } });
   });
</script>

For a full list of customizations, check out the Custom Modal Trigger documentation.

Add a Custom Modal Trigger to your Webflow site

What is Webflow

Get an API key

Connect the script

Create a trigger

Initialize the widget

On this page