Pular para o conteúdo
NexoNexo · API e MCP

Transcrição de uma reunião

GET
/v1/meetings/{meetingId}/transcript
curl --request GET \
  --url https://developers.nexo.winningsales.com.br/v1/meetings/example/transcript \
  --header 'Authorization: Bearer <token>'

A transcrição da reunião em trechos: quem falou, de que lado (empresa ou cliente), quando e o quê, cada trecho com a referência curta (e1, e2…) que as leituras citam. O vendedor só enxerga as conversas dos próprios negócios e as próprias; admin e líder de vendas enxergam as da empresa. Conteúdo de conversa na íntegra: exige o escopo conversations:read e cada leitura fica registrada na atividade da empresa.

Authorizations

Seção intitulada “Authorizations”

Parameters

Seção intitulada “Parameters”

Path Parameters

Seção intitulada “Path Parameters”
meetingId
required
string

Id da reunião

Responses

Seção intitulada “Responses”

200

Seção intitulada “200”

A transcrição em trechos

Media typeapplication/json
object
meetingId
required

Id da reunião

string format: uuid
schemaVersion
required

Versão da quebra em trechos. Quando a versão muda, os trechos são refeitos a partir do lake

integer
excerpts
required

Os trechos, na ordem em que foram ditos

Array<object>
object
id
required

Id do trecho

string format: uuid
ref
required

Referência curta do trecho dentro da reunião (e1, e2…), a mesma que as leituras do Nexo citam

string
position
required

Ordem do trecho na reunião, a partir de 1

integer
speaker
required

Quem falou o trecho

object
externalId
required

Id do participante na plataforma da reunião

string
name
required

Nome que a plataforma mostrou

string
nullable
side
required

Lado de quem falou: da empresa (internal), do cliente (external) ou sem como saber (unknown)

string
Allowed values: internal external unknown
userId
required

Pessoa do Nexo que falou, quando é alguém da empresa

string format: uuid
nullable
startMs
required

Início do trecho, em milissegundos desde o começo da gravação

integer
endMs
required

Fim do trecho, em milissegundos desde o começo da gravação

integer
text
required

O que foi dito, como o provedor transcreveu

string

Example 

{
  "excerpts": [
    {
      "speaker": {
        "side": "internal"
      }
    }
  ]
}

401

Seção intitulada “401”

Token ausente, inválido, expirado ou revogado

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.invalid_credential",
  "title": "InvalidCredentialError",
  "status": 401,
  "detail": "Token de acesso inválido, expirado ou revogado. Crie um novo token de acesso no Nexo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb"
}

403

Seção intitulada “403”

Papel, escopo do token ou plano não permitem a operação

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.insufficient_scope",
  "title": "InsufficientScopeError",
  "status": 403,
  "detail": "Este token não tem o escopo conversations:read, exigido por esta operação. Gere um token com esse escopo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "operation": "conversations.reading",
    "scope": "conversations:read"
  }
}

404

Seção intitulada “404”

Transcrição indisponível ou reunião fora da visibilidade

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "conversations.transcript_unavailable",
  "title": "TranscriptUnavailableError",
  "status": 404,
  "detail": "Esta reunião ainda não tem transcrição disponível.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "meetingId": "019fcae7-3e54-755a-8458-bdb605b324aa"
  }
}

429

Seção intitulada “429”

Limite de chamadas da empresa ou do token atingido

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.rate_limited",
  "title": "PublicRateLimitedError",
  "status": 429,
  "detail": "Muitas chamadas em pouco tempo. Tente de novo em 12 segundos.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "class": "content",
    "limitedBy": "company",
    "limit": 120,
    "windowSeconds": 60,
    "retryAfterSeconds": 12
  }
}