API e MCP para bots de atendimento

Seu bot conversa. O Calendsk guarda a agenda.

Se 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.

Funciona com o agente que você já usa

Qualquer agente que fale MCP (Streamable HTTP) ou chame uma API REST conecta na agenda.

OpenClawHermes AgentOpenDotsOpenAI DotsChatGPTClaudeGeminiGrokCursorn8nPerplexity
Como funciona

Do zero ao primeiro agendamento em três passos

Sem instalar nada: é uma chave e um endereço.

  1. 01

    Crie uma API key

    No painel, em Ajustes → API e MCP. Escolha se a chave só consulta ou se também agenda. Ela aparece uma única vez.

  2. 02

    Conecte o bot

    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.

  3. 03

    O bot consulta e agenda

    Ele lê os serviços e os horários livres, confirma com o cliente e cria o agendamento. Você vê tudo no painel.

Configuração do MCP
{
  "mcpServers": {
    "calendsk": {
      "type": "http",
      "url": "https://calendsk.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer csk_SUA_API_KEY"
      }
    }
  }
}
GET /api/v1/slots · Horários livres
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 · Criar agendamento
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"
  }'
O que o bot faz

Tudo o que a recepção faz, em oito ferramentas

As mesmas operações existem no MCP e na API REST, com as mesmas regras da agenda.

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_business

Vê os horários livres

Dia a dia, até 14 dias de uma vez, já com a hora local pronta para falar ao cliente.

get_available_slots

Agenda sem conflito

Dois clientes nunca ficam no mesmo horário: quem chega depois recebe SLOT_TAKEN e o bot oferece outro.

create_booking

Acha o cliente pelo celular

Lista os agendamentos de quem está na conversa pelo número de telefone, ou busca pelo código.

list_bookingsget_booking

Remarca e cancela

Respeitando até quantas horas antes o negócio permite mudar. Remarcar não gasta o limite do mês.

reschedule_bookingcancel_booking

Confirma presença

O cliente disse que vai? O bot registra e a confirmação aparece no painel do negócio.

confirm_booking

Repete sem duplicar

Com uma chave de idempotência, repetir a mesma chamada devolve o mesmo agendamento.

idempotency_key

Erros que o bot entende

Toda falha vem com código estável, mensagem e, quando faz sentido, em quanto tempo tentar de novo.

{ code, message, retry_after }

Link para o cliente

Cada agendamento criado traz um link para o cliente ver, remarcar ou cancelar sozinho.

manage_url

Lembrete pelo WhatsApp

Com 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.

Tudo no painel do dono

O agendamento aparece na agenda marcado como “bot”, com aviso para o negócio.

Sem letra miúda

O que o Calendsk não faz

Melhor saber antes de integrar.

Não conversa com o cliente

O Calendsk não envia nem responde as mensagens do atendimento. A conversa é do seu bot; aqui ficam a agenda e o lembrete.

Não manda dois lembretes

O lembrete do Calendsk para agendamentos do bot é opcional. Se o seu bot já lembra o cliente, desligue em Ajustes.

120 chamadas por minuto

É o limite de cada API key, somando MCP e API REST.

Conta no limite do plano

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).

Dúvidas

Perguntas de quem vai integrar

Preciso de um bot específico?

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.

O Calendsk manda as mensagens do WhatsApp pelo meu bot?

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.

E se dois clientes pedirem o mesmo horário?

Só o primeiro agenda. O segundo recebe o erro SLOT_TAKEN, e o bot busca os horários de novo para oferecer outro.

O bot pode cancelar a qualquer momento?

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.

Quanto custa usar a API?

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.

Coloque seu bot para agendar hoje

Crie a conta, gere a API key e conecte. Os primeiros agendamentos do mês são por nossa conta.