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

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Zoom Phone and Aircall: missed calls, voicemails and call logs

> Connect Zoom Phone or Aircall so missed calls and voicemails from clients become Signals, call logs are searchable in Ask, and workflows start on a missed call.

Connect your firm's phone system and Hive tells you when a client called and nobody called them
back. Missed calls and voicemails from your clients become [Signals](https://docs.get-hive.ai/signals/overview.md), your call
log, call notes and voicemail transcripts can be searched in [Ask Hive](https://docs.get-hive.ai/ask/ask-hive.md), and a
missed call or a voicemail can start a [workflow](https://docs.get-hive.ai/workflows/workflow-steps.md#connected-app-event).

| Phone system | Connect | Calls reach Hive | Voicemail transcripts | Notes and tags |
| - | - | - | - | - |
| [Zoom Phone](#zoom-phone) | Sign in with Zoom | As they happen | Yes | — |
| [Aircall](#aircall) | Sign in with Aircall, or an API token | As they happen, and checked once an hour | — | Yes |

RingCentral and CloudTalk are next.

Hive never stores a recording or a voicemail's audio. It keeps only the phone system's reference
to it, so you open the recording in Zoom or Aircall.

## Which calls are a client's

A caller is one of your clients only when their phone number is linked to that client. Link a
number in **Settings → Account → Texting clients**: it is the same link Hive uses for texts, so a
number linked for texting is already linked for calls. Hive never guesses a client from the name in
your phone system's contacts, a number in an email, or anything a caller says.

Calls from numbers that are not linked are still in your call log in Ask, marked **not linked to a
client**. They raise no Signal and start no workflow: anyone can ring a firm number.

## Missed-call Signals

When a client calls and nobody answers, you get one Signal for that client, for example:

> Sarah from Acme Ltd called twice on Monday 12 October and left a voicemail, no callback yet.

* **One Signal per client, not per call.** Each new missed call or voicemail from the same client
  updates the same Signal, until someone calls them back.
* **A callback closes it.** An outbound call to the client, or a call with them that was answered,
  closes the Signal. The next missed call starts a new one.
* **How urgent it is.** A missed call or a voicemail is medium. A third missed call, or a second
  one with a voicemail, is high.
* **Only recent calls.** A run of missed calls whose latest call is more than a week old raises
  nothing, so connecting your phone system never fills your Inbox with old calls.
* **Dismissed stays dismissed.** If you dismiss the Signal, more missed calls in the same run do
  not bring it back. A new run after a callback does.
* Missed-call Signals are raised for members whose seat includes Signals. Everyone else's calls
  still reach Ask and workflows.

## Search your calls in Ask

Ask Hive about your calls, such as "who called me yesterday?", "did Acme leave a voicemail this
week?" or "what did we note on the last call with 07700 900123?". Hive searches your own calls,
newest first, with the client each number is linked to, the call's notes and tags, and the
voicemail transcript. It finds a number in any common format.

Notes, tags and voicemails are what people wrote or said. Hive reads them as information, never as
instructions.

## Call or text a client back

* **Call back** from Zoom Phone or Aircall as usual. Hive does not place calls. Once the call is
  made, the missed-call Signal closes.
* **Text back** through your own texting connection, such as Twilio: ask Hive to text the client,
  or add a text step to a workflow. The same checks as any text apply: opt-outs, the numbers Hive
  may text, and your approval where your [account level](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md) asks
  for it. See [Text messages](https://docs.get-hive.ai/integrations/messaging.md#who-hive-texts).

Hive does not yet send texts or start calls through Zoom Phone or Aircall itself.

In **Ringover**, Hive can create a contact, create a call tag or archive a call, each after a
member approves the card, even on **Act**. Archiving names a call Hive read from your account in
the same chat or run and needs the stronger approval. Hive does not send texts, WhatsApp messages
or start calls through Ringover. The Ringover API key needs write access to contacts and calls.

A [Connected app event](https://docs.get-hive.ai/workflows/workflow-steps.md#apps-hive-checks-for-changes) trigger on
**Ringover** starts a workflow when an inbound call is answered or missed, or a caller leaves a
voicemail, for any caller, not only linked clients. Hive checks the workflow owner's own Ringover
connection about every 15 minutes and only reads it. The event names the Ringover user who took
the call, never the caller's number.

## Calls in workflows

Choose **Connected app event** as the trigger, the phone system as the app, and one of these
events:

* **Missed call from a client** (`call.missed`): an inbound call from a linked client that nobody
  answered. It fires once per call.
* **Voicemail received from a client** (`voicemail.received`): the client left a voicemail. For
  Zoom Phone it fires when the voicemail arrives, before the transcript, if any, is ready.

The event carries the caller's number, your number they called, when they called, the caller's
name from your phone system, and the voicemail transcript if it is ready when the voicemail
arrives. Only calls from linked
clients start a workflow, and a phone system's other events never do. See
[Connected app event](https://docs.get-hive.ai/workflows/workflow-steps.md#connected-app-event).

## Who sees calls

Calls belong to the member who connected the phone system, as their own mailbox does. Other
members, including Owners and Admins, do not see them in Ask, Signals or workflows, and an AI client
connected to Hive cannot read them.

## What Hive keeps, and for how long

* **Kept while connected:** each call's number, time, length, direction and whether it was
  answered; the caller's name from your phone system; the call's notes and tags; and the voicemail
  transcript.
* **Cleared on disconnect:** when you disconnect the phone system, or leave the workspace, Hive
  clears the caller's name, notes, tags, voicemail transcript and recording reference of every call
  it kept. The call itself (number, time, length, outcome) stays in your history.
* **Deleted with the workspace.**
* **Never kept:** recordings and voicemail audio.

## Zoom Phone

| | |
| - | - |
| **Connect** | Sign in with Zoom. Each member connects their own Zoom account. |
| **Receive** | Your missed calls, voicemails and their transcripts, and your finished calls in and out. |
| **Actions** | — |
| **Signals** | Missed calls from a client |

When you connect, Hive records which Zoom user you are. Zoom sends Hive the phone events of the
whole Zoom account, and Hive keeps only yours: a colleague's calls are never added to your call
log, even when they connect Zoom too. If Hive cannot read which user you are, the connection
records no calls until you reconnect it.

Calls between colleagues' extensions are not client calls, and are skipped. Zoom's text messages
are not read.

## Aircall

| | |
| - | - |
| **Connect** | Sign in with Aircall, or your Aircall API ID and API token. |
| **Receive** | Every finished call, voicemails, and the notes and tags your team adds to a call. |
| **Actions** | — |
| **Signals** | Missed calls from a client |

When you connect, Hive creates one webhook in your Aircall account named **Hive**, so calls reach
Hive as they happen. Aircall sends a token with each delivery, which Hive checks against the one it keeps encrypted. Once an hour Hive
also reads the latest calls, so a delivery Aircall missed is caught up within the hour. The first
read brings in the last week's calls for Ask without raising Signals or starting workflows.

Aircall's API token covers the firm's whole Aircall account, so every call in it is added to the
call log of the member who connected it. Connect Aircall with the account of the person whose calls
it should be.

Aircall does not send voicemail transcripts, so Aircall voicemails are found by caller and time,
not by what was said.

## Disconnecting

When you disconnect Zoom Phone, Hive stops keeping its calls and clears what they said (see
[What Hive keeps](#what-hive-keeps-and-for-how-long)).

When you disconnect Aircall, Hive deletes the **Hive** webhook from your Aircall account if it still
can, forgets its token, stops the hourly read and clears what the calls said. If Aircall refuses the
delete, remove the **Hive** webhook in Aircall's dashboard: Hive no longer accepts its deliveries.

The numbers you linked to clients stay.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.