Notes Agent

Introduction

Notes Agent is an AI-powered meeting assistant built by FastPix. It joins your meetings automatically, records the conversation, and delivers events to your configured webhook. You can also view speaker-attributed transcripts and AI-generated advanced summaries of each meeting from the FastPix dashboard.

For each meeting, Notes Agent delivers three separate webhook events: one with the video playback URL and an audio signed URL, one with the meeting summary, and one with a transcript signed URL.

Available capabilities

• Auto-joins any video meeting where notes@fastpix.ai is invited as a guest.
• Captures full-meeting audio and video as a background participant.
• Produces speaker-attributed transcripts and AI-generated advanced summaries of each meeting.
• Pushes the complete notes payload to your webhook as soon as the meeting ends.

NOTE: Microsoft Teams and Zoom aren’t supported in the current release. Support for these platforms is on the roadmap.

Getting started

Follow these steps to connect your Google account and start receiving automated meeting notes.

Prerequisites

Before you begin, make sure that you have the following:

• A Google account with access to Google Calendar.
• A FastPix account.
• A webhook endpoint URL.
• An access token and secret key configured in the FastPix dashboard.

Set up Notes Agent

Before you can use Notes Agent, you need to authorize it in the FastPix dashboard. Complete the following three steps in order.

Step 1: One-time setup with FastPix

Do this once. After it’s done, you won’t need to repeat it, even if you connect more Google Calendar accounts later.

1. Create an access token and secret key - in your FastPix dashboard, go to Access Tokens and generate your credentials.

   NOTE: Keep this token active, revoking it will interrupt uploads.

2. Configure credentials and connect your first Google Calendar account - go to AI Agents → Notes Agent. On the welcome page, you’ll see two buttons side by side:

   • Click Configure Credentials and enter your access token and secret key.

   • Click Connect Google calendar, choose your Google account, and complete OAuth authorization.

   NOTE: The Google app is not yet verified, so you might see a warning screen. To continue, click Advanced, then click the link to proceed to FastPix.

   After authorization completes, the page loads to show your meetings data.

3. Set up your webhook - go to Webhooks, click Generate new webhook, enter your URL, and make sure the toggle is enabled. To learn how to set up your endpoint and confirm that webhook events are genuinely from FastPix, see Set up webhooks.

   NOTE: Without a webhook URL, you won’t receive the notes payload after meetings. For details about what the payload contains, see Webhook payload.

Step 2: Add accounts

Each Google account you connect is authorized to use Notes Agent. Notes Agent will auto-join meetings from every connected account’s calendar. You can disable any account at any time.

1. Open the Connect calendars panel - on the Notes Agent page, click Connect Google calendar.

2. Add a Google account - under Add a calendar, click + Add next to Connect a Google account and complete OAuth authorization. The account appears under Connected accounts once authorized. Repeat this for each additional account you want to connect.

3. Manage connected accounts - under Connected accounts, you can see all authorized accounts. Use the toggle next to any account to enable or disable it. When disabled, Notes Agent will not auto-join meetings created from that account.

A Google account can be connected to only one workspace at a time. If you try to connect an account that’s already connected to another workspace, a pop-up asks whether you want to switch the account to your current workspace. If you confirm, the account moves to your current workspace and is removed from the previous one.

If the account belongs to a business domain - that is, a domain that isn’t a generic provider such as gmail.com, only one account from that domain needs to connect. After any individual on the domain connects their account, every address on that domain is authorized to use Notes Agent. For example, after one @fastpix.com user connects, anyone who creates a Google Meet and invites notes@fastpix.ai will have the bot join, as long as their address ends in @fastpix.com.

Step 3: Setup for every meeting

Do this for each meeting you want Notes Agent to join and record.

1. Invite Notes Agent - in Google Calendar, open your meeting event and add notes@fastpix.ai to the Guests field. Save the event.

2. Run your meeting as normal - Notes Agent joins Google Meet within two minutes of the scheduled start time. It appears as FastPix Notestaker in the participants list and records in the background. No action required from participants.

3. Receive your notes - after all participants leave, the bot waits three minutes before leaving and processing the recording. The events are delivered to your webhook URL, and the AI-generated advanced summaries and speaker-attributed transcripts are available in the FastPix dashboard under AI Agents → Notes Agent → Click on any meeting

NOTE:

• The three-minute wait is a grace period, if any participant rejoins before it ends, the bot continues to stay in the meeting until everyone leaves again.
• If no participants join the meeting, Notes Agent waits 15 minutes and then leaves the call.

Webhook payload

After each meeting, Notes Agent delivers three separate webhook events to your endpoint. Each event carries a different part of the meeting output:

• Notes - the recorded media references, including the video playback URL and a signed audio file URL.
• Summary - the AI-generated meeting summary.
• Transcript - a signed URL to download the VTT transcript file.

Notes Agent sends all three events, but the delivery order isn’t guaranteed. Design your webhook handler to process each event type independently rather than assuming a fixed sequence. To tell the events apart, check the type field on the incoming payload.

NOTE: Previously, Notes Agent delivered a single webhook that contained both the audio and transcript URLs. With this release, the audio and transcript references are split across separate events, and the summary is delivered as its own event.

Notes event

This event delivers the recorded media references. It’s the equivalent of the original single webhook, with the transcript URL removed and sent in the Transcript event instead.

1
{
2
  "type": "video.agents.notes.ready",
3
  "mediaId": "0167eb66-80d2-4ba4-b600-a0010efd288a",
4
  "workspaceId": "edf1200f-ce76-4828-ab3a-8473f3fff9c8",
5
  "status": "agents.notes.ready",
6
  "detailMediaResponse": {
7
    "meetingId": "d2a5b516-c3e3-47af-a86a-b9d107f0669d",
8
    "googleEventId": "nh85m5r39l54p30f8stn25tgns",
9
    "meetLink": "<GOOGLE_MEET_LINK>",
10
    "videoPlaybackUrl": "<VIDEO_PLAYBACK_URL>",
11
    "audioSignedUrl": "<AUDIO_SIGNED_URL>"
12
  }
13
}

Fields

Summary event

This event delivers the AI-generated summary of the meeting.

1
{
2
  "type": "video.agents.notes.summary.ready",
3
  "mediaId": "0167eb66-80d2-4ba4-b600-a0010efd288a",
4
  "workspaceId": "edf1200f-ce76-4828-ab3a-8473f3fff9c8",
5
  "status": "agents.notes.summary.ready",
6
  "detailMediaResponse": {
7
    "meetingId": "d2a5b516-c3e3-47af-a86a-b9d107f0669d",
8
    "googleEventId": "nh85m5r39l54p30f8stn25tgns",
9
    "meetLink": "<GOOGLE_MEET_LINK>",
10
    "meetingSummary": "<MEETING_SUMMARY>"
11
  }
12
}

Fields

Transcript event

This event delivers a signed URL to download the speaker-attributed VTT transcript.

1
{
2
  "type": "video.agents.notes.transcript.ready",
3
  "mediaId": "0167eb66-80d2-4ba4-b600-a0010efd288a",
4
  "workspaceId": "edf1200f-ce76-4828-ab3a-8473f3fff9c8",
5
  "status": "agents.notes.transcript.ready",
6
  "detailMediaResponse": {
7
    "meetingId": "d2a5b516-c3e3-47af-a86a-b9d107f0669d",
8
    "googleEventId": "nh85m5r39l54p30f8stn25tgns",
9
    "meetLink": "<GOOGLE_MEET_LINK>",
10
    "transcriptSignedUrl": "<TRANSCRIPT_SIGNED_URL>"
11
  }
12
}

Fields

CAUTION: The audioSignedUrl and transcriptSignedUrl URLs expire 24 hours after delivery. Download and store these files in your own system before the URLs expire.

AI-generated advanced summaries

In addition to the webhook payloads, the FastPix dashboard displays AI-generated advanced summaries for each meeting. To view it, go to AI Agents → Notes Agent → Click on any meeting.

The AI-generated advanced summaries breaks the meeting down into the following sections:

Next steps

After setting up Notes Agent, your webhook will receive multiple events. After you verify that the video.agents.notes.ready event is being delivered successfully, you can further integrate the response into your application by following the Play your video guide.

The audioSignedUrl and transcriptSignedUrl included in the payloads are downloadable files that can be used for further processing.