Como conectar sua agenda (Cal.com) para agendamento pela IA
Conecte sua chave de API do Cal.com em Configurações → Geral → Integrações e escolha um tipo de evento para a IA agendar direto na conversa.
O HomeChat não se conecta diretamente à sua conta do Google (ou de outro provedor de calendário) — a ponte é o Cal.com. Você conecta uma chave de API do Cal.com à sua organização, e é o Cal.com quem, do lado dele, sincroniza com o Google Agenda ou o calendário que você já usa.
O que você precisa antes de começar
- Uma conta no Cal.com com uma chave de API (API key) gerada — em cal.com, o caminho é Settings → Developer → API Keys.
- Um tipo de evento (event type) já criado no Cal.com, com a duração e as regras do compromisso que você quer que a IA use.
- O Cal.com já configurado, do lado dele, para sincronizar com o Google Agenda ou o calendário da sua empresa.
Passo a passo
- 1Abra Configurações → Geral
No menu do HomeChat, acesse Configurações → Geral e clique na aba "Integrações".
- 2Cole sua chave de API do Cal.com
Na seção "Agenda (Cal.com)", cole a chave de API gerada no Cal.com no campo indicado (o texto de exemplo no campo é algo como "cal_live_..."). A chave só é salva quando você clica em "Salvar alterações" no topo da página.
- 3Escolha o tipo de evento
Depois de salvar a chave, a seção passa a mostrar um status "Conectado" e libera o campo "Tipo de evento usado pra agendar". Clique em "Buscar tipos de evento" para o HomeChat consultar os tipos de evento cadastrados na sua conta do Cal.com, e escolha o que a IA deve usar na lista que aparece.
- 4Confira o fuso horário
O fuso horário usado nos agendamentos é o mesmo configurado na aba "Operação" da mesma tela (seção de horário de expediente) — confirme se está correto antes de liberar o agendamento pela IA.
Sem uma chave de API conectada e um tipo de evento escolhido, tanto a IA quanto a equipe recebem um aviso pedindo para completar essa configuração em Configurações → Geral antes de tentar consultar horários ou marcar um compromisso.
Para desconectar
Na mesma seção "Agenda (Cal.com)", com a conexão ativa, existe um link "Desconectar" ao lado da prévia da chave atual.
Dúvidas comuns sobre esse passo a passo.
A IA cria o compromisso no Cal.com, que é a ferramenta conectada à sua organização. O compromisso aparece no Google Agenda quando o Cal.com está configurado para sincronizar com ele — é uma ligação em duas etapas, não uma conexão direta do HomeChat com sua conta do Google.
Os dois são necessários. Sem um tipo de evento escolhido, o HomeChat não sabe qual duração e quais regras usar ao consultar disponibilidade e criar o compromisso, mesmo com a chave de API conectada.
Na aba "Operação" de Configurações → Geral, na seção de horário de expediente. Esse mesmo fuso horário é usado pela IA ao consultar e criar compromissos no Cal.com.
Outras páginas que podem ajudar.
Fale com a gente que a resposta sai rápido.
Se esse artigo não resolveu, é só chamar — respondemos por e-mail ou WhatsApp.