API y MCP para bots de atención

Tu bot conversa. Calendsk guarda la agenda.

Si tu empresa ya tiene un bot que habla con clientes en WhatsApp o en otro canal, conéctalo a Calendsk. El bot se ocupa de la conversación; los horarios libres, las reservas y los recordatorios quedan aquí.

Hasta 10 reservas al mes son gratis. Sin tarjeta de crédito.

Funciona con el agente que ya usas

Cualquier agente que hable MCP (Streamable HTTP) o llame a una API REST se conecta a la agenda.

OpenClawHermes AgentOpenDotsOpenAI DotsChatGPTClaudeGeminiGrokCursorn8nPerplexity
Cómo funciona

De cero a la primera reserva en tres pasos

Sin instalar nada: es una clave y una dirección.

  1. 01

    Crea una API key

    En el panel, en Ajustes → API y MCP. Elige si la clave solo consulta o si también reserva. Se muestra una única vez.

  2. 02

    Conecta el bot

    Por MCP, en la dirección de abajo, o por la API REST en /api/v1. La clave va en el encabezado Authorization; por MCP, el agente también puede entrar con tu cuenta (OAuth), sin clave.

  3. 03

    El bot consulta y reserva

    Lee los servicios y los horarios libres, confirma con el cliente y crea la reserva. Tú ves todo en el panel.

Configuración del MCP
{
  "mcpServers": {
    "calendsk": {
      "type": "http",
      "url": "https://calendsk.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer csk_SUA_API_KEY"
      }
    }
  }
}
GET /api/v1/slots · Horarios libres
curl "https://calendsk.com.br/api/v1/slots?service_id=SERVICE_ID&days=3" \
  -H "Authorization: Bearer csk_SUA_API_KEY"
POST /api/v1/bookings · Crear reserva
curl -X POST "https://calendsk.com.br/api/v1/bookings" \
  -H "Authorization: Bearer csk_SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: conversa-8841-sexta-1430" \
  -d '{
    "service_id": "SERVICE_ID",
    "starts_at": "2026-11-20T14:30:00-03:00",
    "customer_name": "Marina Lima",
    "customer_phone": "+5581999990000",
    "notes": "llegó por WhatsApp"
  }'
Qué hace el bot

Todo lo que hace la recepción, en ocho herramientas

Las mismas operaciones existen en el MCP y en la API REST, con las mismas reglas de la agenda.

Conoce el negocio

Servicios, duración, precio, profesionales, zona horaria y la fecha de hoy en la zona del negocio.

get_business

Ve los horarios libres

Día a día, hasta 14 días de una vez, ya con la hora local lista para decirle al cliente.

get_available_slots

Reserva sin conflicto

Dos clientes nunca quedan en el mismo horario: el que llega después recibe SLOT_TAKEN y el bot ofrece otro.

create_booking

Encuentra al cliente por el celular

Lista las reservas de quien está en la conversación por el número de teléfono, o busca por el código.

list_bookingsget_booking

Reprograma y cancela

Respetando hasta cuántas horas antes el negocio permite cambiar. Reprogramar no gasta el límite del mes.

reschedule_bookingcancel_booking

Confirma asistencia

¿El cliente dijo que va? El bot lo registra y la confirmación aparece en el panel del negocio.

confirm_booking

Repite sin duplicar

Con una clave de idempotencia, repetir la misma llamada devuelve la misma reserva.

idempotency_key

Errores que el bot entiende

Cada fallo llega con código estable, mensaje y, cuando tiene sentido, en cuánto tiempo reintentar.

{ code, message, retry_after }

Enlace para el cliente

Cada reserva creada trae un enlace para que el cliente la vea, la reprograme o la cancele solo.

manage_url

Recordatorio por WhatsApp

Con un celular válido, Calendsk envía el recordatorio hasta 24 h antes del horario. Puedes desactivarlo si tu bot ya le recuerda al cliente.

Todo en el panel del dueño

La reserva aparece en la agenda marcada como “bot”, con aviso para el negocio.

Sin letra pequeña

Lo que Calendsk no hace

Mejor saberlo antes de integrar.

No conversa con el cliente

Calendsk no envía ni responde los mensajes de la atención. La conversación es de tu bot; aquí quedan la agenda y el recordatorio.

Sin recordatorios duplicados

El recordatorio de Calendsk para reservas del bot es opcional. Si tu bot ya le recuerda al cliente, desactívalo en Ajustes.

120 llamadas por minuto

Es el límite de cada API key, sumando MCP y API REST.

Cuenta en el límite del plan

Una reserva creada por el bot cuenta como cualquier otra: 10 al mes en el plan Gratis, ilimitadas en el Profesional (US$ 9,90 al mes).

Dudas

Preguntas de quien va a integrar

¿Necesito un bot específico?

No. Funciona cualquier agente que se conecte a un servidor MCP por Streamable HTTP o que pueda llamar a una API REST: OpenClaw, Hermes Agent, ChatGPT, Claude, n8n y otros.

¿Calendsk envía los mensajes de WhatsApp por mi bot?

No. Quien conversa con el cliente es tu bot. Calendsk guarda las reservas y solo envía el recordatorio, hasta 24 h antes, cuando la reserva tiene un celular válido.

¿Y si dos clientes piden el mismo horario?

Solo el primero reserva. El segundo recibe el error SLOT_TAKEN, y el bot vuelve a buscar los horarios para ofrecer otro.

¿El bot puede cancelar en cualquier momento?

Por defecto vale el plazo que el negocio definió en Ajustes (por ejemplo, hasta 2 horas antes). Fuera del plazo la llamada devuelve WINDOW_CLOSED.

¿Cuánto cuesta usar la API?

Nada extra. Las reservas del bot entran en el límite de tu plan: 10 al mes en el Gratis e ilimitadas en el Profesional, por US$ 9,90 al mes.

Pon a tu bot a reservar hoy

Crea la cuenta, genera la API key y conecta. Las primeras reservas del mes corren por nuestra cuenta.