DOS AI

Servidor MCP remoto para gestionar asistentes de IA de WhatsApp y Telegram: proyectos, prompts, conversaciones, clientes potenciales y analíticas, sin herramientas destructivas por diseño.

GitHubPrueba este MCPPatrocinado

Documentación

API y servidor MCP de DOS AI

Interfaces públicas de DOS AI, una plataforma para asistentes de IA (chatbots) en WhatsApp y Telegram con CRM integrado.

Este repositorio contiene el contrato legible por máquina y ejemplos ejecutables. La plataforma en sí está alojada, por lo que no hay nada que instalar: obtienes una clave API en el panel y llamas a los endpoints que se indican a continuación.

Especificación OpenAPI: https://dosai.pro/api/openapi.json
Endpoint MCP: https://dosai.pro/api/mcp
Guía básica del agente: https://dosai.pro/llms.txt
Corpus público completo (guía + curso + artículos): https://dosai.pro/llms-full.txt
Documentación humana: https://dosai.pro/docs/guide/08-developers/80-public-api

Qué hace la plataforma

Un proyecto en DOS AI es un bot: sus instrucciones, su base de conocimiento, su canal (WhatsApp mediante QR o Telegram), su saldo y sus clientes. El bot responde a los mensajes entrantes en lenguaje natural, reserva franjas horarias desde un Google Calendar o Sheet, emite facturas en el chat, registra cada conversación como un lead y transfiere el diálogo a un humano cuando tus reglas lo indican.

La API expone esos mismos datos: proyectos, conversaciones, mensajes, leads, analíticas y saldo.

Autenticación

Cada solicitud lleva una clave API emitida en el panel:

Authorization: Bearer dos_sk_live_...

La clave autentica como el usuario que la creó, por lo que hereda el acceso de ese usuario. Solo se almacena un hash SHA-256 de la clave, lo que significa que una clave perdida no se puede recuperar, solo revocar y reemitir. Las claves pueden limitarse a un solo proyecto y a acceso de solo lectura.

Límite de velocidad: 120 solicitudes por minuto por clave, más un presupuesto más estricto por endpoint. En un error 429, el encabezado Retry-After te indica cuántos segundos esperar.

REST en un 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"

Rutas disponibles (esquemas completos en el archivo OpenAPI):

Ruta	Qué proporciona
`/api/projects`	lista de proyectos
`/api/projects/{id}`	un proyecto, incluido su prompt
`/api/projects/{id}/conversations`	diálogos con filtros y paginación
`/api/projects/{id}/leads`	leads con estado y fuente
`/api/projects/{id}/leads/export`	leads en CSV
`/api/projects/{id}/analytics`	diálogos, leads, conversión, tiempo de respuesta
`/api/projects/{id}/functions`	funciones que el bot puede llamar
`/api/projects/{id}/integrations`	integraciones conectadas de Google y CRM
`/api/projects/{id}/reports`	informes del propietario
`/api/projects/{id}/tokens`	saldo
`/api/projects/{id}/tokens/history`	movimientos de saldo

Las respuestas vienen envueltas en un sobre ({ "data": ... }), así que desenvuélvelas antes de usarlas. El archivo OpenAPI es la autoridad aquí y se genera desde la misma fuente contra la que se verifican las rutas.

MCP: conecta un asistente de IA

La plataforma incluye un endpoint del Model Context Protocol, por lo que un asistente de IA puede leer y gestionar tus bots directamente. Apunta tu cliente MCP a:

https://dosai.pro/api/mcp

Herramientas expuestas (todas con el prefijo 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.

Dos decisiones de diseño que vale la pena conocer:

Sin herramientas destructivas. No hay eliminar-proyecto, ni pagos, ni gestión de miembros. Añadir una sería una decisión consciente, no un reflejo, y una prueba protege la lista.

Cada herramienta llama a la ruta REST pública por HTTP, no a una capa de servicio interna. De ese modo, una clave de solo lectura sigue siendo de solo lectura, el alcance del proyecto y los límites de velocidad se aplican exactamente una vez, y el agente no puede acceder a nada que un humano con la misma clave no pudiera.

Ejemplo de configuración de cliente (estilo Claude Desktop):

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

Webhooks

En lugar de hacer polling, puedes recibir eventos en tu propio endpoint: nuevo lead, nuevo mensaje, cambio de etapa. La verificación de firma y las formas de los payloads están documentadas en https://dosai.pro/docs/guide/08-developers/81-custom-webhooks

Ejemplos

examples/list-leads.sh — curl, leads y analíticas
examples/list-leads.js — Node, sin dependencias
examples/list_leads.py — Python, solo biblioteca estándar

Cómo obtener una clave

Regístrate en https://dosai.pro/register (se concede un saldo inicial, sin necesidad de tarjeta)
Crea un proyecto y conecta un canal
Abre el panel, sección claves API, y emite una clave con el alcance que necesites

Enlaces

Licencia

Los ejemplos de este repositorio son MIT. La plataforma en sí es un servicio comercial alojado.