Linux
01/29/2026, 6:11 PMAI Evy
01/29/2026, 6:11 PMAI Evy
01/29/2026, 6:11 PMbook_appointment function
For conversation flow agents, you may want to add a conversation node before the booking function to collect and confirm the phone number, then pass it along. [(2) ]()
If you're still experiencing issues, ensure your Retell and Cal.com timezones are aligned, and that your prompt makes the LLM aware of the current time. [(3) ]()
Check out these potentially useful sources for more details:
- [Book Calendar]()
- [Platform Changelogs | Retell AI]()
- [Dynamic Variables]()
Would you like me to try to provide a general answer on how to structure the prompt for collecting custom fields?AI Evy
01/29/2026, 6:11 PMAI Evy
01/29/2026, 6:11 PMLinux
01/30/2026, 1:17 PMAI Evy
01/30/2026, 1:17 PMAI Evy
01/30/2026, 1:18 PMcheck_calendar and book_appointment functions with your Cal.com API key and event type ID
The video demonstrates a successful booking where the phone number is collected and correctly appears in the Cal.com booking event.
Troubleshooting suggestions:
- Ensure your prompt explicitly instructs the agent to collect the phone number before calling the book_appointment function
- Verify your Retell and Cal.com timezones are aligned [(2) ]()
- Make sure your prompt makes the LLM aware of the current time using the {{current_time}} dynamic variable
If the issue persists specifically when the phone number field is required in Cal.com, this may indicate a configuration or compatibility issue that isn't fully documented in the available sources. I'd recommend reaching out for additional support:
- Visit [Contact Sales]()
- Check [)
Would you like me to try to provide a general answer on potential workarounds?AI Evy
01/30/2026, 1:18 PMAI Evy
01/30/2026, 1:18 PMLinux
01/31/2026, 8:05 PMAI Evy
01/31/2026, 8:05 PMAI Evy
01/31/2026, 8:05 PM3. Confirm the date, time, and timezone selected by user: "Just to confirm, you want to book the appointment at ...". Make sure this is a time from the available slots.
4. Once confirmed, call function book_appointment to book the appointment.
Adapt this pattern to explicitly include phone number collection:
- Instruct the agent to collect the phone number before confirming the booking
- Explicitly state that the phone number must be included when calling the book_appointment function
- Consider adding a confirmation step: "Just to confirm, I have your name as John, email as xxx@hotmail.com, and phone number as +1234567890. Is that correct?"
Example prompt addition:
When user selected a slot, please book the appointment by calling the `book_appointment` function.AI Evy
01/31/2026, 8:05 PMbook_appointment function, you MUST collect and confirm the customer's name, email, AND phone number. Include ALL three fields when calling the function."
Additional troubleshooting:
Make sure your prompt includes the current time reference using {{current_time}} in your prompt—this helps the LLM understand temporal context for booking. [(3) ]()
The available sources don't provide specific documentation on the exact parameter names for Cal.com custom fields within the booking function. You may need to verify the exact field name expected (e.g., phone, phone_number, attendee_phone) in your Cal.com event type configuration.
If the issue persists after strengthening your prompts, I'd recommend reaching out for additional support:
- Visit [Contact Sales]()
- Visit [)AI Evy
01/31/2026, 8:05 PMAI Evy
01/31/2026, 8:05 PM