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

# Calls Overview

> AI meeting recording, transcription, and intelligence — a bot joins your calls, captures the conversation, and turns it into summaries, action items, and CRM updates.

## What is the Calls module?

Calls turns live meetings into structured, searchable records. A recording bot joins a meeting, captures audio and a speaker-attributed transcript, and the AI produces a summary, key topics, and suggested action items — each call lands as a first-class record you can read, search, link to a contact, and act on.

<CardGroup cols={2}>
  <Card title="Recording bot" icon="robot">
    Send a bot into any Zoom, Google Meet, or Microsoft Teams meeting to capture audio and transcript.
  </Card>

  <Card title="Transcripts" icon="file-lines">
    Speaker-attributed, timestamped transcripts plus a signed recording URL for playback.
  </Card>

  <Card title="Intelligence" icon="brain">
    AI-generated summary, sentiment, and key topics — plus suggested action items drawn from the conversation.
  </Card>

  <Card title="CRM linkage" icon="link">
    Link a call to a CRM contact so the conversation is attached to the right relationship.
  </Card>
</CardGroup>

***

## How a call is captured

1. **Dispatch a bot** to a meeting URL (or an instant meeting you create). The bot joins as a participant.
2. **The meeting is recorded and transcribed** — audio, a speaker-attributed transcript, and participant events are captured.
3. **The AI analyzes the call** — it generates a summary, sentiment, key topics, and a set of suggested action items.
4. **The call becomes a record** — available via the API and in the workspace, ready to search, link, and act on.

<Note>
  The summary, sentiment, and suggested actions are AI estimates derived from the transcript — useful starting points to review and edit, not measured facts.
</Note>

***

## Recording a meeting

Two ways to get a bot onto a call:

| Action | Endpoint |
| - | - |
| Join an existing meeting | `POST /api/calls/join` |
| Create an instant meeting and join | `POST /api/calls/instant-meeting` |
| See upcoming meetings | `GET /api/calls/upcoming` |

`join` dispatches a bot to a meeting URL (Zoom, Google Meet, or Microsoft Teams). Once the call completes, its transcript and intelligence become available on the call record.

***

## Reading calls

| Action | Endpoint |
| - | - |
| List calls | `GET /api/calls` |
| Get a call's details | `GET /api/calls/{id}` |
| Get the transcript | `GET /api/calls/{id}/transcript` |
| Get the recording URL | `GET /api/calls/{id}/recording` |
| Get call analytics | `GET /api/calls/analytics` |

The transcript is speaker-attributed and timestamped; the recording endpoint returns a short-lived signed URL for playback.

***

## Action items

Each call yields a set of AI-suggested action items — follow-up emails, CRM updates, tasks, and notes drawn from what was discussed. You review them, then execute or update their status through the API:

| Action | Endpoint |
| - | - |
| Execute an action | `POST /api/calls/{id}/actions/{actionId}` |
| Update an action's status | `PATCH /api/calls/{id}/actions/{actionId}` |

Executing an action carries it out against the relevant module — for example sending an email or writing the update into the CRM.

***

## Linking a call to your CRM

Attach a call to the contact it belongs to so the conversation lives alongside the rest of that relationship:

| Action | Endpoint |
| - | - |
| Get the linked contact | `GET /api/calls/{id}/link-contact` |
| Link a CRM contact | `PATCH /api/calls/{id}/link-contact` |
| Unlink the contact | `DELETE /api/calls/{id}/link-contact` |

***

## Common workflows

### Record a sales call and follow up

1. `POST /api/calls/join` with the meeting URL before the call starts
2. After the call, read the summary and suggested actions on the call record
3. Link the call to the prospect's CRM contact
4. Execute the follow-up actions you approve (e.g. a recap email)

### Pull a transcript into your own tooling

1. `GET /api/calls` to find the call
2. `GET /api/calls/{id}/transcript` for the speaker-attributed transcript
3. Process it however you need — your own summarization, search index, or analytics

***

## API reference

<CardGroup cols={2}>
  <Card title="Calls" icon="phone" href="/api-reference/calls/list-calls">
    List calls, fetch details, join meetings, and link contacts.
  </Card>

  <Card title="Call intelligence" icon="brain" href="/api-reference/call-intelligence/get-call-transcript">
    Transcripts, recordings, analytics, and action-item execution.
  </Card>
</CardGroup>


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