> ## Documentation Index > Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt > Use this file to discover all available pages before exploring further. # Bloco Agendamento > Agende compromissos automaticamente no Google Calendar durante a conversa ## O que é o Bloco Agendamento? O bloco **Agendamento** permite que o agente de IA agende compromissos diretamente no Google Calendar durante a conversa com o lead — seja pelo WhatsApp, Instagram ou WebChat. O lead escolhe um horário disponível, confirma, e o evento é criado automaticamente no calendário conectado. ### Por que usar? | Benefício | Descrição | | --------------------------------- | ---------------------------------------------------------- | | **Agendamento automático** | O lead agenda sem precisar de atendente humano | | **Disponibilidade em tempo real** | A IA consulta o calendário e mostra apenas horários livres | | **Google Meet incluso** | Crie reuniões online automaticamente junto com o evento | | **Confirmação obrigatória** | O agente sempre pede confirmação antes de criar o evento | O bloco Agendamento se conecta ao Google Calendar de forma simples e segura, direto na interface do Flow Builder. *** ## Como conectar o Google Calendar No canvas do Flow Builder, adicione um bloco **Agendamento** ao seu fluxo. No painel de configuração do bloco, clique no botão **"Conectar Google Calendar"**. Uma janela popup abre para você fazer login na sua conta Google e autorizar o acesso ao calendário. Aceite as permissões solicitadas. Após autorizar, o calendário fica conectado. O agente já pode verificar disponibilidade e criar eventos automaticamente. **Você pode ver uma tela com aviso "O Google não verificou este app" — isso é esperado.** Enquanto estamos finalizando a verificação oficial do app junto ao Google, a tela aparece normalmente. Para prosseguir: 1. Clique em **Avançado** (canto inferior esquerdo da tela) 2. Clique em **"Ir para maketalk.ai (não seguro)"** 3. Autorize os escopos pedidos O aviso não significa que o app é inseguro — apenas que ainda não completamos o processo formal de verificação do Google, que não afeta a segurança da conexão. Todos os tokens são armazenados cifrados e a conexão usa padrão OAuth 2.0. Conecte o calendário do profissional que vai atender (por exemplo, o calendário do dentista, do consultor ou do vendedor). Assim a disponibilidade mostrada ao lead será a real. *** ## Configurações disponíveis ### Identificação | Campo | Descrição | Exemplo | | -------------------- | -------------------------------------- | ------------------------------------------------------------- | | **Nome de exibição** | Nome amigável mostrado no Flow Builder | "Agendamento Consulta" | | **Descrição** | Quando o agente deve usar este bloco | "Use quando o cliente quiser agendar uma consulta ou reunião" | A descrição é fundamental para que a IA saiba quando oferecer o agendamento. Seja específico sobre quais situações devem acionar este bloco. ### Regras de horário | Campo | Descrição | Faixa | | ------------------------- | ------------------------------------------ | ---------------- | | **Duração da consulta** | Quanto tempo dura cada compromisso | 15 a 480 minutos | | **Intervalo entre slots** | Espaço entre um horário e outro | 5 a 120 minutos | | **Buffer antes** | Tempo livre antes do compromisso | 0 a 60 minutos | | **Buffer depois** | Tempo livre após o compromisso | 0 a 60 minutos | | **Dias à frente** | Quantos dias no futuro a IA busca horários | 1 a 30 dias | Use buffers para dar tempo ao profissional entre compromissos. Por exemplo, um buffer de 10 minutos antes e depois de cada consulta evita que os atendimentos fiquem "colados". ### Horário comercial Configure os dias da semana em que o agendamento está disponível, com horário de início e fim para cada dia: | Campo | Descrição | | --------------------- | -------------------------------------------------------- | | **Dias habilitados** | Quais dias da semana estão abertos para agendamento | | **Horário de início** | Hora em que começam os horários disponíveis (ex: 08:00) | | **Horário de fim** | Hora em que terminam os horários disponíveis (ex: 18:00) | ### Evento no calendário | Campo | Descrição | | -------------------------- | --------------------------------------------------------------------- | | **Título do evento** | Nome do evento criado no Google Calendar. Suporta variáveis | | **Descrição do evento** | Detalhes do evento. Suporta variáveis | | **Google Meet automático** | Liga/desliga a criação automática de link do Google Meet | | **Lembrete** | Tempo antes do compromisso para enviar notificação (0 a 1440 minutos) | ### Variáveis disponíveis Nos campos de título e descrição do evento, você pode usar variáveis que são preenchidas automaticamente com os dados do lead: | Variável | O que insere | | ------------- | ------------------------------------- | | `{{nome}}` | Nome do lead | | `{{email}}` | Email do lead | | `{{assunto}}` | Assunto ou motivo informado pelo lead | **Exemplo de título:** ``` Consulta - {{nome}} - {{assunto}} ``` **Resultado no Google Calendar:** ``` Consulta - Maria Silva - Avaliação ortodôntica ``` *** ## Como funciona a conversa Durante o atendimento, o agente segue um fluxo natural e seguro: ``` Lead pede para agendar | IA verifica horários disponíveis no Google Calendar | Apresenta opções de forma conversacional | Lead escolhe um horário | IA pede confirmação explícita | "Confirmo!" | Evento criado no Google Calendar | IA confirma o agendamento ao lead ``` O agente **nunca** agenda sem confirmação explícita do lead. Mesmo que o lead diga "quero às 14h", a IA vai confirmar: "Posso agendar para amanhã às 14h?" e só cria o evento após o lead confirmar. *** ## Encadeamento com outros blocos Uma das funcionalidades mais úteis do bloco Agendamento é o **encadeamento com outros blocos** do fluxo. ### Como funciona Você pode conectar um bloco de **Coleta de Dados** ou **Qualificação de Lead** antes do bloco Agendamento no canvas. Quando faz isso: 1. O sistema garante que o agente **primeiro completa** a coleta ou qualificação 2. Só depois de ter todos os dados, o agente inicia o processo de agendamento 3. Os dados coletados (nome, email, assunto) são usados automaticamente nas variáveis do evento ``` [Coleta de Dados] -----> [Agendamento] nome, email, usa {{nome}}, {{email}}, assunto {{assunto}} no evento ``` Essa ordem é garantida pelo sistema, não apenas pelo prompt. O agente não pode pular a etapa de coleta e ir direto para o agendamento quando os blocos estão encadeados. ### Por que encadear? | Sem encadeamento | Com encadeamento | | --------------------------------------------------- | ----------------------------------------------- | | Agente pode tentar agendar sem ter os dados do lead | Dados são coletados antes, de forma estruturada | | Título do evento fica genérico | Título usa nome, email e assunto do lead | | Sem garantia de ordem | Ordem garantida pelo sistema | *** ## Exemplo prático: clínica ou consultório Imagine uma clínica odontológica que usa o MakeTalk para agendar consultas pelo WhatsApp. ### Fluxo configurado ``` [Roteador] | |-- "Quer agendar consulta" --> [Coleta de Dados] --> [Agendamento] | |-- "Dúvidas sobre tratamentos" --> [Base de Conhecimento] | |-- Outros --> IA responde normalmente ``` ### Configuração do Bloco Coleta de Dados | Campo | Tipo | Obrigatório | | ------------------ | ----- | ----------- | | Nome completo | Texto | Sim | | Email | Email | Sim | | Motivo da consulta | Texto | Sim | ### Configuração do Bloco Agendamento | Campo | Valor | | ------------------- | ------------------------------------------------------------- | | Duração | 30 minutos | | Intervalo | 15 minutos | | Buffer antes | 10 minutos | | Dias à frente | 14 dias | | Horário comercial | Seg-Sex, 08:00-18:00 | | Título do evento | `Consulta - {{nome}} - {{assunto}}` | | Descrição do evento | `Paciente: {{nome}} / Email: {{email}} / Motivo: {{assunto}}` | | Google Meet | Desligado | | Lembrete | 60 minutos antes | ### Como a conversa acontece ``` Lead: Oi, quero marcar uma consulta IA: Claro! Antes de verificar os horários disponíveis, preciso de algumas informações. Qual o seu nome completo? Lead: Maria Silva IA: Obrigado, Maria! Qual o seu email para contato? Lead: maria@email.com IA: E qual o motivo da consulta? Lead: Avaliação ortodôntica IA: Perfeito! Deixa eu ver os horários disponíveis... Temos as seguintes opções: - Terça, 15/04, às 09:00 - Terça, 15/04, às 14:00 - Quarta, 16/04, às 10:30 Qual horário você prefere? Lead: Terça às 14h IA: Ótimo! Posso confirmar sua consulta para terça-feira, 15/04, às 14:00? Lead: Sim, confirmo! IA: Pronto! Sua consulta de avaliação ortodôntica está agendada para terça-feira, 15/04, às 14:00. Você receberá um lembrete 1 hora antes. Até lá! ``` *** ## Perguntas Frequentes Cada bloco Agendamento conecta a um calendário Google. Se você precisa de agendamento em calendários diferentes (por exemplo, um para cada profissional), crie um bloco Agendamento para cada um e use o Roteador para direcionar. O agente informa ao lead que não há horários disponíveis no período configurado e pode sugerir que ele entre em contato novamente em outro momento ou que um atendente humano ajude a encontrar uma alternativa. Se o email do lead for coletado (via Coleta de Dados ou Qualificação), ele pode receber o convite automaticamente no email, dependendo das configurações do Google Calendar conectado. Uma conta Google pessoal (Gmail) funciona. Porém, para uso profissional, recomendamos o Google Workspace, que oferece mais controle sobre calendários compartilhados. Sim. O bloco Agendamento funciona de forma independente. Porém, sem a Coleta de Dados antes, as variáveis como `{{nome}}` e `{{email}}` não serão preenchidas automaticamente no título do evento. *** ## Próximos passos Capture dados do lead antes de agendar. Avalie o potencial do lead antes do agendamento. Aprenda a montar fluxos completos no canvas. Conecte seu fluxo a uma caixa de entrada.