Como funciona a agenda da IA (agenda própria ou Cal.com)

O agendamento pela IA funciona de dois jeitos. Por padrão, a IA usa a agenda própria do HomeChat: consulta os horários livres, marca o compromisso e agenda um lembrete pelo WhatsApp uma hora antes, sem nenhuma conta extra. Se a sua empresa já usa o Cal.com — ou quer os compromissos no Google Agenda —, dá para conectar o Cal.com, e a IA passa a consultar e marcar lá.

Usando a agenda própria do HomeChat

1
Configure o horário de funcionamento
Em Configurações → Geral, na aba "Operação", ajuste os dias e horários de expediente e o fuso horário. A IA só oferece horários livres dentro desse expediente.
2
Oriente a IA a agendar
No prompt do seu agente de IA, diga quando ele deve oferecer um horário (por exemplo, depois de qualificar o cliente). Ele consulta a agenda antes de propor e só oferece o que está livre de verdade.
3
Acompanhe pelo menu Agenda
Os compromissos marcados pela IA aparecem no menu Agenda do HomeChat, junto com os que a equipe marca na mão.

Opcional: conectando o Cal.com

O HomeChat não se conecta direto à sua conta do Google — a ponte é o Cal.com. Com ele conectado, a IA consulta a disponibilidade e cria os compromissos no Cal.com, que sincroniza com o Google Agenda (ou outro calendário que você use). Os compromissos também continuam aparecendo no menu Agenda do HomeChat.

Antes de começar, você precisa de:

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.

1
Abra Configurações → Geral
No menu do HomeChat, acesse Configurações → Geral e clique na aba "Integrações".
2
Cole 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.
3
Escolha o tipo de evento
Depois de salvar a chave, a seção mostra o status "Conectado" e libera o campo "Tipo de evento usado pra agendar". Clique em "Buscar tipos de evento" e escolha, na lista, o que a IA deve usar.

Com a chave e o tipo de evento salvos, a IA já passa a agendar pelo Cal.com. Como o Cal.com exige o e-mail do participante, nesse modo a IA pede o e-mail do cliente antes de confirmar o horário.

Para voltar à agenda própria

Na seção "Agenda (Cal.com)", com a conexão ativa, use o link "Desconectar" ao lado da prévia da chave. A partir daí, a IA volta a agendar na agenda própria do HomeChat.

Perguntas frequentes

Dúvidas comuns sobre esse passo a passo.

Preciso do Cal.com para a IA agendar?

Não. Sem o Cal.com, a IA agenda na agenda própria do HomeChat. O Cal.com é opcional, para quem quer os compromissos no Google Agenda ou já usa o Cal.com.

A IA agenda direto no Google Agenda?

Pelo Cal.com, sim: a IA cria o compromisso no Cal.com, que sincroniza com o Google Agenda. Não há conexão direta do HomeChat com a sua conta do Google.

Preciso escolher um tipo de evento, ou só a chave de API já basta?

Os dois são necessários. Sem um tipo de evento escolhido, a IA continua usando a agenda própria do HomeChat, porque não sabe qual duração e quais regras usar no Cal.com.

Onde eu ajusto o fuso horário usado nos agendamentos?

Na aba "Operação" de Configurações → Geral, na seção de horário de expediente. Esse fuso vale para a agenda própria e para o Cal.com.

Continue por aqui

Outras páginas que podem ajudar.

Agenda da IA: própria do HomeChat ou Cal.com/integracoes/google-agenda Como configurar seu agente de IA/ajuda/configurar-agente-ia Fale com a gente/contato

Ainda com dúvida?

Fale com a gente que a resposta sai rápido.

Se esse artigo não resolveu, é só chamar — respondemos por e-mail ou WhatsApp.

Fale com a gente Voltar para a Central de Ajuda →