# Setting up connections

> How to connect the calendars and customer records the AI uses during calls, and the post-call notification channels (Slack, Teams and others), in the dashboard. Also covers per-tenant connections and connecting third-party APIs.

Source: https://voicast.jp/en/docs/dashboard-connections

**Connections** in the left menu sets up connections used by every tenant in this environment. Connection actions require the developer role or above. For the available services and what each action does, see [Connections](https://voicast.jp/en/docs/connectors.md).

Services are grouped under **Scheduling**, **Customer records** and **Notifications**.

## Connect a service

1. Under **Connections**, press **Connect** on the service's card.
2. Depending on the service, do one of the following:
   - Services you sign in to (Google Calendar, Google Sheets, kintone and others): enter any requested values such as the kintone subdomain, press **Sign in to …**, and allow access on the service's page. You return to the dashboard afterwards.
   - Services that take a URL or key (Slack, Microsoft Teams, Chatwork): paste the URL or token issued by the service and press **Verify and save**. A test notification or an account check runs before saving.
3. Choose the settings (calendar, sheet and columns, room to notify and so on).
4. Press **Save**.

When done, the card shows "Connected". To use it during calls, choose the connection and its actions under **Connections** on the [agent](https://voicast.jp/en/docs/dashboard-agents.md) and save. Notification services send a summary after the call (there are no actions during the call).

For Google Calendar and Microsoft 365 calendars, the settings include:

| Setting | What |
| --- | --- |
| Calendar | The calendar the AI books into |
| Appointment length, buffer before and after | Used when looking for open slots |
| Business hours | Per weekday in 15-minute steps, up to 4 ranges a day. **Copy to weekdays** copies Monday to Tuesday through Friday. Holidays aren't detected, so put an event in the calendar on days off |
| Event title | `{name}` is replaced with the caller's name. Don't include medical conditions or similar details |

## Connection status

| Status | Meaning | Card button |
| --- | --- | --- |
| Connected | Ready to use | **Configure** |
| Setup required | Settings haven't been chosen yet | **Set up** |
| Reconnect required | Access to the service has expired | **Reconnect** |

## Disconnect

1. Press **Configure** on the service's card.
2. Press **Disconnect**, then **Disconnect** again in the confirmation dialog.

After disconnecting, the AI and post-call notifications can no longer use this connection, and the service's access token is revoked.

## Connect per tenant

To use a different calendar or other service for each business, set up tenant-specific connections. A tenant uses its own connection if it has one, and the environment's connection otherwise.

1. Press **Edit** on the tenant in the **Tenants** list.
2. Under **Connections**, press **Create a connect page link**.
3. Copy the link and give it to the business's contact (valid for 15 minutes).

When the contact opens the link and connects, the connection appears under **Connections** in the edit dialog. To embed the link in your own product, see [Connections](https://voicast.jp/en/docs/connectors.md#embedded-connect-page).

To remove a tenant-specific connection, press **Disconnect** next to it under **Connections** in the edit dialog, then press **Disconnect** again in the confirmation. The tenant then uses the environment's connection (a service the environment isn't connected to can no longer be used). The token issued by the service is revoked as well.

## Connect a third-party API

You can turn another company's API into tools the AI uses during calls (for developers).

1. Under **Custom** on **Connections**, press **+ Connect an API**.
2. Choose **URL and API key** as the **Connection type**.
3. Enter the API URL, the header for the API key (choose **No authentication** if no key is needed) and the API key, then press **Save**.
4. Set up the tools to call (tool name, description, method, path, required and optional arguments) and press **Save**.

Choose whether to use it under **Connections** on the agent. To call your own API, use [Agent tools](https://voicast.jp/en/docs/dashboard-agent-tools.md).
