docs: add cal integration (#195)

Author: vachmara

apps/docs/components/sidebar-content.tsx

@@ -8,6 +8,7 @@ import {
 	FileTextIcon,
 	FlagIcon,
 	GlobeIcon,
+	CalendarIcon,
 	GoogleLogoIcon,
 	type IconWeight,
 	KeyIcon,
@@ -136,6 +137,11 @@ export const contents: SidebarSection[] = [
 				href: "/docs/Integrations/framer",
 				icon: PaletteIcon,
 			},
+			{
+				title: "Cal.com",
+				href: "/docs/Integrations/cal",
+				icon: CalendarIcon,
+			},
 			{
 				title: "Google Tag Manager",
 				href: "/docs/Integrations/gtm",

apps/docs/content/docs/Integrations/cal.mdx

@@ -0,0 +1,45 @@
+---
+title: Cal.com
+description: Track and analyze user behavior from your website to your Cal.com scheduling pages with Databuddy.
+---
+
+Integrate **Databuddy** with your **Cal.com** scheduling pages to gain insights into user behavior and improve your booking performance.
+
+> **TL;DR:** Connect your Cal.com account to Databuddy using your Client ID.
+
+---
+
+## How to set up Databuddy with Cal.com
+
+1. Go to your [Databuddy dashboard](https://app.databuddy.cc) and copy your **Client ID**.
+2. Log in to your [Cal.com account](https://app.cal.com).
+3. Open the [**Databuddy App**](https://app.cal.com/apps/databuddy) in the App Store.
+4. Click **Install App**.
+5. Activate it on each event page you want to track by adding your **Client ID**.
+   > For self-hosted setups, you can also provide your **API URL** and **Script URL** [see details](/docs/Integrations/cal#for-self-hosted-databuddy-users).
+
+That’s it! Your Cal.com pages are now connected to Databuddy.
+
+---
+
+## For self-hosted Databuddy users
+
+If you’re using a self-hosted version of Databuddy:
+
+1. Enter your **Client ID**, **API URL**, and **Script URL** during setup.
+2. Save and complete the installation.
+
+---
+
+## Use case
+
+You can use the **same Client ID** across your **main website** and **Cal.com booking pages** to track full user journeys.
+
+Example:
+
+- A visitor lands on `yourwebsite.com/pricing` → clicks “Book a demo” → schedules via your Cal.com page.
+- In Databuddy, you can setup with page view your [**funnel**](/docs/dashboard#funnel-analysis), allowing you to measure drop-off, setup goals and optimize conversions.
+
+---
+
+Start tracking smarter today with [Databuddy × Cal.com](https://app.cal.com/apps/databuddy).

apps/docs/content/docs/Integrations/meta.json

@@ -9,6 +9,7 @@
     "shopify",
     "stripe",
     "framer",
+    "cal",
     "gtm"
   ]
 }