All pages

Docs

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.

View as Markdown

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.

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

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.