Integrar a Klyro com a Cal.com: passo a passo
Como receber as reservas da Cal.com na agenda do CRM, e o que a integração faz e não faz.
A integração envia cada reserva feita na Cal.com para a agenda do CRM da Klyro. Uma reserva criada, reagendada ou cancelada na Cal.com vira uma atividade do tipo Reunião em /crm/agenda. Esta página mostra o passo a passo e o que a plataforma faz e não faz.
Antes de começar
- Você precisa de uma conta na Cal.com com permissão para criar webhooks.
- Você precisa de um usuário administrador da sua empresa na Klyro.
- Peça à equipe Klyro a criação da integração da sua empresa. Hoje a integração é criada pela equipe, e não por uma tela da plataforma. A equipe entrega a URL do webhook e o secret.
- O token da URL e o secret aparecem uma única vez. Guarde-os em local seguro.
Passo 1: cadastre o webhook na Cal.com
- Na Cal.com, abra Settings > Developer > Webhooks e crie um novo webhook. Os nomes dos menus podem mudar em atualizações da Cal.com.
- No campo de URL do assinante, cole a URL do webhook entregue pela equipe Klyro.
- No campo de secret, cole o secret entregue pela equipe Klyro.
- Em versão do webhook, escolha
2021-10-20. - Marque os três eventos: Booking created, Booking rescheduled e Booking cancelled.
- Salve o webhook.
Passo 2: entenda como a reserva vira contato
- A Klyro identifica o contato pelo e-mail do agendador. Sem e-mail, usa o telefone.
- Se nenhum contato corresponder, a Klyro cria um contato com o nome e o e-mail da reserva.
- A Klyro não junta contatos que já existem. Se o contato tiver exatamente uma oportunidade em aberto, a atividade fica vinculada a ela.
- Uma reserva sem e-mail nem telefone do agendador é ignorada.
Passo 3: faça uma reserva de teste
- Reserve um horário no seu link da Cal.com com um e-mail que você controle.
- Aguarde até cerca de um minuto. A Klyro processa as reservas recebidas a cada minuto.
- Abra
/crm/agendano mês da reserva. A atividade aparece como Reunião, no horário da reserva e no fuso da empresa.
Passo 4: reagendamento e cancelamento
- Reagendar na Cal.com move a mesma atividade para o novo horário. A Klyro liga a reserva nova à antiga.
- Cancelar na Cal.com marca a atividade como cancelada, com o motivo informado na Cal.com quando houver.
Passo 5: automações (opcionais)
As automações são configuradas pela equipe Klyro, a pedido da empresa. Para cada evento (reserva criada, reagendada ou cancelada), a integração pode executar ações na ordem definida:
- Colocar o contato em uma tag de contato, por exemplo para separar quem agendou. A tag precisa existir na empresa e ser uma tag de contato.
- Enviar um modelo de WhatsApp aprovado, com variáveis como o link da reunião, o nome do contato ou o horário de início. Só modelos com status aprovado são enviados.
O que a integração não faz
| Item | Como funciona |
|---|---|
| Não comparecimento (no-show) | Não é recebido. A atividade não muda para “não compareceu”. |
| Criar ou mover negociações | Não é suportado nas automações. |
| Reagendamento feito pela API da Cal.com ou confirmação por link de e-mail | Pode não disparar o webhook. Não há reconciliação automática. |
| Envio de modelos | No máximo 60 eventos de automação por hora por integração. Acima disso, o envio é pulado, e lembretes de uma rajada legítima podem ficar de fora. |
| Reservas repetidas | A mesma reserva não é gravada duas vezes. |
| Conteúdo bruto das entregas | É apagado após 30 dias. |
Trocar o secret ou desligar a integração
Peça à equipe Klyro para girar o secret ou revogar a integração.
- Trocar o secret: o secret antigo continua aceito por um prazo (48 horas por padrão). Atualize o secret na Cal.com dentro desse prazo.
- Revogar: a URL deixa de aceitar reservas. Reservas já recebidas e ainda não aplicadas não entram na agenda.
Resumo: webhook na Cal.com com a URL e o secret da Klyro, versão 2021-10-20 e os eventos de criar, reagendar e cancelar. Faça uma reserva de teste e confira em /crm/agenda.
Checklist rápido
- URL e secret guardados em local seguro.
- Webhook salvo com a versão 2021-10-20 e os três eventos.
- Reserva de teste conferida na agenda.
- Automações combinadas com a equipe Klyro.