API Salesbud

Cada reunião e ligação concluída que sua empresa grava, como recurso JSON estável. Transcrições, respostas de template, avaliações e sinais de enablement em uma API REST versionada.

Começo rápido Referência da API

Duas coleções

Reunião gravada pelo bot e ligação capturada por VoIP são recursos diferentes, então vivem em caminhos diferentes: /v1/meetings e /v1/calls. Mesma forma, identificadores próprios.

Escopo de uma empresa

A credencial pertence a uma empresa, nunca a um usuário. Toda leitura é filtrada por ela — não existe parâmetro que amplie esse escopo.

Identificadores estáveis

Recursos são endereçados por ids opacos com prefixo (mtg_, call_, usr_). Ids internos sequenciais nunca são expostos.

Feita para agentes

Toda página existe em Markdown puro, além de llms.txt e llms-full.txt para ferramentas que leem documentação diretamente.

Sua primeira requisição

Troque a credencial por um token de acesso e leia uma página de reuniões.

# 1. Obtenha um token de acesso (vale 1 hora)
curl -X POST https://api.salesbud.com.br/oauth/token \
  -d 'grant_type=client_credentials' \
  -d "client_id=$SALESBUD_CLIENT_ID" \
  -d "client_secret=$SALESBUD_CLIENT_SECRET"

# 2. Leia as reuniões concluídas de um período
curl "https://api.salesbud.com.br/v1/meetings?meeting_after=2026-01-01T00:00:00Z&limit=50" \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

A resposta é uma página de reuniões mais um cursor:

{
  "data": [
    {
      "id": "mtg_H9_chV2YG6UGE0n31AqvDQ",
      "object": "meeting",
      "title": "Discovery — Acme",
      "status": "completed",
      "type": "video",
      "audience": "external",
      "meeting_at": "2026-01-14T13:00:00.000Z",
      "duration_seconds": 2840,
      "participants": [{ "email": "comprador@acme.com", "kind": "external" }],
      "owner": { "id": "usr_CKAyHd20jJb6GGJqhNF9vA", "email": "vendedor@suaempresa.com" },
      "transcript": { "available": true, "status": "completed" }
    }
  ],
  "pagination": { "limit": 50, "has_more": true, "next_cursor": "cur_..." }
}

Por onde seguir

Se você quer…	Leia
Fazer a primeira chamada de ponta a ponta	Começo rápido
Entender credenciais, tokens e escopos	Autenticação
Saber quando um registro é `meeting` e quando é `call`	Reuniões e ligações
Percorrer todo o histórico com segurança	Paginação
Tratar falhas corretamente	Erros
Ver cada endpoint, campo e status	Referência da API