Introdução à API
Referência técnica e catálogo completo das operações da API da plataforma DOM360.
Portal de Desenvolvedores DOM360
Plataforma unificada para orquestração de agentes de inteligência artificial, telefonia por voz, campanhas omnicanal, ferramentas MCP e gestão operacional de alta escala.
A API da DOM360 é o ecossistema central de comunicação programática da plataforma, permitindo orquestrar agentes autônomos de texto e voz, disparar e gerenciar chamadas telefônicas via troncos SIP, conduzir campanhas omnicanal, integrar provedores externos e controlar operações corporativas e financeiras com rastreabilidade total.
Todos os endpoints são declarados sob especificação OpenAPI 3.1 com tipagem estrita e suporte nativo a repetição segura via chaves de idempotência.
Primeiros Passos
Para realizar sua primeira integração com a API, confira os guias fundamentais de segurança, padronização e arquitetura:
Autenticação
Uso de Bearer tokens JWT e Personal Access Tokens (PAT). Regras para operações públicas e protegidas.
Erros Padronizados
Estrutura canônica de respostas de erro com códigos machine-readable e mensagens explicativas.
Paginação por Cursor
Navegação determinística em grandes volumes de dados através de ponteiros opacos.
Idempotência
Garantia de execução única através do cabeçalho Idempotency-Key em operações sensíveis.
Plataforma e Agentes de IA
A DOM360 combina agentes autônomos de texto e voz com ferramentas conectadas via protocolo MCP:
MCPs (Ferramentas)
Catálogo de 8 namespaces e 51 ferramentas integradas (CRM, Gmail, WhatsApp, Calendário, E-mail, Base de Conhecimento).
Agentes de IA
Criação, configuração de modelos, ciclo de vida (Rascunho a Produção), propósitos e vínculo com canais.
Qualidade de Prompt
Boas práticas essenciais, anatomia de um prompt de produção e como estruturar regras de negócio e limites.
Primeira Chamada de API
Com seu token pessoal de acesso em mãos, envie uma mensagem diretamente para a rota de execução de agentes:
curl -X POST "https://<seu-servidor>/api/v3/runs" \
-H "Authorization: Bearer dom_pat_..." \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "3f6c2a9e-1b7d-4c1e-9a0f-5d2e8b7c4a10",
"input": { "message": "Olá, quero agendar uma revisão." }
}'A resposta 201 Created traz o resultado completo do ciclo de inferência do modelo:
reply.content: texto ou fala gerado pelo agente;usage: detalhamento de tokens de entrada e saída consumidos;tool_calls: chamadas de ferramentas e funções MCP disparadas durante a sessão;conversation_id: identificador de sessão para manter o histórico conversacional em turnos subsequentes.
Referência por Domínio Operacional
Explore as operações organizadas por domínio de negócio. Cada endpoint inclui documentação detalhada dos parâmetros, corpos de requisição e exemplos executáveis com playground integrado.
Execução e Atendimento Inteligente
Execução de Conversas
Sessões de agentes conversacionais, transcrições e ciclo de vida de runs de IA.
Agentes Autônomos
Configuração de modelos, ferramentas, documentos de conhecimento e versionamento.
Ligações e Telefonia
Chamadas ativas e receptivas, filas de discagem, gravações e logs de áudio.
Campanhas de Contato
Campanhas em lote, cadências automatizadas, listas de contatos e tentativas de discagem.
Resultados e Análise
Classificação de chamadas, sumários executivos e execução de hooks de pós-atendimento.
Canais de Comunicação
Automações de texto, canais de mensageria, modelos e gerenciamento de sessões.
Integrações, MCP e Telefonia SIP
Servidores e Ferramentas MCP
Catálogo de ferramentas integradas, servidores MCP runtime e testes de conectividade.
Provedores e Integrações
Conexão com CRMs, Chatwoot, Google Workspace, e-mails transacionais e autorizações.
Modelos e Templates
Templates de agentes de voz e chat, rascunhos, publicação e distribuição.
Troncos SIP e Rotas
Provisionamento de troncos SIP, credenciais, rotas de saída e testes de conectividade.
Organização, Clientes e Identidade
Identidade e Sessões
Perfil do operador, tokens de acesso pessoal, credenciais e recuperação de senha.
Gestão de Usuários
Criação, listagem e controle de permissões de usuários no sistema.
Clientes (Tenants)
Gerenciamento multi-tenant de clientes, configurações isoladas e provisionamento.
Revendas e Parceiros
Gestão de dealers, personalização de marca e configurações de domínio próprio.
Ativos Públicos
Recursos públicos de marca, logos e identidades visuais de revendas.
Faturamento, Preços e Governança
Financeiro e Cobrança
Faturas, conciliação de encargos, notas de crédito, termos e regras de cobrança.
Tabelas de Preços
Modelos de precificação, taxas de câmbio e tarifas de telefonia SIP.
Métricas de Consumo
Acompanhamento de franquias, minutos de voz e consumo de tokens em tempo real.
Auditoria de Segurança
Log imutável de eventos de auditoria para rastreabilidade de ações críticas.