---
title: "Integrations"
description: "Connect your helpdesk and Stripe once, and let your agents use them."
source: https://hiy.ai/docs/connectors
---

# Integrations

Integrations connect hiy to the tools you already use: hand a chat to your helpdesk or look up billing in Stripe.

Integrations are on Growth. On Free and Starter the app rows are locked, with a link to your plans. Growth keeps 2 agents syncing at once. If you move to a lower plan, connected apps pause and nothing is deleted.

## The new Integrations page

This page is rolling out to workspaces in turn.

The tiles under **What should your agent do?** are **Answer from your help centre**, **Look up orders and accounts** and **Hand over to your helpdesk**. Press one and the apps below narrow to it. The chips **All**, **Knowledge**, **Helpdesk**, **Commerce**, **CRM**, **Calendar** and **Comms** narrow them by kind of app. In early-access workspaces, **Issues** and **Files** join them.

Each app lists what it can do for an agent as chips: **Knowledge**, **Lookups**, **Actions** and **Handover**. A filled chip is on, an outlined one could be, and **Soon** means it is planned.

Connecting takes four steps, and a connection you made stays connected if you stop part way:

1. **Access** — Paste what the app asks for. **Where do I find this?** opens the guide for that app beside the page.

2. **Check** — hiy asks the app whether the access works, and shows the account it found.

3. **Use it for** — Tick what it is for, and which agents hand over to it. Nothing turns on until you tick it.

4. **Try** — **Try** makes one real read for Knowledge and Handover, such as one article title. It never changes anything in the app.

Opening a connected app shows what it does for your agents, which agents use it, and its health.

| Part | What you can do |
| --- | --- |
| **What it does** | See each use, switch Handover on or off per agent, or open **Manage in Knowledge**. |
| **Health** | See the last seven checks, press **Check now**, or **Reconnect** when it stopped working. |
| **Access** | **Reconnect** keeps every setting. **Replace account** and **Disconnect** list what changes first; **Disconnect** can remove one use and keep the rest. |

Knowledge's **From an app** tab, an agent's **Connect an app** and Handover's **Connect a helpdesk** open the same list, filtered, so you can connect without leaving the page.

## Apps you sign in to

Early access: on in some workspaces only.

Linear, GitHub, Sentry, Close, GitBook and more connect through their own MCP server.

1. **Connect** — Press **Connect** on the app. hiy shows what it will ask the app for, leaving out any access named for changing things or admin tasks.

2. **Sign in** — Press **Continue to** the app's name, sign in and allow hiy. GitHub asks for an **Access token** instead, and Freshdesk for your **Subdomain** and **API key**.

3. **Turn tools on** — The app's tools arrive **Off**. Open one, say what your agent reads, and pick the agents that may use it. A tool that only reads **Looks up** for your agents. A tool that makes changes **Asks first**: a teammate checks every field and sends it from a conversation. Each agent can use up to 10 tools across all apps. You can also switch a tool on or off for one agent on its **Tools** page, under **App tools**.

Changes from the Inbox use a second sign-in; your agent's stays read-only.

**Disconnect** turns every tool off for every agent, and signs hiy out of the app where the app allows it; otherwise hiy tells you where to remove it.

## Before the new page

The page as it is until your workspace gets the new one.

## Connect a tool

1. **Pick a card** — Open **Integrations** in the sidebar. The cards on top, such as **Hand over to your helpdesk** and **Answer billing questions**, each have a button for their tools, such as **Connect Zendesk**. Or find any tool under **All integrations**.

2. **Paste the access hiy asks for** — Follow the page for [Zendesk](/docs/connectors/zendesk), [Intercom](/docs/connectors/intercom) or [Stripe](/docs/connectors/stripe). hiy checks the access before it saves, so a typo is refused straight away.

3. **Turn it on where it's used** — Each tool's page says where.

A connected Shopify or Stripe can also show the contact's orders or subscription beside a conversation in the Inbox: switch it on in Settings › Inbox › Customer panels. See [Customer panels](/docs/developers#customer-panels).

You connect a tool once for the whole workspace, and your plan doesn't limit that. Each agent then chooses which ones it uses.

### Answer in Slack

**Note:** Slack isn't open yet: it shows as a Preview. These steps are for when it opens.

1. **Add hiy to Slack** — Press **Add to Slack** in **Integrations** and allow hiy in your Slack workspace.

2. **Choose which agent answers** — On the Slack connection, press **Choose which agent answers…** and pick one. ![The Slack connection with the agents to choose from and Done](https://hiy.ai/docs-shots/connectors/slack-agent.webp) *Integrations › Slack*

3. **Ask it a question in Slack** — Message your agent in Slack.

**Tip:** The agent must be live to answer. Check it in the agent's header menu.

## Status on every connection

A connected tool shows one word, one line under its name and one button.

| Word | What it means | Button |
| --- | --- | --- |
| **Connected** | It works. The line says when hiy last checked. | **Manage** |
| **Check this** | hiy couldn't reach it, or the address is wrong. The line says which. | **Review** |
| **Reconnect** | The tool stopped accepting our access. | **Reconnect** |
| **Paused** | Your plan includes fewer connected agents than you have. | **See plans** |

hiy checks each tool once a day. The first time one needs reconnecting, the owners and admins of the workspace get one email saying what stopped. A tool you disconnect has no word: it is just **Connect** again.

## What each card's word means

Every tool in **All integrations** says where it stands:

- **Connect**: you can connect it now.
- **Preview**: it is built but not open to every workspace yet. Notion is a Preview.
- **Soon**: it has a plan, and it isn't built.
- **On request**: there is no plan yet.
- **Booking link**: nothing to connect. On an Expert Twin, a link in a [list](/docs/records#how-your-agent-uses-a-list) opens inside the chat.

On a Preview, Soon or On request row, **Tell me when it's live** records that you asked, and nothing else.

Where your workspace has it, connect Confluence and your agents answer from your team's own pages, without copying them by hand. Choose pages with **Add pages**, and hiy checks them once a day. Pages with Confluence restrictions stay with team agents.

SharePoint works the same way for your site pages, where your workspace has it: only published pages are read, and pages with their own permissions stay with team agents. Your Microsoft 365 admin may need to approve hiy first.

![All integrations: Intercom, Zendesk and Stripe with Connect, Calendly and Cal.com marked Booking link, and Notion marked Preview with Tell me when it's live](https://hiy.ai/docs-shots/connectors/catalog.webp)

*Integrations › All integrations*

**Good to know:**

- **Reconnect** keeps every setting that points at the connection: each agent's ticket switch, the Slack agent you picked, and your actions.
- One Slack workspace answers for one hiy workspace. If another one already has it, disconnect it there first.
- If Slack is slow to take a reply, hiy tries again for up to 10 minutes, then drops it rather than post a stale answer.
- When Slack opens, you connect it, and pick its agent, in [Slack](/docs/slack).

## Related

- [Handing over to a person](/docs/handover) — When your agent hands a chat to a person, who it reaches, and when it does so by itself.

- [Connect Zendesk](/docs/connectors/zendesk) — Open a ticket in Zendesk whenever your agent hands a chat to a person.

- [Connect Intercom](/docs/connectors/intercom) — Open a ticket in Intercom whenever your agent hands a chat to a person.

- [Connect Stripe](/docs/connectors/stripe) — Let your agent look up a customer's subscription to answer billing questions.
