Basics of Bots

What is a bot?

In the Attendee platform, a bot is an automated participant that can join virtual meetings across Zoom, Google Meet, Microsoft Teams, and Webex to perform various tasks such as recording and transcription.

Bot Capabilities

1. Recording: Bots can record audio and video from meetings
2. Transcription: Bots can transcribe meeting conversations in real-time
3. Speech: Bots can speak arbitrary audio into the meeting
4. Avatars: Bots can display arbitrary images from their virtual webcam
5. Chat: Bots can record and send chat messages

Bot States

Bots go through these lifecycle states:

1. Ready: Initial state when bot is created
2. Joining: Bot is attempting to join meeting
3. Joined - Not Recording: Bot has joined but isn't recording
4. Joined - Recording: Bot has joined and is recording
5. Leaving: Bot is leaving the meeting
6. Post Processing: Bot is processing recordings
7. Fatal Error: Bot encountered an unrecoverable error
8. Waiting Room: Bot is in meeting's waiting room
9. Ended: Bot has completed all tasks and recordings and transcripts are available for download
10. Data Deleted: Bot data has been permanently deleted (recordings, transcripts, participants)
11. Scheduled: Bot is scheduled to join at a future time (see scheduled bots documentation)
12. Staged: Bot resources are allocated and ready to join at scheduled time
13. Joined - Recording Paused: Bot has joined and recording is temporarily paused
14. Joining Breakout Room: Bot is moving to a breakout room
15. Leaving Breakout Room: Bot is leaving a breakout room
16. Joined - Recording Permission Denied: Bot has joined but doesn't have permission to record

Transcription Features

1. Realtime transcription
2. Multiple language support
3. Automatic language detection
4. Speaker identification / Diarization
5. Precise timestamps for each utterance
6. Ability to transcribe using third party providers or from platform closed captions

Configuration Options

Bots can be configured with:

Transcription Settings

• Language selection
• Automatic language detection
• Provider-specific options

Recording Settings

• Recording type (Audio and Video / Audio Only)
• Recording view (Speaker View / Gallery View)

Automatic leave settings

• How long should the bot wait to be let into the meeting before giving up?
• How long it should be silent before the bot leaves?
• How long should the bot be the only one in the meeting before it leaves?
• How long the meeting can last before the bot leaves?

Webhooks

• Bot state changes
• Transcript updates

Platform Support

Currently supported platforms:

1. Zoom
2. Google Meet
3. Microsoft Teams
4. Webex (see Webex bots)

Data Deletion

You can permanently delete all data associated with a bot, including recordings, transcripts, and participant information.

To delete bot data, use the POST /api/v1/bots/{bot_id}/delete_data endpoint. This action:

• Is irreversible and cannot be undone
• Only works for bots in the ended or fatal_error states
• Preserves bot metadata for audit purposes
• Moves the bot to the data_deleted state

Note: Metadata fields (like bot ID, meeting URL, creation time) are retained for audit purposes even after data deletion.