> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/command-centre/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/command-centre/visitor-management-powered-by-kenai/visitor-management/invites/ical-bot.md).

# Invite from your calendar (iCal bot)

Create a Kenai visitor invite without leaving your calendar: add the Kenai iCal bot as an attendee on a calendar event and Kenai creates the visitor invite for you. It works from your calendar (Outlook, Google Calendar, or any iCal system), so there is no separate dashboard step.

There are two bot addresses:

* **<invite@kenai.co.za>** (**CCBOT - Invite**) creates invites once your defaults are saved.
* **<invitesetup@kenai.co.za>** (**CCBOT - Invite Setup**) walks you through setup the first time and whenever you want to change your options.

{% hint style="info" %}
**Note:** Kenai accepts events only from email addresses on the host directory for that site. If you are not loaded as a host, the bot replies with an error instead of creating an invite (see [Troubleshooting](#troubleshooting)).
{% endhint %}

## Set up your invites the first time

The first time you invite visitors, use **<invitesetup@kenai.co.za>** to confirm your options and save them as your defaults.

{% stepper %}
{% step %}

### Add the setup bot to an event

In your calendar, open or create an event and add **<invitesetup@kenai.co.za>** (**CCBOT - Invite Setup**) as an attendee, along with at least one external guest. Send or save the event.
{% endstep %}

{% step %}

### Open the setup email

Kenai replies with a **Setup visitor invites in Kenai** email. Click the green **Set up Visitor Invites** button to open the setup page.
{% endstep %}

{% step %}

### Verify and confirm

Verify with the one-time PIN (OTP) you are sent, then confirm your invite details on the **Visitor Invites** page: event, **Arrival Date and Time**, **Location**, **Visitor Type**, who to send to, **Host**, and an optional **Second host**.
{% endstep %}

{% step %}

### Save your defaults and create

Tick **Save settings as default for future invitations?** so the standard **<invite@kenai.co.za>** bot can reuse them, then click **Create Invites**. If you leave the box unticked, you return to this setup page for every invite until you save.
{% endstep %}
{% endstepper %}

{% embed url="<https://app.arcade.software/share/m7syb2yFFahlsB9HEaAe?embed=true>" %}
Walkthrough: confirming your invite details and saving them as defaults.
{% endembed %}

{% hint style="success" %}
**Tip:** the detailed confirmation email Kenai sends back is your proof that the invite is created and the visitor experience is automated.
{% endhint %}

## Create an invite from a calendar event

Once your defaults are saved, add **<invite@kenai.co.za>** to any event and Kenai creates the invite automatically.

{% stepper %}
{% step %}

### Create the meeting

In your calendar, create a meeting as normal. Add a title and set the date and time.
{% endstep %}

{% step %}

### Add the iCal bot

Add **<invite@kenai.co.za>** (**CCBOT - Invite**) as an attendee. This triggers Kenai to create and manage the invite from this event.
{% endstep %}

{% step %}

### Add your visitors

Add your visitor or visitors as attendees on the same event.
{% endstep %}

{% step %}

### Send the event

Once all your details are confirmed, send or save the meeting. Kenai creates the invites, emails each visitor a pre-registration invite, and sends you a confirmation email with the meeting details and a shareable invite link.
{% endstep %}
{% endstepper %}

{% embed url="<https://app.arcade.software/share/ST12ANXt5oE0uOrKPLyf?embed=true>" %}
Walkthrough: creating an invite by adding the iCal bot to a calendar event.
{% endembed %}

## Update an invite

To change an existing invite, edit the event that already has the bot attached, then make any small change to the meeting title to re-trigger Kenai.

{% stepper %}
{% step %}

### Open the event

Open your existing invite in your calendar.
{% endstep %}

{% step %}

### Make your changes

Change the date, time, or attendees as needed. Add any extra participants to the attendee list as normal.
{% endstep %}

{% step %}

### Change the title to re-trigger

Make any small change to the meeting title. This is what tells the iCal bot to pick up the edit.
{% endstep %}

{% step %}

### Send or save

Send or save the meeting. Kenai re-issues the invite email with the updated details.
{% endstep %}
{% endstepper %}

{% embed url="<https://app.arcade.software/share/utO8MylHrfd97vOGqC7r?embed=true>" %}
Walkthrough: updating an existing invite from your calendar.
{% endembed %}

## Cancel an invite

{% stepper %}
{% step %}

### Open the event

Open your existing invite in your calendar.
{% endstep %}

{% step %}

### Select Cancel

In the event, select **Cancel**.
{% endstep %}

{% step %}

### Add a note and send

Choose **Cancel event and notify attendees**, add an optional note, and click **Send**.
{% endstep %}
{% endstepper %}

The visitor's invite is cancelled: if they click **Check In** on their email, they see *This has been cancelled by the organizer.* instead of pre-registration. They also receive the standard cancellation email with your note, so their calendar stays in sync.

{% embed url="<https://app.arcade.software/share/lmwA8ysWiyjBPPGLTpCs?embed=true>" %}
Walkthrough: cancelling an invite from your calendar.
{% endembed %}

## Troubleshooting

If something is wrong with the event, Kenai replies with an error email instead of creating the invite. There are three errors to know.

* **Request Denied:** you are not on any host list. *You must be a host to invite visitors. Please contact your Kenai admin to add you as a host.* You need to be added to the host list for each site you invite to (see [Manage hosts](/command-centre/visitor-management-powered-by-kenai/visitor-management/hosts.md)).
* **No External Guests:** Kenai did not see any external attendees on the event. Fix it one of three ways: delete the event and start over with your guests added; manually copy and share the **Share Invite Link** from the email; or edit the event to add the missing guests. To invite internal guests, add **<invitesetup@kenai.co.za>** to the event.
* **More than one CC bot:** you included both bots on the event. *Please include only one of <invitesetup@kenai.co.za> or <invite@kenai.co.za>.* Edit the event, remove the extra bot, change the title slightly, and send again.

{% embed url="<https://app.arcade.software/share/4s7FWCFWDsF7MQMNlzXk?embed=true>" %}
Walkthrough: the three iCal bot error emails and how to fix the event.
{% endembed %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.security.gallagher.com/command-centre/visitor-management-powered-by-kenai/visitor-management/invites/ical-bot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.