Read transcript¶

Request examples¶

cURLNode.jsPython

curl --request POST 'https://elo-api-prod.quaggamock.com/plugin-runtime/INSTALLATION_ID' \
  --header "Authorization: Bearer $ELO_PLUGIN_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"operation": "transcript:read", "meetingId": "meeting-demo"}'

const response = await fetch('https://elo-api-prod.quaggamock.com/plugin-runtime/INSTALLATION_ID', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.ELO_PLUGIN_TOKEN}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
  "operation": "transcript:read",
  "meetingId": "meeting-demo"
})
});
const result = await response.json();
if (!response.ok) throw new Error(result.message);
console.log(result);

import os, json, urllib.request, urllib.error
request = urllib.request.Request(
    "https://elo-api-prod.quaggamock.com/plugin-runtime/INSTALLATION_ID",
    data=json.dumps({'operation': 'transcript:read', 'meetingId': 'meeting-demo'}).encode(),
    headers={"Authorization": "Bearer " + os.environ["ELO_PLUGIN_TOKEN"], "Content-Type": "application/json"},
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=15) as response:
        print(json.load(response))
except urllib.error.HTTPError as error:
    print(error.code, error.read().decode())

Playground¶

POST /plugin-runtime/{installationId}

transcript:read · https://elo-api-prod.quaggamock.com/plugin-runtime/INSTALLATION_ID

Up to 100 entries per page, ordered by time and ID ascending. Includes speech, chat and notes; distinguish them with kind. Continue with nextCursor until null.

Actual contract

Operations share the endpoint above and are selected by the operation body field. Each name is not a separate REST route.

Authentication¶

Authorization: Bearer <PLUGIN_GRANT> · Content-Type: application/json

Five-minute host-issued grant for this installation. Permission transcript:read must be declared in the approved manifest and authorized.

A meeting grant only allows its bound meeting; a configuration grant cannot read meetings.

Path parameters¶

Field	Type	Description
`installationId`	string	User installation ID, not the submission/manifest ID.

Request body¶

Field	Type	Description
`operation`	string	transcript:read
`meetingId`	string	ID da reunião selecionada / Selected meeting ID
`cursor?`	string	nextCursor da resposta anterior; omita na primeira página / Previous nextCursor; omit on first page

{
  "operation": "transcript:read",
  "meetingId": "meeting-demo"
}

Responses¶

200 · OK¶

at and endedAt are millisecond timestamps. endedAt is optional. kind distinguishes caption (speech), chat (typed) and note. nextCursor is an opaque string or null.

{
  "entries": [
    {
      "id": "entry-demo",
      "kind": "caption",
      "speaker": "Alice",
      "text": "We agreed to review the integration.",
      "at": 1793455200000,
      "endedAt": 1793455204000
    }
  ],
  "nextCursor": null
}

400 · Invalid input

{"code": "invalid_input", "message": "Revise os dados enviados.", "issues": []}

401 · Expired or invalid token

{"code": "plugin_token", "message": "A sessão do plugin expirou."}

403 · Permission or meeting scope denied

{"code": "plugin_scope", "message": "O plugin não recebeu esta permissão."}

404 · Installation or meeting not found

{"code": "plugin_missing", "message": "Plugin não encontrado ou desativado."}

Security and revocation · Pagination and errors