Otter.ai

Otter.ai

This connector reads Otter.ai meeting notes through Otter's Public API (https://api.otter.ai/v1) with the API key of an Otter user: conversations (recorded meetings) with Otter's summary, action items, insights and outline, the full transcripts, channels and the workspace. It can also import a recording from a link.

Who can use it: Otter's Public API is available to Enterprise workspaces only. On other plans the Developer tab is missing; if an Enterprise workspace does not show it, the Otter account manager can turn it on.

Setup (about 2 minutes)

1. Sign in at https://otter.ai, click Integrations in the left navigation and open the Developer tab.
2. Click Create key and copy the key at once: Otter shows it only once. Each user can have two keys.
3. Paste it into OTTER_API_KEY. It is sent as Authorization: Bearer <key> and only to Otter.
4. Check the setup with otter_list_conversations.

The key acts as its user: the connector sees the conversations that user owns, and with include_shared or a channel those shared with them.

Recordings and transcripts are personal data. They hold what colleagues, customers and other participants said, with their names and email addresses. Only fetch what the user's question needs, prefer the summary and action items over the full transcript, and do not copy transcripts or audio links to other systems unless the user asks for it.

How to work

1. Find conversations: otter_list_conversations, newest first, optionally with include_shared or a channel_id from otter_list_channels. While hasMore is true, call again with cursor = nextCursor. There is no search or date filter in the API: page until you reach the dates you need.
2. otter_get_conversation for Otter's summary, action items, insights and outline.
3. otter_get_transcript for what was said, 300 speaker blocks at a time; when totalBlocks is above 300, otter_get_transcript_more gives blocks 301 to 600. Otter has no further paging.
4. otter_get_audio_link for a download link of the MP3; otter_list_channel_members and otter_get_workspace for people and the workspace.
5. otter_import_recording creates a conversation from a public file link: confirm the link and name with the user first.

Limits: 10 requests a second; more answer 429.

Errors

• 401 unauthorized: the key is wrong or deleted, or the workspace has no Public API. Create a new key under Integrations, Developer.
• 404: wrong conversation or channel id, or the user cannot see it. On otter_get_workspace it means the user is not in a workspace.
• 400: a parameter is invalid (limit 1 to 100, a cursor from another list).
• 429: too many requests; wait a moment.

Out of scope here: searching by keyword or date (the API has none), sharing and editing conversations, and webhooks (set up in Otter's workspace settings, not through this API).