90466908a8
<!-- Clearly explain the need for these changes: -->
we met some reality when merging into the docs site but this fixes it
### Changes 🏗️
updates paths, adds some guides
<!-- Concisely describe all of the changes made in this pull request:
-->
update to match reality
### Checklist 📋
#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
<!-- Put your test plan here: -->
- [x] deploy it and validate
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> Aligns block integrations documentation with GitBook.
>
> - Changes generator default output to
`docs/integrations/block-integrations` and writes overview `README.md`
and `SUMMARY.md` at `docs/integrations/`
> - Adds GitBook frontmatter and hint syntax to overview; prefixes block
links with `block-integrations/`
> - Introduces `generate_summary_md` to build GitBook navigation
(including optional `guides/`)
> - Preserves per-block manual sections and adds optional `extras` +
file-level `additional_content`
> - Updates sync checker to validate parent `README.md` and `SUMMARY.md`
> - Rewrites `docs/integrations/README.md` with GitBook frontmatter and
updated links; adds `docs/integrations/SUMMARY.md`
> - Adds new guides: `guides/llm-providers.md`,
`guides/voice-providers.md`
>
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
fdb7ff8111. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: bobby.gaffin <bobby.gaffin@agpt.co>
5.4 KiB
Baas Bots
Blocks for deploying and managing meeting recording bots using the BaaS (Bot as a Service) API.
Baas Bot Delete Recording
What it is
Permanently delete a meeting's recorded data
How it works
This block permanently deletes the recorded data for a meeting bot using the BaaS (Bot as a Service) API. The deletion is irreversible and removes all associated recording files and transcripts.
Provide the bot_id from a previous recording session to delete that specific meeting's data.
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| bot_id | UUID of the bot whose data to delete | str | Yes |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| deleted | Whether the data was successfully deleted | bool |
Possible use case
Privacy Compliance: Delete recordings to comply with data retention policies or user requests.
Storage Management: Clean up old recordings to manage storage costs.
Post-Processing Cleanup: Delete recordings after extracting needed information.
Baas Bot Fetch Meeting Data
What it is
Retrieve recorded meeting data
How it works
This block retrieves recorded meeting data including video URL, transcript, and metadata from a completed bot session. The video URL is time-limited and should be downloaded promptly.
Enable include_transcripts to receive the full meeting transcript with speaker identification and timestamps.
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| bot_id | UUID of the bot whose data to fetch | str | Yes |
| include_transcripts | Include transcript data in response | bool | No |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| mp4_url | URL to download the meeting recording (time-limited) | str |
| transcript | Meeting transcript data | List[Any] |
| metadata | Meeting metadata and bot information | Dict[str, Any] |
Possible use case
Meeting Summarization: Retrieve transcripts for AI summarization and action item extraction.
Recording Archive: Download and store meeting recordings for compliance or reference.
Analytics: Extract meeting metadata for participation and duration analytics.
Baas Bot Join Meeting
What it is
Deploy a bot to join and record a meeting
How it works
This block deploys a recording bot to join a video meeting (Zoom, Google Meet, Teams). Configure the bot's display name, avatar, and entry message. The bot joins, records, and transcribes the meeting.
Use webhooks to receive notifications when the meeting ends and recordings are ready.
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| meeting_url | The URL of the meeting the bot should join | str | Yes |
| bot_name | Display name for the bot in the meeting | str | Yes |
| bot_image | URL to an image for the bot's avatar (16:9 ratio recommended) | str | No |
| entry_message | Chat message the bot will post upon entry | str | No |
| reserved | Use a reserved bot slot (joins 4 min before meeting) | bool | No |
| start_time | Unix timestamp (ms) when bot should join | int | No |
| webhook_url | URL to receive webhook events for this bot | str | No |
| timeouts | Automatic leave timeouts configuration | Dict[str, Any] | No |
| extra | Custom metadata to attach to the bot | Dict[str, Any] | No |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| bot_id | UUID of the deployed bot | str |
| join_response | Full response from join operation | Dict[str, Any] |
Possible use case
Automated Recording: Record meetings automatically without requiring host intervention.
Meeting Assistant: Deploy bots to take notes and transcribe customer or team meetings.
Compliance Recording: Ensure all meetings are recorded for compliance or quality assurance.
Baas Bot Leave Meeting
What it is
Remove a bot from an ongoing meeting
How it works
This block removes a recording bot from an ongoing meeting. Use this when you need to stop recording before the meeting naturally ends.
The bot leaves gracefully and recording data becomes available for retrieval.
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| bot_id | UUID of the bot to remove from meeting | str | Yes |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| left | Whether the bot successfully left | bool |
Possible use case
Early Termination: Stop recording when a meeting transitions to an off-record discussion.
Time-Based Recording: Leave after capturing a specific portion of a meeting.
Error Recovery: Remove and redeploy bots when issues occur during recording.