Skip to main content
Send the bot to a real meeting and get back a transcript, summary, and action items. All you need is a Telnyx API key and a meeting link.
1

Send the Bot to a Meeting

Create a meeting session pointing at your meeting URL:
Returns 201 Created with the session id:
summarize_on_end attempts a summary artifact after the transcript is finalized, so a recap is ready without a second request. It does not generate action items — request an action_items artifact separately — and an empty transcript or a generation failure can result in no completed summary.
2

Admit the Bot

The bot appears in the meeting lobby under its bot_name; admit it like any other participant. Poll the session until status is active:
A non-null joined_at is positive evidence that the bot became active. admission_denied is reserved for an explicit denial by the host; a never-admitted session can also end as plain ended, so do not infer attendance from ended alone. The full status lifecycle is on Join with a Meeting URL.
3

Follow the Transcript Live

Long-poll the transcript endpoint while the meeting runs. after is your cursor; wait_seconds holds the request open until a new segment lands:
Repeat the call with after set to meta.next_after (the last seq you received). When an empty page returns "next_after": null, keep the cursor you already had — null is not a replacement cursor.
4

Read the Results

When the meeting ends — or you DELETE the session to make the bot leave — the transcript is finalized and the summary generates. Read the artifacts:
Poll until the artifact’s status is completed, then read content.text for the recap. To get action items, POST to the same artifacts endpoint with {"type": "action_items"}. The finalized transcript stays available at the transcript endpoint.