> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invoca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Outlook Integration for Invoca AI Agents

> Connect Microsoft Outlook to Invoca AI agents to book, reschedule, and cancel appointments on Microsoft 365 calendars, by round robin or shared calendar.

The Microsoft Outlook integration lets your Invoca AI agents book appointments directly on your team's Microsoft 365 calendars. The agent offers open times, books the one the caller confirms, and can reschedule or cancel appointments it booked.

The skill is called **Microsoft Outlook (Microsoft 365) Scheduling**. It works in one of two modes:

| Booking mode | How it works | Best for |
| - | - | - |
| Round robin | Spreads appointments across a group of reps, using each rep's own Outlook calendar and working hours | Sales or consultation teams |
| Shared calendar | Books onto one shared mailbox calendar, up to a set number of appointments per time slot | A single team calendar or resource |

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):**

1. Go to **App registrations** and create a new registration. Copy its **Application (client) ID** and your **Directory (tenant) ID**.
2. Under **API permissions**, add the Microsoft Graph **application** permissions in the table below, then select **Grant admin consent**.
3. Under **Certificates & secrets**, create a client secret and copy its value. Note when it expires.

**In Exchange Online (admin):**

1. 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.

**In Invoca:**

1. Open **Manage Integrations** and select **Microsoft Outlook**.
2. Add a new credential with your tenant ID, client ID, and client secret.
3. Save, and confirm the connection shows as connected.

| Microsoft Graph permission | Why it's needed |
| - | - |
| `Calendars.ReadWrite` | Read free and busy times, and create, move, and cancel appointments |
| `MailboxSettings.Read` | Read each rep's working hours and timezone |
| `GroupMember.Read.All` | Find the reps in your round-robin group |
| `User.Read.All` | Look up each rep's mailbox |

## 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.

| Setting | What it controls | Default |
| - | - | - |
| Booking mode | Round robin across reps, or one shared calendar | None, so choose one |
| Representative group ID | The Entra group of reps to book across (round robin only) | None |
| Shared calendar mailbox | The shared mailbox's email address (shared calendar only) | None |
| Slot capacity | How many appointments can share one time slot (shared calendar) | 1 |
| Meeting duration | Length of each appointment | 30 minutes |
| Buffer between appointments | Gap kept free between appointments | 0 minutes |
| Minimum lead time | How soon the earliest bookable time can be | 60 minutes |
| Maximum days ahead | How far out the agent can book, from 1 to 60 days | 14 days |

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

1. Open your agent in **Agent Builder**.
2. Open the **Schedule Appointment** action.
3. In the skill field, choose **Microsoft Outlook (Microsoft 365) Scheduling**, then choose your Outlook connection.
4. 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.

| Caller asks to | What the agent does in Outlook |
| - | - |
| See open times | Offers up to 3 of the next open times in your booking window, spread across free reps. If none are open, it says so. |
| Book | Re-checks the time, then creates the appointment on the rep's or shared calendar. If the time was just taken, it offers up to 3 others. Outlook emails the caller an invite. |
| Check an appointment | Reads back the time and status of an appointment the agent booked |
| Reschedule | Moves the appointment to a new confirmed time on the same calendar, and updates the invite |
| Cancel | Cancels the appointment through Outlook, which notifies attendees with a short cancellation note |

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

| What you see | Likely cause | What to do |
| - | - | - |
| Microsoft Outlook isn't listed in Manage Integrations | It isn't turned on for your Invoca account | Contact Invoca to turn it on |
| The agent says it can't schedule right now | Booking mode, rep group, or shared mailbox is missing | Complete the booking settings on your connection |
| The connection fails to authenticate | Wrong tenant ID, client ID, or secret, or the secret expired | Check the values in Entra ID, and create a new secret if needed |
| Access denied errors | Admin consent wasn't granted, or Exchange restricts the app from those mailboxes | Grant admin consent, and include the right mailboxes in your Exchange restriction |
| No times are offered | Reps have no working hours set, or calendars are full within the window | Check reps' working hours in Outlook, and your lead time and days-ahead settings |
| A rep never gets bookings | The rep isn't in the Entra group | Add the rep to the group |
| The agent can't find the caller's appointment | It was booked outside the agent, or the caller can't identify it | Have your team handle that change directly |
| Voice agent has no Schedule Appointment action | The agent uses an older voice template | Ask your Invoca team about moving to the latest template |

Still stuck? Contact Invoca with the agent name and the time of the conversation.


## Related topics

- [Microsoft Dynamics 365 Integration for Invoca AI Agents](https://docs.invoca.com/s/article/microsoft-dynamics-agent-integration.md)
- [HubSpot Integration for Invoca AI Agents](https://docs.invoca.com/s/article/hubspot-agent-integration.md)
- [Zoom Integration for Invoca AI Agents](https://docs.invoca.com/s/article/zoom-agent-integration.md)
- [Salesforce Integration for Invoca AI Agents](https://docs.invoca.com/s/article/salesforce-agent-integration.md)
- [Calendly Integration for Invoca AI Agents](https://docs.invoca.com/s/article/calendly-agent-integration.md)
