Este guia é para quem usa uma página de agendamento (Calendly ou Cal.com) e quer que a reunião marcada pelo cliente apareça no Hub sozinha: como atividade na linha do tempo do contato e como negócio no funil.
O problema que isto resolve
Você manda a sua página de agendamento para um possível cliente. Ele escolhe um horário. A reunião entra na sua agenda. E o Hub não fica sabendo de nada: não há cartão no funil, não há atividade, e a linha do tempo daquele contato para no e-mail que ele abriu.
Na prática, o momento mais importante da prospecção, alguém levantou a mão, era justamente o que não ficava registrado. Quem revisse o funil na semana seguinte não veria aquela oportunidade em lugar nenhum.
O que passa a acontecer
Depois de ligar a conexão, sempre que alguém marcar uma conversa:
-
o Hub procura o contato pelo e-mail que a pessoa usou. Se não existir, cria (isso é opcional);
-
grava uma atividade de reunião com o horário marcado, o e-mail, o link para remarcar e as respostas do formulário do seu Calendly. Se você pergunta "qual o tamanho da sua equipe?" na hora de marcar, a resposta chega junto: é qualificação de graça;
-
abre o negócio no funil, na etapa que você escolher (isso também é opcional).
Se a pessoa cancelar, o Hub grava a atividade de cancelamento, com o motivo se ela tiver escrito um. O negócio não é mexido: cancelar uma reunião não é perder a venda, e quem decide o que fazer com o cartão é quem vende.
Como ligar
Você faz isto uma vez. Precisa ser administrador da organização.
-
No Hub, vá em Agenda e depois em Ajustes. Procure o bloco Agendamento que vira card.
-
Escolha onde está a sua página: Calendly ou Cal.com.
-
Escolha a etapa do funil onde o negócio deve nascer. Se não escolher, ele entra na primeira etapa do seu funil principal.
-
Clique em Salvar conexão. A tela passa a mostrar um endereço (uma URL longa). Copie-o no botão Copiar.
-
No seu provedor, crie um webhook apontando para esse endereço, com os eventos de agendamento criado e agendamento cancelado. No Cal.com isso se faz pela tela, em Settings > Developer > Webhooks, e a chave de assinatura você mesmo inventa. No Calendly não existe tela para isso: a inscrição só se cria por chamada de API, e a chave vai no próprio pedido.
-
Volte ao Hub, cole essa chave no campo Chave de assinatura do provedor e salve outra vez.
A chave tem de ser exatamente a mesma nos dois lados. Ela é uma senha longa e aleatória, de 30 caracteres ou mais, que serve só para isto. Se os dois lados não tiverem o mesmo valor, o Hub recusa todos os avisos e nada é gravado.
Webhook do Calendly exige plano pago
Medido em 11/08/2026 com uma conta real: no plano gratuito do Calendly, a API deixa listar webhooks mas recusa criar, com a mensagem "Please upgrade your Calendly account to Standard". Ou seja, para usar esta integração com o Calendly é preciso estar no plano Standard ou superior.
O Cal.com permite webhook no plano gratuito e ainda deixa criar pela tela, sem programação. Se você ainda está escolhendo a ferramenta de agendamento, isso pesa.
Por que a chave é obrigatória
O endereço que você copiou é público: qualquer computador na internet consegue bater nele. A chave é o que prova que o aviso de agendamento veio mesmo do seu provedor. Sem chave válida, o Hub recusa o aviso e não grava nada, que é exatamente o que você quer, porque senão bastaria alguém descobrir o endereço para criar contatos e negócios dentro da sua conta.
A chave fica guardada cifrada e nunca mais aparece na tela, nem para você. Se precisar trocar, basta colar a nova por cima; deixar o campo em branco mantém a que já existe.
As três chaves de ajuste
-
Criar o negócio no funil. Desligue se quiser apenas o registro na linha do tempo, sem cartão. Útil para quem usa a agenda também para reuniões que não são venda.
-
Criar o contato se ele não existir. Ligada, quem marca uma conversa e ainda não está na sua base entra como contato novo, com origem "agendamento". Desligada, um e-mail desconhecido é ignorado.
-
Conexão ativa. Desligada, os agendamentos continuam acontecendo no provedor, mas o Hub deixa de registrá-los. Serve para pausar sem apagar a configuração.
Detalhes que evitam confusão
Uma pessoa que remarca duas vezes não vira três cartões. Se o contato já tem um negócio aberto, o Hub liga a nova atividade a esse negócio em vez de criar outro. O funil serve para acompanhar uma negociação, não para contar quantas vezes a pessoa mexeu na agenda.
O mesmo agendamento avisado duas vezes não duplica nada. Provedores de webhook reenviam o mesmo aviso quando ficam em dúvida se você recebeu. O Hub reconhece o repetido e ignora.
O e-mail é o que liga as duas pontas. Se a pessoa marcar com um endereço pessoal diferente do que está no seu Hub, o sistema não tem como saber que é a mesma pessoa: vai criar um contato novo. Depois é possível juntar os dois à mão.
Isto não substitui a conexão com o Google Agenda. São coisas diferentes: o Google Agenda serve para a IA marcar reuniões na sua agenda; esta conexão serve para trazer para dentro do Hub as reuniões que o próprio cliente marcou. Pode ter as duas.
Conferir se está funcionando
No mesmo bloco, abaixo do endereço, a tela mostra quando chegou o último agendamento. Se nunca chegou nenhum, diz isso. Se houve alguma falha, ela aparece escrita ali.
Para testar, marque uma conversa com você mesmo na sua página de agendamento, usando um e-mail que exista no seu Hub. Em segundos deve aparecer a atividade na linha do tempo daquele contato e o cartão no funil.
Se nada aparecer, confira nesta ordem: a conexão está ativa; o endereço colado no provedor é o mesmo que a tela mostra; a chave foi colada depois de o webhook ser criado; e o provedor está enviando os eventos de agendamento criado.