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

  1. Na Cal.com, abra Settings > Developer > Webhooks e crie um novo webhook. Os nomes dos menus podem mudar em atualizações da Cal.com.
  2. No campo de URL do assinante, cole a URL do webhook entregue pela equipe Klyro.
  3. No campo de secret, cole o secret entregue pela equipe Klyro.
  4. Em versão do webhook, escolha 2021-10-20.
  5. Marque os três eventos: Booking created, Booking rescheduled e Booking cancelled.
  6. 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

  1. Reserve um horário no seu link da Cal.com com um e-mail que você controle.
  2. Aguarde até cerca de um minuto. A Klyro processa as reservas recebidas a cada minuto.
  3. Abra /crm/agenda no 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

ItemComo funciona
Não comparecimento (no-show)Não é recebido. A atividade não muda para “não compareceu”.
Criar ou mover negociaçõesNão é suportado nas automações.
Reagendamento feito pela API da Cal.com ou confirmação por link de e-mailPode não disparar o webhook. Não há reconciliação automática.
Envio de modelosNo 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 repetidasA 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.