The agent books, reschedules, and cancels only after the caller confirms. Outlook sends the caller a calendar invite. The skill works with both voice and SMS agents.
Setup takes four steps: register an app in Microsoft Entra ID, connect it in Invoca, configure your booking rules, and attach the skill to your agent.
Before you begin
- Microsoft Outlook is enabled on your Invoca account. If you don’t see it in Manage Integrations, contact Invoca.
- Your calendars are in Microsoft 365 (Exchange Online). Personal Outlook.com accounts and Microsoft Bookings aren’t supported.
- A Microsoft Entra ID admin is available to register an app and grant tenant-wide admin consent.
- An Exchange admin is available to limit the app to only the calendars it needs.
- For round robin: your reps are members of an Entra group, and each rep has working hours set in Outlook.
- For a shared calendar: you have the shared mailbox’s email address.
Connect Microsoft Outlook
You connect with an app registration that you own in Microsoft Entra ID. The agent works as that app, not as a signed-in person. In Microsoft Entra ID (admin):- Go to App registrations and create a new registration. Copy its Application (client) ID and your Directory (tenant) ID.
- Under API permissions, add the Microsoft Graph application permissions in the table below, then select Grant admin consent.
- Under Certificates & secrets, create a client secret and copy its value. Note when it expires.
- Limit the app to only the rep mailboxes or shared mailbox it should book on, using RBAC for Applications or an application access policy. Without this, the app’s calendar permission covers every mailbox in your organization.
- Open Manage Integrations and select Microsoft Outlook.
- Add a new credential with your tenant ID, client ID, and client secret.
- Save, and confirm the connection shows as connected.
Configure booking rules
You set the booking rules on your Outlook connection in Manage Integrations. If the required settings are missing, the agent can’t offer or book times, and it never falls back to another calendar.
Each rep’s working hours come from their own Outlook settings, not from Invoca. Booked appointments are titled “Consultation” with the caller’s name, and the description lists the caller’s contact details.
Add the skill to your AI agent
- Open your agent in Agent Builder.
- Open the Schedule Appointment action.
- In the skill field, choose Microsoft Outlook (Microsoft 365) Scheduling, then choose your Outlook connection.
- Test the agent with a test booking, then publish it.
How scheduling works
The agent only offers times Outlook shows as free, and reads back the date and time before it books, reschedules, or cancels. Asking whether anything is available is never treated as agreement to book.
Retrying a booking never creates a duplicate.
Data and privacy
- Limit the app to the right mailboxes. Microsoft grants application calendar access across your whole organization unless you restrict it in Exchange. Invoca can’t enforce that limit for you.
- Only bookings the agent made. The agent can only look up, move, or cancel appointments it booked. It can’t see the content of other calendar events.
- No made-up results. The agent only says an appointment is booked, moved, or canceled after Outlook confirms it.
- No internal details. The agent doesn’t say mailbox addresses, IDs, or system terms to the caller.
- Caller details on the event. Each booked appointment lists the caller’s name, phone, and email for your rep.
- You stay in control. To stop access, remove the connection in Manage Integrations, or delete the client secret or app registration in Entra ID. When your rep group changes, update the Exchange restriction and your Invoca settings together.
Limitations
- Next open times only. The agent offers the next 3 open times. It can’t search for a specific date the caller asks about.
- Only agent-booked appointments. The agent can’t reschedule or cancel appointments that were booked another way.
- Edits in Outlook aren’t tracked. If a rep moves or cancels an appointment directly in Outlook, the agent isn’t told.
- Same calendar on reschedule. A rescheduled appointment stays with the same rep or shared calendar.
- Fixed title. Appointments are titled “Consultation”, and you can’t change this yet.
- No Teams link. Appointments don’t include a Teams meeting link.
- Microsoft 365 only. Personal Outlook.com accounts and Microsoft Bookings aren’t supported.
Troubleshooting
Still stuck? Contact Invoca with the agent name and the time of the conversation.