DOS AI

Servidor MCP remoto para gerenciar assistentes de IA do WhatsApp e Telegram: projetos, prompts, conversas, leads e análises, sem ferramentas destrutivas por design.

GitHubExperimente este MCPPatrocinado

Documentação

API e servidor MCP do DOS AI

Interfaces públicas do DOS AI, uma plataforma para assistentes de IA (chatbots) no WhatsApp e Telegram com CRM integrado.

Este repositório contém o contrato legível por máquina e exemplos executáveis. A plataforma em si é hospedada, então não há nada para instalar: você obtém uma chave de API no painel e chama os endpoints abaixo.

Especificação OpenAPI: https://dosai.pro/api/openapi.json
Endpoint MCP: https://dosai.pro/api/mcp
Guia do agente: https://dosai.pro/llms.txt
Corpus público completo (guia + curso + artigos): https://dosai.pro/llms-full.txt
Documentação humana: https://dosai.pro/docs/guide/08-developers/80-public-api

O que a plataforma faz

Um projeto no DOS AI é um bot: suas instruções, sua base de conhecimento, seu canal (WhatsApp via QR ou Telegram), seu saldo e seus clientes. O bot responde mensagens recebidas em linguagem natural, agenda horários de um Google Calendar ou Planilha, emite faturas no chat, registra cada conversa como lead e transfere o diálogo para um humano quando suas regras determinam.

A API expõe esses mesmos dados: projetos, conversas, mensagens, leads, análises e saldo.

Autenticação

Cada requisição carrega uma chave de API emitida no painel:

Authorization: Bearer dos_sk_live_...

A chave autentica como o usuário que a criou, portanto herda o acesso desse usuário. Apenas um hash SHA-256 da chave é armazenado, o que significa que uma chave perdida não pode ser recuperada, apenas revogada e reemitida. As chaves podem ser limitadas a um único projeto e a acesso somente leitura.

Limite de taxa: 120 requisições por minuto por chave, além de um orçamento mais restrito por endpoint. Em caso de 429, o cabeçalho Retry-After informa quantos segundos aguardar.

REST em um minuto

export DOSAI_KEY="dos_sk_live_..."

# projects visible to this key
curl -s https://dosai.pro/api/projects \
  -H "Authorization: Bearer $DOSAI_KEY"

# leads of one project
curl -s "https://dosai.pro/api/projects/$PROJECT_ID/leads?limit=20" \
  -H "Authorization: Bearer $DOSAI_KEY"

# analytics for a period
curl -s "https://dosai.pro/api/projects/$PROJECT_ID/analytics?from=2026-08-01&to=2026-08-14" \
  -H "Authorization: Bearer $DOSAI_KEY"

Caminhos disponíveis (esquemas completos no arquivo OpenAPI):

Caminho	O que fornece
`/api/projects`	lista de projetos
`/api/projects/{id}`	um projeto, incluindo seu prompt
`/api/projects/{id}/conversations`	diálogos com filtros e paginação
`/api/projects/{id}/leads`	leads com status e origem
`/api/projects/{id}/leads/export`	leads em CSV
`/api/projects/{id}/analytics`	diálogos, leads, conversão, tempo de resposta
`/api/projects/{id}/functions`	funções que o bot pode chamar
`/api/projects/{id}/integrations`	integrações conectadas do Google e CRM
`/api/projects/{id}/reports`	relatórios do proprietário
`/api/projects/{id}/tokens`	saldo
`/api/projects/{id}/tokens/history`	movimentações de saldo

As respostas vêm em um envelope ({ "data": ... }), então desembrulhe antes de usar. O arquivo OpenAPI é a autoridade aqui e é gerado a partir da mesma fonte contra a qual as rotas são verificadas.

MCP: conecte um assistente de IA

A plataforma oferece um endpoint do Model Context Protocol, para que um assistente de IA possa ler e gerenciar seus bots diretamente. Aponte seu cliente MCP para:

https://dosai.pro/api/mcp

Ferramentas expostas (todas com prefixo dosai_):

list_projects, get_project, get_prompt, update_prompt, list_functions, list_leads, get_lead, update_lead, list_conversations, get_messages, send_operator_message, get_analytics, get_balance.

Duas decisões de design que vale a pena conhecer:

Sem ferramentas destrutivas. Não há exclusão de projeto, pagamento ou gerenciamento de membros. Adicionar uma seria uma decisão consciente, não um reflexo, e um teste protege a lista.

Cada ferramenta chama a rota REST pública via HTTP, não uma camada de serviço interna. Dessa forma, uma chave somente leitura permanece somente leitura, o escopo do projeto e os limites de taxa se aplicam exatamente uma vez, e o agente não pode acessar nada que um humano com a mesma chave não pudesse.

Exemplo de configuração de cliente (estilo Claude Desktop):

{
  "mcpServers": {
    "dosai": {
      "url": "https://dosai.pro/api/mcp",
      "headers": { "Authorization": "Bearer dos_sk_live_..." }
    }
  }
}

Webhooks

Em vez de fazer polling, você pode receber eventos no seu próprio endpoint: novo lead, nova mensagem, mudança de etapa. A verificação de assinatura e os formatos de payload estão documentados em https://dosai.pro/docs/guide/08-developers/81-custom-webhooks

Exemplos

examples/list-leads.sh — curl, leads e análises
examples/list-leads.js — Node, sem dependências
examples/list_leads.py — Python, apenas biblioteca padrão

Obtendo uma chave

Registre-se em https://dosai.pro/register (um saldo inicial é concedido, sem necessidade de cartão)
Crie um projeto e conecte um canal
Abra o painel, seção de chaves de API, e emita uma chave com o escopo que você precisa

Licença

Os exemplos neste repositório são MIT. A plataforma em si é um serviço comercial hospedado.