Para LLMs e agentes

Esta documentação é publicada também em formato legível por máquina, para que um agente a consuma sem raspar markup.

Pontos de entrada

Arquivo	Conteúdo
/llms.txt	Índice: uma linha por página, com URL e resumo. Comece por aqui.
/llms-full.txt	Todas as páginas concatenadas em Markdown puro, na ordem de leitura.
/openapi.yaml	O contrato normativo. Tudo na referência da API é gerado dele.

O formato segue a convenção llms.txt.

Qualquer página em Markdown

Acrescente .md a qualquer URL da documentação para obter a fonte em vez da página renderizada:

https://docs.salesbud.com.br/pt-br/guides/pagination/    → HTML
https://docs.salesbud.com.br/pt-br/guides/pagination.md  → Markdown

As duas versões de idioma estão disponíveis; as páginas em português ficam sob /pt-br/.

Se você só precisa ler dado a partir de um agente

Esta API serve um servidor MCP em https://api.salesbud.com.br/mcp, que o claude.ai alcança como conector personalizado. Ele expõe todas as operações públicas de leitura como tools e cuida de renovação de token, retries e janelamento de transcrição. É o caminho mais curto entre uma credencial e um agente lendo reuniões — veja Servidor MCP.

Escreva um cliente HTTP quando estiver construindo um serviço, e não pilotando um modelo.

Se você vai gerar código de integração

Três coisas erram com facilidade e vale ler antes de escrever qualquer linha:

1. Itere por pagination.has_more, nunca por data.length. Uma página pode vir curta ou vazia com dado restante. Veja Paginação.
2. Ramifique por error.code, nunca por error.detail. O detalhe é texto humano e pode ser reescrito. Veja Erros.
3. Não deduza o tipo de recurso pelo type. O object diz se é meeting ou call; o type diz só video ou audio, e os dois são independentes. Veja Reuniões e ligações.

Não existe refresh token — renovar é chamar /oauth/token de novo. Isso é propriedade do fluxo client credentials, não omissão.