> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Google Calendar > Como conectar o Google Calendar a um agente do ChatNorris para que ele consulte a sua disponibilidade real, ofereça horários e crie o compromisso no seu calendário com convite para o visitante, e como configurar horários, serviços, feriados e o evento. # Google Calendar Com a integração do Google Calendar, o seu agente do ChatNorris agenda compromissos no seu calendário sem sair do chat. Diferentemente do Cal.com e do Calendly, aqui não há uma página de reservas externa: o ChatNorris calcula os horários livres com as regras que você define e cria o evento diretamente no seu calendário. O agente: * consulta a disponibilidade real do seu calendário principal; * oferece ao visitante horários livres, sempre com o fuso horário; * pede o nome e o email (e, se você quiser, o telefone) e espera um **sim explícito**; * cria o compromisso no seu calendário, e o Google envia o convite ao visitante, com link do Google Meet se você ativar essa opção. Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram e Email. ## Requisitos * Uma conta do ChatNorris com plano **Standard** ou **Premium** (não está no Free). Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tiver um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma conta do Google com o calendário onde você quer receber os compromissos. É usado o **calendário principal** dela. * Função **Owner** ou **Admin** na sua organização do ChatNorris. ## Conectar o Google Calendar Cada agente se conecta a uma conta do Google. **1. Abra o hub de Integrações do agente** No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **Google Calendar**. **2. Clique em Conectar com Google** O Google é aberto. Faça login com a sua conta do Google. **3. Aceite as duas permissões** O Google pede duas permissões do Calendar: ver os seus horários ocupados e criar eventos. Deixe as duas marcadas: se você desmarcar alguma, a conexão não é salva. **4. Volte ao ChatNorris** A ficha da integração mostra a conta conectada e o fuso horário do calendário. Com **Testar conexão**, você verifica o acesso quando quiser. Continue em [Configurar a Ação](#configurar-a-ação). > [!NOTE] > > O ChatNorris só vê os horários ocupados do seu calendário principal, sem títulos nem detalhes, e cria apenas os compromissos que o visitante confirma. ## Configurar a Ação Conectar a conta ainda não ativa nada. Só pode haver uma Ação do Google Calendar por agente. **1. Crie a Ação e defina quando usá-la** Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Google Calendar**. Em **Quando usar**, descreva quando o agente deve oferecer horários (por exemplo, "quando quiserem agendar uma avaliação"). As regras de segurança (não inventar horários, não confirmar por conta própria) se aplicam sempre, mesmo que você edite o texto; você pode voltar ao texto original com **Restaurar texto padrão**. **2. Configure os horários** Na seção **Horários**, você define quando os compromissos podem ser agendados. O ChatNorris cruza esse horário com o que já está ocupado no seu calendário. **3. Confira a prévia e habilite a ação** Em **Prévia**, clique em **Ver próximos horários** para ver os horários que o agente ofereceria agora com a configuração atual (mesmo que você ainda não a tenha salvado). Para habilitar a ação, você precisa da conta conectada e de pelo menos um dia com horário. > [!WARNING] > > **Recomendamos Claude Sonnet ou superior** como modelo principal do agente (`Configurações → IA`). O agente deve oferecer apenas os horários reais fornecidos pelo sistema; os modelos menores às vezes inventam horários ou dão um compromisso como agendado quando o visitante só parece estar de acordo. ### Opções de horário | Opção | O que faz | | - | - | | **Fuso horário** | Por padrão, **o do calendário** conectado. Você pode escolher outro. | | **Horário por dia** (segunda a domingo) | Para cada dia, **de** e **até**, ou **Sem compromissos**. Por padrão: segunda a sexta, das 09:00 às 18:00. | | **Duração do compromisso** | Quanto dura cada compromisso (por padrão, 30 min). Fica oculta se você adicionar serviços. | | **Intervalo entre compromissos** | Tempo livre antes e depois de cada compromisso e dos seus outros eventos (0 a 60 min). | | **Antecedência mínima** | Com quanta antecedência é possível agendar (de **Sem antecedência** até 48 h; por padrão, 2 h). | | **Dias à frente** | Até quantos dias a partir de hoje é possível agendar (1 a 60; por padrão, 14). | | **Horários a cada** | De quanto em quanto tempo começa um horário possível: 15, 30 ou 60 min (09:00, 09:30…). | | **Horários oferecidos** | Quantos horários o agente mostra de uma vez (3 a 8), distribuídos entre os dias. | | **Pedir telefone** | Além do nome e do email (que são sempre pedidos, porque é para lá que vai o convite), o agente pede um telefone de contato. Fica na seção **Dados do visitante**. | ### Serviços com duração diferente A seção **Serviços** é opcional. Se você oferece compromissos com duração diferente (por exemplo, uma massagem de 30 e outra de 60 minutos), adicione cada serviço com a sua duração (até 20 serviços): * **Sem serviços**: todos os compromissos duram o que estiver indicado em **Duração do compromisso**. * **Com um único serviço**: todos os compromissos usam a duração dele, e o agente não pergunta qual o visitante quer. * **Com dois ou mais serviços**: o agente pergunta ao visitante qual serviço ele quer e procura horários com essa duração. ### Feriados e dias fechados * **Não oferecer horários em feriados** (ativado por padrão): os feriados públicos do **País** são omitidos; por padrão, o país é deduzido do fuso horário. Você pode escolher outro país e uma **Região** (ou **Todo o país**). A seção mostra os **Próximos feriados**. * **Dias fechados**: dias específicos em que você não atende (férias, inventário ou um feriado novo que ainda não aparece na lista). Até 100 dias. Se o visitante pedir um dia fechado ou feriado, o agente avisa que não há atendimento nesse dia e oferece a data mais próxima. ### O evento no seu calendário Na seção **Evento**, você define como o compromisso é criado: * **Título do evento**: por padrão, "Cita con \{\{name}}". Variáveis: `{{name}}` (visitante), `{{email}}`, `{{service}}` (serviço escolhido) e `{{agent}}` (nome do agente). * **Adicionar link do Google Meet**: o convite inclui uma videochamada do Meet. * **Mensagem ao confirmar (opcional)**: o agente a adiciona quando o compromisso fica agendado; por exemplo, como chegar ou o que levar. O compromisso é criado no calendário principal da conta conectada **só depois que o visitante confirma**, e o Google envia o convite para o email dele. ### Como o visitante agenda 1. Quando a conversa corresponde ao **Quando usar**, o agente consulta a sua disponibilidade real e oferece horários livres (sempre indicando o fuso horário). 2. O agente pede o nome e o email (e o telefone, se você ativou essa opção), mostra um resumo e espera um **sim explícito** do visitante. Veja quais respostas contam como confirmação em [Confirmações do visitante](https://docs.chatnorris.ai/pt/guias/acciones.md#confirmações-do-visitante). 3. Antes de criar o compromisso, o ChatNorris verifica de novo se o horário continua livre. Se alguém o ocupou nesse meio-tempo, o agente oferece novos horários. No **widget web**, em vez de uma lista em texto, o visitante vê um **seletor de dia e hora**: escolhe um dia e um horário, preenche seus dados (pré-preenchidos se ele já os deixou na conversa) e clica em **Confirmar compromisso**; esse botão é a confirmação. No **WhatsApp, Instagram, Telegram, Messenger e Email**, o agente oferece os horários como uma lista em texto, e o visitante confirma por escrito. > [!NOTE] > > No **Playground** você pode testar todo o fluxo, mas **nunca é criado um compromisso real** no seu calendário. ### Compromissos em Leads Os dados que o visitante informa no seletor do widget são salvos como contato dele: o **lead** é criado ou atualizado, como acontece com um Lead Form. Os compromissos agendados pelo agente aparecem em [Leads](https://docs.chatnorris.ai/pt/guias/leads.md), na coluna **Agendamento** e na seção **Agendamentos** do detalhe do lead, e você pode filtrar os leads **Com agendamento próximo**. Se você excluir o evento no Google Calendar, o compromisso aparece como cancelado ao abrir o lead. Se o agente também tiver a Ação [Pipedrive](https://docs.chatnorris.ai/pt/guias/pipedrive.md) com **Registrar reuniões agendadas**, cada compromisso também é registrado no Lead do Pipedrive como atividade **Reunião**. ### Várias ações de agenda no mesmo agente O Google Calendar compartilha o classificador de agenda com o [Cal.com](https://docs.chatnorris.ai/pt/guias/cal-com.md) e o [Calendly](https://docs.chatnorris.ai/pt/guias/calendly.md): se um agente tiver mais de uma ação de agenda, é oferecida **apenas uma por resposta**, a que melhor corresponde ao que o visitante pediu. Diferencie bem os **Quando usar** de cada uma para que ele acerte; o formulário avisa se o agente tiver várias. Com uma ação de agenda pronta, pedir uma reunião ou uma ligação não é um handoff, mesmo que o visitante mencione um executivo ou consultor: o agente oferece horários. Veja [Human Handoff](https://docs.chatnorris.ai/pt/guias/acciones.md#human-handoff). ## Desconectar Em `Agentes → [seu agente] → Integrações → Google Calendar`, clique em **Desconectar**. Desconectar revoga o acesso no Google e desliga a Ação, sem apagar a configuração dela. Se o Google revogar o acesso ou se você desconectar a conta, o agente deixa de oferecer horários e informa ao visitante que a agenda não está disponível. Conecte a conta novamente em Integrações para retomá-la. ## Perguntas frequentes > [accordion] Ao conectar, aparece "Faltam permissões" («Faltan permisos») > > Na tela do Google, você deixou desmarcada alguma das duas permissões do Calendar. Conecte novamente e deixe as duas marcadas. > [accordion] Ao conectar, aparece "O Google não forneceu um acesso permanente" («Google no entregó un acceso permanente») > > Remova o ChatNorris em [myaccount.google.com/permissions](https://myaccount.google.com/permissions) e conecte novamente. > [accordion] O ChatNorris vê os títulos e detalhes dos meus eventos? > > Não. Ele só vê os horários ocupados do seu calendário principal, sem títulos nem detalhes, e cria apenas os compromissos que o visitante confirma. > [accordion] Posso ter duas Ações do Google Calendar no mesmo agente? > > Não. Só pode haver uma por agente. Se você precisar de agendas diferentes, use agentes separados ou combine o Google Calendar com o [Cal.com](https://docs.chatnorris.ai/pt/guias/cal-com.md) ou o [Calendly](https://docs.chatnorris.ai/pt/guias/calendly.md), com um **Quando usar** diferente para cada uma. > [accordion] São criados compromissos reais quando eu testo no Playground? > > Não. No Playground você pode testar todo o fluxo, mas nunca é criado um compromisso real no seu calendário. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.