Visão geral
A API REST do Rouxinol permite integrar seus sistemas com os dados da sua conta: agentes, conexões, contatos, equipes, URAs, formulários e o histórico de chamadas.
Autenticação
A API v1 do Rouxinol usa OAuth 2.0 Client Credentials Grant. Não existe usuário associado ao token — ele autentica a sua aplicação (o "App"), e todas as requisições feitas com esse token acessam os dados da conta (tenant) dona do App.
Agentes
CRUD completo para os agentes de IA da conta.
Ferramentas de agente (Tools)
CRUD completo para as ferramentas de um agente específico. É um recurso aninhado: toda rota parte de /api/v1/agents//tools.
Conexões de IA
CRUD completo para as conexões de IA usadas pelos agentes.
Conexões SIP
CRUD completo para as conexões SIP da conta.
Conexões WhatsApp
CRUD completo para as conexões WhatsApp da conta.
Contatos
CRUD completo para os contatos da conta — usados, por exemplo, como destino de transferência de chamadas.
Equipes
CRUD completo para equipes (filas de atendimento), que agrupam contatos.
Formulários
CRUD completo para formulários — conjuntos de perguntas que podem ser aplicados por uma URA durante o atendimento.
URAs
CRUD completo para URAs (fluxos de atendimento automatizado) — vinculadas a uma conexão SIP ou WhatsApp, definem os passos que acontecem antes ou no lugar do agente de IA.
Chamadas
Consulta ao histórico de chamadas da conta. Este recurso é somente leitura — os registros são criados automaticamente pelo sistema durante o atendimento real (via Janus, Twilio ou WhatsApp), não pela API.
Agendamentos
Consulta e gestão dos compromissos criados pelos agentes durante o atendimento — a mesma ferramenta Agendar Compromisso documentada no guia de agentes.
Webhooks e endpoints internos
Além da API v1, o Rouxinol expõe alguns endpoints usados internamente pela plataforma para receber eventos de provedores externos (Twilio, Meta) ou para a comunicação entre o navegador e o Janus. Eles não fazem parte da API pública para integradores e não usam OAuth2 — cada um tem seu próprio mecanismo de autenticação (ou nenhum). Documentados aqui apenas para referência.