Guia completo de Cal.com
Receba reservas do Cal.com, crie ou atualize contatos e envie confirmações e lembretes automáticos pelo WhatsApp.
Prefere ler? O passo a passo completo continua logo abaixo. Ir para o passo a passo ↓
Da conexão ao uso diário
As telas abaixo são reais do sistema e não expõem credenciais.
Configure Cal.com
Preencha somente os dados da própria empresa e faça um teste controlado.

O que esta integração faz
| Integração | Cal.com |
| Categoria | Agendamento por webhook |
| Configuração | Individual por empresa e acessível em Integrações. |
| Uso final | Agenda, Contatos, WhatsApp ou sistema externo conforme o fluxo. |
Antes de configurar
- Conta Cal.com com acesso a Webhooks.
- Conexão WhatsApp ativa para lembretes.
- Tipos de evento e perguntas do formulário já definidos.
- API Key apenas se quiser cancelar ou reagendar pela API.
Passo a passo completo
- Clique em Nova Integração e informe um nome interno.
- Selecione a conexão WhatsApp usada nos lembretes.
- Salve para gerar a URL exclusiva de webhook.
- No Cal.com, abra Configurações → Desenvolvedor → Webhooks e adicione a URL.
- Marque os eventos de reserva criada, reserva cancelada e reserva reagendada.
- Ajuste os lembretes e as mensagens de confirmação.
- Faça uma reserva teste e confira evento, contato e relatório.
Use um evento, paciente ou contato demonstrativo, confirme todo o caminho e só depois ative para a operação real.
Campos e elementos importantes
| Nome interno | Ajuda a separar agendas ou equipes. |
| Conexão WhatsApp | Canal usado para confirmação, lembrete e cancelamento. |
| API Key | Opcional; permite ações diretas pela API Cal.com. |
| Webhook | URL exclusiva que recebe reservas e alterações. |
| Telefone do participante | O CRM usa o telefone informado na reserva; inclua no tipo de evento do Cal.com uma pergunta de telefone ou WhatsApp. |
Como o fluxo funciona
| Reserva criada | Cria o evento, identifica o participante e agenda lembretes. |
| Reserva reagendada | Atualiza data e horário e reorganiza os lembretes. |
| Reserva cancelada | Cancela o evento e impede lembretes futuros. |
| Relatório | Mostra agendamentos e desempenho da integração. |
Diagnóstico rápido
| Nenhum evento chega | Revise a URL e os três eventos de reserva marcados no Cal.com. |
| Contato sem telefone | Inclua no tipo de evento do Cal.com uma pergunta que colete o telefone ou WhatsApp. |
| Lembrete não envia | Confira a conexão e os minutos configurados. |
| Reagendamento duplicado | Confirme se existe apenas um endpoint ativo para a mesma integração. |
Checklist antes de ativar
- Use somente credenciais e contas da empresa.
- Nunca compartilhe tokens, senhas ou URLs privadas.
- Revise fuso horário, agenda e responsável padrão.
- Use o modo de teste sem gravação quando disponível.
- Valide um único evento do início ao fim.
- Confira logs, contatos, Agenda e mensagens antes de liberar.
Dúvidas frequentes
A API Key é obrigatória?
Não para receber webhooks; ela é usada em ações adicionais pela API.
Posso ter várias agendas?
Sim. Crie integrações separadas e dê nomes claros.
O cancelamento remove o contato?
Não. Ele atualiza o evento e cancela os lembretes.
Onde vejo os resultados?
Na lista da integração e no Relatório do Cal.com.
O suporte precisa da minha credencial?
Não envie credenciais. Compartilhe somente a mensagem de erro, horário do teste e prints sem dados sensíveis.