# Salesbud API

> Company-scoped REST API for server-to-server Salesbud integrations. Read completed
> meetings and calls: transcripts, template answers, evaluations and enablement signals.

Authentication is OAuth 2.0 client credentials; a credential represents a company, not a
user. There is no refresh token — renewal is calling /oauth/token again.

Full text: https://docs.salesbud.com.br/llms-full.txt
OpenAPI: https://docs.salesbud.com.br/openapi.yaml

## English

### Overview

- [Salesbud API](https://docs.salesbud.com.br/index.md): Read your company's completed meetings and calls — transcripts, template answers, evaluations and enablement signals — over a versioned REST API.
- [The answer object](https://docs.salesbud.com.br/objects/answer.md): Returned by the template answer routes, one entry per question of the record's default template.
- [The call object](https://docs.salesbud.com.br/objects/call.md): Returned by every route under `/v1/calls`. A call answers the same five routes as a meeting and carries the same fields except `bot_history`; what else changes 
- [The evaluation object](https://docs.salesbud.com.br/objects/evaluation.md): Returned by the overall evaluation routes. Every field except `object` and `status` is null until the evaluation completes.
- [The meeting object](https://docs.salesbud.com.br/objects/meeting.md): Returned by every route under `/v1/meetings`. A call carries the same fields except `bot_history` — see [the call object](/objects/call/) for what differs.
- [The pagination object](https://docs.salesbud.com.br/objects/pagination.md): Accompanies every list response. Drive the loop by `has_more`, never by the size of `data` — see [Pagination](/guides/pagination/).
- [The transcript object](https://docs.salesbud.com.br/objects/transcript.md): Returned by the transcript routes. An unavailable transcript is a successful response with `available: false`, not an error.

### Get started

- [Quickstart](https://docs.salesbud.com.br/get-started/quickstart.md): Exchange a credential for an access token and read your first page of meetings.

### Guides

- [Authentication](https://docs.salesbud.com.br/guides/authentication.md): OAuth 2.0 client credentials, scopes, token lifetime and secret rotation.
- [Errors](https://docs.salesbud.com.br/guides/errors.md): The error envelope, which field to branch on, and every code the API returns.
- [MCP server](https://docs.salesbud.com.br/guides/mcp.md): Connect claude.ai to your Salesbud data with the remote MCP server.
- [Meetings and calls](https://docs.salesbud.com.br/guides/meetings-and-calls.md): Two collections, one shape. How a record becomes a meeting or a call, and which one you should read.
- [Pagination](https://docs.salesbud.com.br/guides/pagination.md): Signed keyset cursors, why a short page is not the last page, and how to walk a full history.
- [Rate limits](https://docs.salesbud.com.br/guides/rate-limits.md): Which buckets apply, what the headers report, and how to back off correctly.
- [Security](https://docs.salesbud.com.br/guides/security.md): What the API guarantees about isolation, what it records, and the trade-offs you should know about.

### API reference

- [Issue an access token](https://docs.salesbud.com.br/reference/authentication/issueaccesstoken.md): Issue an access token
- [Get one completed call](https://docs.salesbud.com.br/reference/calls/getcall.md): Get one completed call
- [List the default template answers for a call](https://docs.salesbud.com.br/reference/calls/getcallanswers.md): List the default template answers for a call
- [Get a call transcript](https://docs.salesbud.com.br/reference/calls/getcalltranscript.md): Returns the enhanced transcript when available, otherwise the original transcript. An unavailable transcript is represented by a successful response with availa
- [Get the overall call evaluation](https://docs.salesbud.com.br/reference/calls/getoverallcallevaluation.md): Get the overall call evaluation
- [List completed calls](https://docs.salesbud.com.br/reference/calls/listcalls.md): Calls are the records captured from a VoIP integration, addressed by their own `call_` identifiers. They answer the same five routes as meetings and carry the s
- [Get the authenticated integration context](https://docs.salesbud.com.br/reference/context/getapicontext.md): Get the authenticated integration context
- [Get an email conversation](https://docs.salesbud.com.br/reference/emails/getemail.md): Conversation metadata only. An `eml_` id issued to another company, or any id with a different prefix, is a 404, not a hint.
- [List the messages of an email conversation](https://docs.salesbud.com.br/reference/emails/listemailmessages.md): Messages in the order they were sent, oldest first, with plain-text bodies and attachment metadata (no attachment content). Governed by the `email_content` rate
- [List email conversations](https://docs.salesbud.com.br/reference/emails/listemails.md): Conversations are deduplicated across every mailbox connected to the company: two sellers on the same thread yield one conversation with two mailboxes. Ordered 
- [Get one completed meeting](https://docs.salesbud.com.br/reference/meetings/getmeeting.md): Get one completed meeting
- [List the default template answers for a meeting](https://docs.salesbud.com.br/reference/meetings/getmeetinganswers.md): List the default template answers for a meeting
- [Get a meeting transcript](https://docs.salesbud.com.br/reference/meetings/getmeetingtranscript.md): Returns the enhanced transcript when available, otherwise the original transcript. An unavailable transcript is represented by a successful response with availa
- [Get the overall meeting evaluation](https://docs.salesbud.com.br/reference/meetings/getoverallmeetingevaluation.md): Get the overall meeting evaluation
- [List completed meetings](https://docs.salesbud.com.br/reference/meetings/listmeetings.md): List completed meetings
- [Get a WhatsApp conversation](https://docs.salesbud.com.br/reference/whatsapp/getwhatsappconversation.md): Conversation metadata only: contact, seller, linked accounts and activity instants. A `wa_` id issued to another company, or any id with a different prefix, is 
- [List WhatsApp conversations](https://docs.salesbud.com.br/reference/whatsapp/listwhatsappconversations.md): One conversation per chat of a company seller, from WhatsApp Web or RD Conversas. Ordered by `last_message_at` ascending (oldest activity first); pages forward 
- [List the messages of a WhatsApp conversation](https://docs.salesbud.com.br/reference/whatsapp/listwhatsappmessages.md): Messages in the order they were sent, oldest first, with sanitized text, media metadata (no media content) and the audio transcription when one exists. A messag

### Resources

- [Changelog](https://docs.salesbud.com.br/resources/changelog.md): Contract changes, newest first.
- [For LLMs and agents](https://docs.salesbud.com.br/resources/for-agents.md): Plain-text mirrors of this documentation, built for tools that read docs directly.
## Português (pt-BR)

### Overview

- [API Salesbud](https://docs.salesbud.com.br/pt-br.md): Leia as reuniões e ligações concluídas da sua empresa — transcrições, respostas de template, avaliações e sinais de enablement — por uma API REST versionada.
- [O objeto resposta](https://docs.salesbud.com.br/pt-br/objects/answer.md): Devolvido pelas rotas de respostas de template, um item por pergunta do template padrão do registro.
- [O objeto ligação](https://docs.salesbud.com.br/pt-br/objects/call.md): Devolvido por todas as rotas de `/v1/calls`. A ligação responde às mesmas cinco rotas de uma reunião e carrega os mesmos campos, exceto `bot_history`; o resto d
- [O objeto avaliação](https://docs.salesbud.com.br/pt-br/objects/evaluation.md): Devolvido pelas rotas de avaliação geral. Todo campo além de `object` e `status` é nulo até a avaliação concluir.
- [O objeto reunião](https://docs.salesbud.com.br/pt-br/objects/meeting.md): Devolvido por todas as rotas de `/v1/meetings`. A ligação carrega os mesmos campos, exceto `bot_history` — veja [o objeto ligação](/pt-br/objects/call/) para o 
- [O objeto paginação](https://docs.salesbud.com.br/pt-br/objects/pagination.md): Acompanha toda resposta de listagem. Itere por `has_more`, nunca pelo tamanho de `data` — veja [Paginação](/pt-br/guides/pagination/).
- [O objeto transcrição](https://docs.salesbud.com.br/pt-br/objects/transcript.md): Devolvido pelas rotas de transcrição. Transcrição indisponível é resposta bem-sucedida com `available: false`, não erro.

### Get started

- [Começo rápido](https://docs.salesbud.com.br/pt-br/get-started/quickstart.md): Troque uma credencial por um token de acesso e leia a primeira página de reuniões.

### Guides

- [Autenticação](https://docs.salesbud.com.br/pt-br/guides/authentication.md): OAuth 2.0 client credentials, escopos, tempo de vida do token e rotação de secret.
- [Erros](https://docs.salesbud.com.br/pt-br/guides/errors.md): O envelope de erro, em qual campo ramificar, e todos os códigos que a API devolve.
- [Servidor MCP](https://docs.salesbud.com.br/pt-br/guides/mcp.md): Conecte o claude.ai aos seus dados do Salesbud com o servidor MCP remoto.
- [Reuniões e ligações](https://docs.salesbud.com.br/pt-br/guides/meetings-and-calls.md): Duas coleções, uma forma. Como um registro vira reunião ou ligação, e qual delas você deve ler.
- [Paginação](https://docs.salesbud.com.br/pt-br/guides/pagination.md): Cursores keyset assinados, por que página curta não é a última, e como percorrer todo o histórico.
- [Limites de requisição](https://docs.salesbud.com.br/pt-br/guides/rate-limits.md): Quais buckets se aplicam, o que os headers informam, e como fazer backoff corretamente.
- [Segurança](https://docs.salesbud.com.br/pt-br/guides/security.md): O que a API garante sobre isolamento, o que ela registra, e os trade-offs que você precisa conhecer.

### API reference

- [Issue an access token](https://docs.salesbud.com.br/pt-br/reference/authentication/issueaccesstoken.md): Issue an access token
- [Get one completed call](https://docs.salesbud.com.br/pt-br/reference/calls/getcall.md): Get one completed call
- [List the default template answers for a call](https://docs.salesbud.com.br/pt-br/reference/calls/getcallanswers.md): List the default template answers for a call
- [Get a call transcript](https://docs.salesbud.com.br/pt-br/reference/calls/getcalltranscript.md): Returns the enhanced transcript when available, otherwise the original transcript. An unavailable transcript is represented by a successful response with availa
- [Get the overall call evaluation](https://docs.salesbud.com.br/pt-br/reference/calls/getoverallcallevaluation.md): Get the overall call evaluation
- [List completed calls](https://docs.salesbud.com.br/pt-br/reference/calls/listcalls.md): Calls are the records captured from a VoIP integration, addressed by their own `call_` identifiers. They answer the same five routes as meetings and carry the s
- [Get the authenticated integration context](https://docs.salesbud.com.br/pt-br/reference/context/getapicontext.md): Get the authenticated integration context
- [Get an email conversation](https://docs.salesbud.com.br/pt-br/reference/emails/getemail.md): Conversation metadata only. An `eml_` id issued to another company, or any id with a different prefix, is a 404, not a hint.
- [List the messages of an email conversation](https://docs.salesbud.com.br/pt-br/reference/emails/listemailmessages.md): Messages in the order they were sent, oldest first, with plain-text bodies and attachment metadata (no attachment content). Governed by the `email_content` rate
- [List email conversations](https://docs.salesbud.com.br/pt-br/reference/emails/listemails.md): Conversations are deduplicated across every mailbox connected to the company: two sellers on the same thread yield one conversation with two mailboxes. Ordered 
- [Get one completed meeting](https://docs.salesbud.com.br/pt-br/reference/meetings/getmeeting.md): Get one completed meeting
- [List the default template answers for a meeting](https://docs.salesbud.com.br/pt-br/reference/meetings/getmeetinganswers.md): List the default template answers for a meeting
- [Get a meeting transcript](https://docs.salesbud.com.br/pt-br/reference/meetings/getmeetingtranscript.md): Returns the enhanced transcript when available, otherwise the original transcript. An unavailable transcript is represented by a successful response with availa
- [Get the overall meeting evaluation](https://docs.salesbud.com.br/pt-br/reference/meetings/getoverallmeetingevaluation.md): Get the overall meeting evaluation
- [List completed meetings](https://docs.salesbud.com.br/pt-br/reference/meetings/listmeetings.md): List completed meetings
- [Get a WhatsApp conversation](https://docs.salesbud.com.br/pt-br/reference/whatsapp/getwhatsappconversation.md): Conversation metadata only: contact, seller, linked accounts and activity instants. A `wa_` id issued to another company, or any id with a different prefix, is 
- [List WhatsApp conversations](https://docs.salesbud.com.br/pt-br/reference/whatsapp/listwhatsappconversations.md): One conversation per chat of a company seller, from WhatsApp Web or RD Conversas. Ordered by `last_message_at` ascending (oldest activity first); pages forward 
- [List the messages of a WhatsApp conversation](https://docs.salesbud.com.br/pt-br/reference/whatsapp/listwhatsappmessages.md): Messages in the order they were sent, oldest first, with sanitized text, media metadata (no media content) and the audio transcription when one exists. A messag

### Resources

- [Changelog](https://docs.salesbud.com.br/pt-br/resources/changelog.md): Mudanças de contrato, mais recentes primeiro.
- [Para LLMs e agentes](https://docs.salesbud.com.br/pt-br/resources/for-agents.md): Espelhos em texto puro desta documentação, feitos para ferramentas que leem docs diretamente.