Join External Meeting

Send a TruGen agent into a live external meeting (Google Meet, Zoom, Microsoft Teams). The agent joins as a participant, listens, speaks, and captures a full transcript.

Endpoint

POST https://api.trugen.ai/v1/ext/externalmeeting

Headers

Header	Required	Description
`X-API-Key`	Yes	Your TruGen API key
`Content-Type`	Yes	`application/json`

Request body

Field	Type	Required	Description
`agent_id`	string	Yes	ID of the agent to send into the meeting
`meeting_url`	string	Yes	Full URL of the Google Meet, Zoom, or Teams meeting the agent should join
`user_name`	string	Yes	Display name the agent uses in the meeting
`user_id`	string	Yes	Identifier for this session — used in analytics and callbacks
`context`	string	No	Free-form conversational context passed to the agent’s system prompt
`wake_phrase`	string	No	Optional phrase the agent listens for before speaking (useful in silent-observer mode)
`mode`	string	No	Session mode

Example

curl --request POST \
  --url https://api.trugen.ai/v1/ext/externalmeeting \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "agent_id": "agt_12345",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "user_name": "Alex — AI Assistant",
    "user_id": "meeting-2026-07-30-abc",
    "context": "This is a hiring interview. The candidate is Priya Sharma for the Senior Engineer role."
  }'

Response

Plain-text status message:

Agent request successfully created.

Or, if the underlying meeting-bot service could not accept the request:

Unable to create agent request.

Behavior

The agent joins the meeting at the URL you provide, using the display name from user_name. It participates in real time — hearing, transcribing, reasoning, and speaking through its configured pipeline (STT / LLM / TTS / avatar). When the meeting ends, the associated conversation record persists — retrieve it with GET /v1/ext/conversation/{id} for the transcript, tool calls, and any structured output.

Common uses

AI interviewer — automatically join scheduled interviews and run structured question sets
Sales attendee — join discovery calls to answer live product questions
Meeting note-taker — silently transcribe and summarize customer calls
Compliance witness — attend regulated calls and flag policy issues in real time

Supported meeting platforms

Google Meet
Zoom
Microsoft Teams

See External Meetings for the full concept, plus behavior details like multi-participant handling and platform join flows.

API Documentation

Video Agents

Avatars

Conversations

External Meetings

Knowledge Base

MCPs

Persona Templates

Providers

Tools

Text to Video Generation

Endpoint

Headers

Request body

Example

Response

Behavior

Common uses

Supported meeting platforms

What’s next

External Meetings concept

Callbacks

​Endpoint

​Headers

​Request body

​Example

​Response

​Behavior

​Common uses

​Supported meeting platforms

​What’s next

External Meetings concept

Callbacks

Endpoint

Headers

Request body

Example

Response

Behavior

Common uses

Supported meeting platforms

What’s next