Conoce el negocio
Servicios, duración, precio, profesionales, zona horaria y la fecha de hoy en la zona del negocio.
get_businessSi 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.
Studio Aurora
bot conectado a Calendsk
¡Hola! ¿Hay hora para un corte el viernes?
¡Sí! El viernes con Camila:
14:30, por favor
¡Listo, Marina! Corte el viernes a las 14:30 con Camila. Código A1B2C3D4.
herramienta llamada por el bot
create_booking({
starts_at: "2026-11-20T14:30:00-03:00",
customer_name: "Marina Lima",
customer_phone: "+5581999990000"
})reserva confirmada · A1B2C3D4
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.
Sin instalar nada: es una clave y una dirección.
En el panel, en Ajustes → API y MCP. Elige si la clave solo consulta o si también reserva. Se muestra una única vez.
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.
Lee los servicios y los horarios libres, confirma con el cliente y crea la reserva. Tú ves todo en el panel.
{
"mcpServers": {
"calendsk": {
"type": "http",
"url": "https://calendsk.com.br/api/mcp",
"headers": {
"Authorization": "Bearer csk_SUA_API_KEY"
}
}
}
}curl "https://calendsk.com.br/api/v1/slots?service_id=SERVICE_ID&days=3" \
-H "Authorization: Bearer csk_SUA_API_KEY"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"
}'Las mismas operaciones existen en el MCP y en la API REST, con las mismas reglas de la agenda.
Servicios, duración, precio, profesionales, zona horaria y la fecha de hoy en la zona del negocio.
get_businessDía a día, hasta 14 días de una vez, ya con la hora local lista para decirle al cliente.
get_available_slotsDos clientes nunca quedan en el mismo horario: el que llega después recibe SLOT_TAKEN y el bot ofrece otro.
create_bookingLista las reservas de quien está en la conversación por el número de teléfono, o busca por el código.
list_bookingsget_bookingRespetando hasta cuántas horas antes el negocio permite cambiar. Reprogramar no gasta el límite del mes.
reschedule_bookingcancel_booking¿El cliente dijo que va? El bot lo registra y la confirmación aparece en el panel del negocio.
confirm_bookingCon una clave de idempotencia, repetir la misma llamada devuelve la misma reserva.
idempotency_keyCada fallo llega con código estable, mensaje y, cuando tiene sentido, en cuánto tiempo reintentar.
{ code, message, retry_after }Cada reserva creada trae un enlace para que el cliente la vea, la reprograme o la cancele solo.
manage_urlCon 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.
La reserva aparece en la agenda marcada como “bot”, con aviso para el negocio.
Mejor saberlo antes de integrar.
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.
El recordatorio de Calendsk para reservas del bot es opcional. Si tu bot ya le recuerda al cliente, desactívalo en Ajustes.
Es el límite de cada API key, sumando MCP y API REST.
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).
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.
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.
Solo el primero reserva. El segundo recibe el error SLOT_TAKEN, y el bot vuelve a buscar los horarios para ofrecer otro.
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.
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.
Crea la cuenta, genera la API key y conecta. Las primeras reservas del mes corren por nuestra cuenta.