API
Realtime
Endpoints WebSocket e REST para chamadas de voz em tempo real.
Realtime
Os endpoints realtime geram sessões de voz com OpenAI Realtime API (WebRTC) e fluxos conversacionais.
REST endpoints
Prefixo: /api/v1/realtime
| Método | Caminho | Descrição |
|---|---|---|
| POST | /sessions | Cria sessão realtime para browser demo. |
| POST | /sessions/end | Termina sessão. |
| POST | /tools/execute | Executa ferramenta durante chamada. |
| POST | /flow/sessions | Cria sessão guiada por fluxo. |
| POST | /flow/advance | Avança sessão guiada por fluxo. |
| GET | /flow/sessions/{session_id}/state | Estado da sessão. |
| POST | /flow/sessions/{session_id}/end | Termina sessão guiada. |
| POST | /bookings | Cria marcação de demo. |
| POST | /debug-logs | Escreve log de debug (apenas local). |
| POST | /tts | Transmite áudio TTS. |
WebSocket
| Caminho | Descrição |
|---|---|
/api/v1/realtime/tts/ws | Stream contínuo de TTS. |
Autenticação
Realtime usa resolve_realtime_auth, que pode aceitar token de sessão específico. Para chamadas browser, a sessão é criada pelo backoffice e devolve session_id e token.
Ferramentas durante chamada
O endpoint /tools/execute permite que o modelo invoque funções configuradas no agente (ex.: transferência, agendamento, SMS). O pedido inclui session_id, tool_name e arguments.