The fonio AI integration allows your AI phone assistant to automatically check your Zeeg availability and book appointments on your behalf during phone calls. When a prospect calls, fonio can view your real-time availability in Zeeg, suggest time slots, and instantly schedule meetings—all without human intervention. This integration connects your Zeeg scheduling pages directly to fonio's AI voice system for seamless appointment management.
Business Plan or Higher Required
API access is available on Business, Scale, and Enterprise plans. If you're on Starter or Professional plan, you'll need to upgrade.
What you need
Before you begin the integration, make sure you have:
Active Zeeg account with Business plan or higher (Scale or Enterprise)
Access to create API tokens in Zeeg
fonio AI account
A scheduling page in Zeeg configured for the appointments you want to book
Step-by-step integration guide
1. Create an API token in Zeeg
Navigate to your Zeeg Workspace settings and go to Access Token (you'll find this under Connections in the left sidebar).
Click on + Create API token.
In the dialog that opens:
Token name: Enter a descriptive name you'll recognize, such as "fonio AI Integration"
Expiration date: Set an expiration date for the token (we recommend setting it one year in the future for long-term integrations)
Permissions: Configure the specific permissions fonio needs:
Scheduling pages: Set to Read - This allows fonio to access your scheduling page configurations
Events: Set to Write - This allows fonio to create new appointments
Schedules: Set to Read - This allows fonio to check your real-time availability
Do not enable "Full admin access" unless specifically required. Granular permissions are more secure.
Click Create API token.
The API token will only be displayed once. Copy it immediately and store it securely. You won't be able to see it again.
2. Find your scheduling page ID
To connect fonio to the correct scheduling page:
Go to your Dashboard
Find the scheduling page you want to use for fonio bookings
You can find the ID under Base settings > Link
Make sure this scheduling page doesn't have required custom form fields that the AI can't fill automatically. Keep the booking form simple with only essential fields (name, email, phone).
3. Open fonio and activate appointment booking
Log into your fonio dashboard and navigate to your AI assistant's settings.
Go to the Tools section and activate Appointment Booking.
4. Enter API token and scheduling page details
In fonio's appointment booking configuration:
Select provider: Choose Zeeg from the list of supported scheduling providers
API Token: Paste the Zeeg API token you created in Step 1
Scheduling Page ID: Enter the scheduling page ID from Step 2
Description (optional): If you use multiple calendars or scheduling pages, add a description so the AI assistant can identify which calendar to use (e.g., "Sales consultations" or "Product demos")
5. Set permissions
Choose what the AI assistant is allowed to do:
View only: The AI can check availability and inform callers about open time slots, but cannot book appointments
View and book: The AI can check availability and automatically book appointments during the call
We recommend starting with View and book for a fully automated experience.
6. Choose notification method
Select how appointment confirmations should be sent to the caller:
Email: The caller must provide their email address during the call. The confirmation will be sent via email.
SMS: The confirmation is sent to the incoming phone number automatically. Recommended - this is more convenient as the phone number is already known.
We recommend choosing SMS for the smoothest booking experience, as it requires no additional information from the caller.
7. Save and test
Click Save to activate the integration
Run an audio test in your fonio assistant:
Simulate a call where someone requests an appointment
Verify that the AI can access your Zeeg availability
Confirm that test appointments are created correctly in your Zeeg dashboard
Check your Zeeg Meetings page to ensure the test appointment appears
Best practices
Use clear token names
Give your API tokens descriptive names in Zeeg (e.g., "fonio Production" or "fonio Sales Bot"). This helps you manage and revoke tokens easily if needed.
Add descriptions for multiple calendars
If you manage multiple scheduling pages or teams in Zeeg, use the description field in fonio to specify which type of appointments this configuration handles. This ensures the AI routes bookings correctly.
Keep scheduling pages simple
For AI bookings to work smoothly, avoid adding custom required fields to your Zeeg scheduling pages. The AI can handle basic information (name, email, phone) but struggles with complex custom questions.
Test after setup
Always run a complete audio test immediately after configuring the integration. This validates the entire booking flow before real callers use the system.
Set appropriate buffer times
In your Zeeg scheduling page settings, configure appropriate buffer times before and after appointments. This prevents back-to-back bookings and gives you preparation time.
Monitor your API token
Check your Zeeg API token usage periodically. If you see unexpected activity, you can revoke the token and create a new one.
FAQ
Can I connect multiple fonio assistants to different Zeeg scheduling pages?
Yes! Create separate API token configurations for each assistant. You can use the same API token with different scheduling page IDs, or create separate tokens for better tracking and security.
What happens if someone tries to book an unavailable time slot?
fonio only shows time slots that are available according to your Zeeg calendar. If your Zeeg calendar is properly configured and connected, conflicts are prevented automatically. The AI will only offer genuinely available times to callers.
Can I revoke API access if needed?
Yes. Go to Settings > Access Token in your Zeeg dashboard, find the token you want to revoke, and delete it. This immediately stops fonio from accessing your Zeeg account. You can then create a new token if needed.
Does this integration work with team scheduling pages?
Yes! The integration works with all Zeeg scheduling page types, including:
One-on-one meetings
Group events
Round-robin team scheduling
Collective team scheduling
Make sure your API token has access to the specific scheduling pages you want to use.
Will fonio bookings appear in my connected calendar?
Yes. Appointments booked through fonio are created in Zeeg, and Zeeg automatically syncs them to your connected calendar (Google Calendar, Microsoft Exchange, or Apple Calendar) based on your Calendar Connections settings.
Can I track which appointments came from fonio?
Yes. All appointments created through the API include metadata indicating they were created via API. You can filter your Zeeg appointments or check the activity log to see which bookings came through fonio.
What data does fonio access from my Zeeg account?
fonio can only access what you grant permission for:
Scheduling pages (Read): Configuration of your scheduling pages
Schedules (Read): Your available time slots
Events (Write): Ability to create new appointments
fonio cannot access your CRM data, other users' information, billing details, or any data beyond the specific permissions you grant.