|
| 1 | +--- |
| 2 | +title: 'Connect Routing Form Data to Booking Questions' |
| 3 | +--- |
| 4 | + |
| 5 | +# How to Connect Routing Form Data to Booking Questions |
| 6 | + |
| 7 | +When using Cal.com's routing forms to direct leads to the appropriate calendar, you might want the information collected in the routing form to be available in the booking details and calendar events. This guide explains how to connect routing form fields with booking questions to ensure data flows seamlessly from initial lead capture to final booking confirmation. |
| 8 | + |
| 9 | +--- |
| 10 | + |
| 11 | +## The Problem |
| 12 | + |
| 13 | +Users often face this scenario: |
| 14 | +- A routing form collects information from leads (company, department, specific needs, etc.) |
| 15 | +- The routing form directs them to the appropriate team member's calendar |
| 16 | +- The booking is created, but the original routing form data isn't associated with the booking |
| 17 | +- You receive booking notifications without context about how the lead originally found you |
| 18 | + |
| 19 | +This disconnect makes it difficult to: |
| 20 | +- Track lead sources and routing effectiveness |
| 21 | +- Understand attendee context before meetings |
| 22 | +- Maintain complete records of the customer journey |
| 23 | + |
| 24 | +--- |
| 25 | + |
| 26 | +## The Solution: Matching Identifiers |
| 27 | + |
| 28 | +Cal.com allows you to connect routing form fields to booking questions using **matching identifiers**. When both the routing form field and booking question use the same identifier, the data automatically flows from the routing form to the booking. |
| 29 | + |
| 30 | +### How It Works |
| 31 | + |
| 32 | +1. **Routing Form Collection**: User fills out routing form with company information |
| 33 | +2. **Automatic Transfer**: Data transfers to the booking form using matching identifiers |
| 34 | +3. **Booking Association**: Information appears in booking details and can optionally show in calendar events |
| 35 | + |
| 36 | +--- |
| 37 | + |
| 38 | +## Step-by-Step Implementation |
| 39 | + |
| 40 | +### Step 1: Set Up Your Routing Form Field |
| 41 | + |
| 42 | +When creating a field in your routing form, note the **identifier** you assign to it. |
| 43 | + |
| 44 | +**Example:** |
| 45 | +- **Field Label**: "What company are you with?" |
| 46 | +- **Field Identifier**: `company-name` |
| 47 | + |
| 48 | +### Step 2: Create a Matching Booking Question |
| 49 | + |
| 50 | +In your event type's booking questions section: |
| 51 | + |
| 52 | +1. Go to **Advanced** → **Booking Questions** |
| 53 | +2. Create a new booking question |
| 54 | +3. Use the **exact same identifier** as your routing form field |
| 55 | +4. Set the field type to match your routing form field |
| 56 | + |
| 57 | +**Example:** |
| 58 | +- **Question**: "Company Name" |
| 59 | +- **Identifier**: `company-name` *(must match routing form)* |
| 60 | +- **Type**: Text input |
| 61 | +- **Required**: Optional (depends on your needs) |
| 62 | + |
| 63 | +### Step 3: Choose Visibility |
| 64 | + |
| 65 | +You have two options for the booking question visibility: |
| 66 | + |
| 67 | +#### Option 1: Hidden Question (Recommended) |
| 68 | +- **Visibility**: Hidden |
| 69 | +- **Result**: Data flows automatically but doesn't show in calendar event |
| 70 | +- **Best for**: Internal tracking and booking details |
| 71 | +- **User Experience**: Seamless - no additional form fields for the user |
| 72 | + |
| 73 | +#### Option 2: Visible Question |
| 74 | +- **Visibility**: Visible |
| 75 | +- **Result**: Data appears in both booking details AND calendar event |
| 76 | +- **Best for**: Information needed during the actual meeting |
| 77 | +- **User Experience**: User sees pre-filled field they can modify if needed |
| 78 | + |
| 79 | +--- |
| 80 | + |
| 81 | +## Complete Example Workflow |
| 82 | + |
| 83 | +### Scenario Setup |
| 84 | +You want to track which department a lead is interested in and route them accordingly. |
| 85 | + |
| 86 | +### Routing Form Configuration |
| 87 | +``` |
| 88 | +Field: "Which department do you need help with?" |
| 89 | +Options: Sales, Support, Technical |
| 90 | +Identifier: department-interest |
| 91 | +``` |
| 92 | + |
| 93 | +### Booking Question Configuration |
| 94 | +``` |
| 95 | +Question: "Department" |
| 96 | +Identifier: department-interest |
| 97 | +Type: Select |
| 98 | +Options: Sales, Support, Technical |
| 99 | +Visibility: Hidden |
| 100 | +``` |
| 101 | + |
| 102 | +### User Experience |
| 103 | +1. **Lead visits routing form** → Selects "Sales" |
| 104 | +2. **Gets routed to sales team calendar** → Based on routing rules |
| 105 | +3. **Books appointment** → "Sales" is automatically captured |
| 106 | +4. **Booking details show** → Department: Sales |
| 107 | +5. **You receive notification** → With full context about the lead's interest |
| 108 | + |
| 109 | +--- |
| 110 | + |
| 111 | +## Best Practices |
| 112 | + |
| 113 | +### Identifier Naming |
| 114 | +- Use descriptive, lowercase identifiers |
| 115 | +- Use hyphens for readability |
| 116 | +- Keep them consistent across forms |
| 117 | +- Examples: `company-name`, `budget-range`, `use-case-type` |
| 118 | + |
| 119 | +### Hidden vs Visible Questions |
| 120 | +**Use Hidden Questions When:** |
| 121 | +- Information is for internal tracking only |
| 122 | +- You want the smoothest user experience |
| 123 | +- Data doesn't need to appear in calendar events |
| 124 | + |
| 125 | +**Use Visible Questions When:** |
| 126 | +- Information is relevant during the meeting |
| 127 | +- You want attendees to be able to modify the data |
| 128 | +- The information should appear in calendar event details |
| 129 | + |
| 130 | +### Multiple Field Connections |
| 131 | +You can connect multiple routing form fields to booking questions: |
| 132 | + |
| 133 | +``` |
| 134 | +Routing Form Fields → Booking Questions |
| 135 | +company-name → company-name |
| 136 | +employee-count → employee-count |
| 137 | +budget-range → budget-range |
| 138 | +timeline → project-timeline |
| 139 | +``` |
| 140 | + |
| 141 | +--- |
| 142 | + |
| 143 | +## Troubleshooting |
| 144 | + |
| 145 | +### Data Not Transferring |
| 146 | +**Check these common issues:** |
| 147 | +- ✅ Identifiers match exactly (case-sensitive) |
| 148 | +- ✅ Field types are compatible |
| 149 | +- ✅ Booking question is properly saved |
| 150 | +- ✅ Event type has the booking question configured |
| 151 | + |
| 152 | +### Data Not Appearing in Calendar Event |
| 153 | +- Hidden booking questions don't appear in calendar events |
| 154 | +- Change question visibility to "Visible" if needed |
| 155 | + |
| 156 | +### User Sees Duplicate Information |
| 157 | +- If booking question is visible, user will see the pre-filled data |
| 158 | +- This is expected behavior and allows them to modify if needed |
| 159 | + |
| 160 | +By connecting your routing forms to booking questions, you create a seamless lead capture and booking process that maintains context throughout the entire customer journey. This ensures you're always prepared for meetings and can make data-driven improvements to your routing and booking processes. |
0 commit comments