Conhece o negócio
Serviços, duração, preço, profissionais, fuso horário e a data de hoje no fuso do negócio.
get_businessSe a sua empresa já tem um bot que fala com clientes no WhatsApp ou em outro canal, conecte ele ao Calendsk. O bot cuida da conversa; os horários livres, os agendamentos e os lembretes ficam aqui.
Até 10 agendamentos por mês são grátis. Sem cartão de crédito.
Studio Aurora
bot conectado ao Calendsk
Oi! Tem horário pra corte na sexta?
Tem sim! Sexta com a Camila:
14:30, por favor
Pronto, Marina! Corte na sexta às 14:30 com a Camila. Código A1B2C3D4.
ferramenta chamada pelo bot
create_booking({
starts_at: "2026-11-20T14:30:00-03:00",
customer_name: "Marina Lima",
customer_phone: "+5581999990000"
})agendamento confirmado · A1B2C3D4
Funciona com o agente que você já usa
Qualquer agente que fale MCP (Streamable HTTP) ou chame uma API REST conecta na agenda.
Sem instalar nada: é uma chave e um endereço.
No painel, em Ajustes → API e MCP. Escolha se a chave só consulta ou se também agenda. Ela aparece uma única vez.
Por MCP, no endereço abaixo, ou pela API REST em /api/v1. A chave vai no cabeçalho Authorization; no MCP, o agente também pode entrar com o seu login (OAuth), sem chave.
Ele lê os serviços e os horários livres, confirma com o cliente e cria o agendamento. Você vê tudo no painel.
{
"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": "veio pelo WhatsApp"
}'As mesmas operações existem no MCP e na API REST, com as mesmas regras da agenda.
Serviços, duração, preço, profissionais, fuso horário e a data de hoje no fuso do negócio.
get_businessDia a dia, até 14 dias de uma vez, já com a hora local pronta para falar ao cliente.
get_available_slotsDois clientes nunca ficam no mesmo horário: quem chega depois recebe SLOT_TAKEN e o bot oferece outro.
create_bookingLista os agendamentos de quem está na conversa pelo número de telefone, ou busca pelo código.
list_bookingsget_bookingRespeitando até quantas horas antes o negócio permite mudar. Remarcar não gasta o limite do mês.
reschedule_bookingcancel_bookingO cliente disse que vai? O bot registra e a confirmação aparece no painel do negócio.
confirm_bookingCom uma chave de idempotência, repetir a mesma chamada devolve o mesmo agendamento.
idempotency_keyToda falha vem com código estável, mensagem e, quando faz sentido, em quanto tempo tentar de novo.
{ code, message, retry_after }Cada agendamento criado traz um link para o cliente ver, remarcar ou cancelar sozinho.
manage_urlCom celular válido, o Calendsk manda o lembrete até 24 h antes do horário. Dá para desligar se o seu bot já lembra o cliente.
O agendamento aparece na agenda marcado como “bot”, com aviso para o negócio.
Melhor saber antes de integrar.
O Calendsk não envia nem responde as mensagens do atendimento. A conversa é do seu bot; aqui ficam a agenda e o lembrete.
O lembrete do Calendsk para agendamentos do bot é opcional. Se o seu bot já lembra o cliente, desligue em Ajustes.
É o limite de cada API key, somando MCP e API REST.
Agendamento criado pelo bot conta como qualquer outro: 10 por mês no plano Grátis, ilimitados no Profissional (R$ 49,90 por mês).
Não. Qualquer agente que conecte em um servidor MCP por Streamable HTTP ou que consiga chamar uma API REST funciona: OpenClaw, Hermes Agent, ChatGPT, Claude, n8n e outros.
Não. Quem conversa com o cliente é o seu bot. O Calendsk guarda os agendamentos e manda apenas o lembrete, até 24 h antes, quando o agendamento tem um celular válido.
Só o primeiro agenda. O segundo recebe o erro SLOT_TAKEN, e o bot busca os horários de novo para oferecer outro.
Por padrão vale o prazo que o negócio definiu em Ajustes (por exemplo, até 2 horas antes). Fora do prazo a chamada devolve WINDOW_CLOSED.
Nada a mais. Os agendamentos do bot entram no limite do seu plano: 10 por mês no Grátis e ilimitados no Profissional, por R$ 49,90 por mês.
Crie a conta, gere a API key e conecte. Os primeiros agendamentos do mês são por nossa conta.