# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-10-30T16:37:38.927Z ## Página - Título: Conectar uma agenda ao agente - URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-agenda - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Configure consulta, marcação, reagendamento, cancelamento e links com um único bloco Agenda conectada. ## Seções - Antes de começar - Conecte a capacidade - Escolha como apresentar os horários - Use o modo por link - Aproveite os dados já conhecidos - Entregue os links corretos - Continue uma etapa após uma ação - Teste o exemplo ## Conteúdo da página # Conectar uma agenda ao agente Use **Agenda conectada** para permitir que a IA consulte horários, marque, consulte reservas, reagende e cancele em uma agenda. O bloco reúne essas operações sem exigir um node para cada ação. ## Antes de começar - Tenha uma agenda configurada com disponibilidade, duração, participantes e regras de captura revisadas. - Para atender pelo chatbot externo, use uma agenda publicada. - Para entregar Google Meet, configure a videoconferência e a integração Google na própria agenda. - Defina o público do agente e o comportamento esperado quando a pessoa quiser agendar. As agendas públicas ficam em :ScreenEntry{href="https://my.agilize.app/public-experience/calendars" label="Configurar agendas públicas" path="Configurações > CRM > Experiências públicas > Agendas públicas"}. ## Conecte a capacidade 1. Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-builder" label="Configurar um agente avançado" path="Configurações > Configuração Básica > IA > Agentes Avançados > Construtor Agentes Avançados"} e abra o agente. 2. Abra o editor e adicione **Agenda conectada**. 3. Ligue o bloco a uma saída de capacidade opcional do **Agente**. 4. Em **Agenda**, escolha `Demonstração comercial · 30 minutos`, ou a agenda da sua operação. 5. Em **O que o agente pode fazer**, habilite apenas as ações desejadas. ![Agenda conectada com ações habilitadas, apresentação por opções e links de confirmação](/docs/screenshots/agentes-avancados/agenda-conectada.png) O editor mantém operações necessárias: reagendamento precisa consultar reservas e disponibilidade; cancelamento precisa identificar a reserva. Consultar horários não bloqueia nem reserva um horário. ## Escolha como apresentar os horários | Modo | Experiência da pessoa | Quando usar | | --- | --- | --- | | **Conversa natural** | Informa dia ou período, recebe horários e combina a escolha em texto. | Atendimento consultivo e preferências que variam durante a conversa. | | **Opções para escolher na conversa** | Escolhe entre horários estruturados, com navegação quando houver mais resultados. | Reduzir digitação e ambiguidade na escolha. | | **Link da agenda com retomada da conversa** | Abre a agenda, faz a reserva e o agente continua após a confirmação real. | Escolha visual em calendário ou jornada com formulário público. | ![Apresentação dos horários por conversa natural](/docs/screenshots/agentes-avancados/agenda-conversa-natural.png) No modo por opções, escolha **Botões rápidos · até 3** ou **Lista de opções · até 10**. No WhatsApp, são formatos distintos: até três botões de resposta e até dez itens em lista. A navegação pode ocupar uma opção. Outros canais adaptam a apresentação às suas capacidades; dez é o teto configurável, não uma promessa de dez botões em todo canal. A pessoa pode pedir outro dia ou período. O agente consulta a agenda para oferecer alternativas; não deve inventar disponibilidade. ## Use o modo por link ![Configuração do modo de link com retomada da conversa](/docs/screenshots/agentes-avancados/agenda-link.png) 1. Escolha **Link da agenda com retomada da conversa**. 2. Em **Personalizar dados e comportamento > Comportamento do link**, revise o prazo de espera e o período oferecido. 3. O prazo configurável vai de 1 a 150 minutos; o período, de 1 a 90 dias. 4. Teste uma reserva real, desistência e encerramento do prazo. Abrir o link ou escrever “já agendei” não comprova a reserva. A retomada depende do resultado recebido pela plataforma. No modo de conversa ou opções, você também pode habilitar **Permitir enviar o link da agenda também**. ## Aproveite os dados já conhecidos O bloco aproveita informações disponíveis e pergunta o que faltar. Em **Dados do participante**, use o seletor para associar nome, e-mail e telefone recebidos do bot ou de uma coleta. Para atendimento externo, o vínculo e a consulta de reservas respeitam a conversa de origem. No uso interno, configure se o vínculo com oportunidade, contato ou empresa virá do contexto ou da conversa e de consultas autorizadas ao CRM. ## Entregue os links corretos Em **Links na confirmação**, escolha: - **Link público do agendamento**: permite acessar o agendamento já realizado. - **Google Meet**: entrega a videoconferência quando ela estiver disponível. O link para escolher um horário e o link público de uma reserva têm finalidades diferentes. Habilitar o link público na confirmação não substitui a escolha do modo de apresentação. **O Google Meet pode chegar depois da confirmação da reserva.** Nesse caso, a reserva continua válida, e a plataforma acompanha o retorno da integração para entregar o link disponível. Não configure uma nova marcação apenas para obter o Meet. Uma integração ausente ou com falha não deve ser apresentada como reunião pronta para videoconferência. ## Continue uma etapa após uma ação Em **Próximas etapas no fluxo**, adicione uma saída somente quando precisar executar outra etapa após uma operação. Por exemplo, após **Agendar**, atualize a oportunidade e siga para **Retornar ao bot** com a chave `agendado`. --- title: "Agendamento com retorno ao bot" caption: "O agente usa a agenda conforme a conversa. Depois do agendamento confirmado, uma sequência pode executar ações e retornar." definition: | flowchart LR A[Agente] --> B[Agenda conectada] B -->|Após agendar| C[Alterar entidade] C --> D[Retornar ao bot: agendado] D --> E[Saída Agendado no fluxo do bot] --- Sem uma saída posterior configurada, a IA pode continuar a conversa normalmente. **Agenda conectada** é uma capacidade opcional; para uma operação obrigatória em uma sequência, use [Agenda · operação específica](/docs/configuracao/referencias/nodes-agentes-avancados/agenda-operacao-especifica). ## Teste o exemplo Envie `Quero conhecer a solução`, faça uma dúvida e só depois peça `Podemos conversar amanhã à tarde?`. Confira: 1. Resposta à dúvida antes de forçar agendamento. 2. Horários compatíveis com disponibilidade, duração e fuso. 3. Solicitação apenas dos dados obrigatórios ausentes. 4. Confirmação de reserva real após escolher um horário. 5. Entrega dos links habilitados, incluindo o caso de Meet ainda em preparação. 6. Consulta, reagendamento e cancelamento da reserva dessa conversa. 7. Continuação por `agendado`, quando ela estiver desenhada. Veja também [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente) e [Agenda conectada: referência do node](/docs/configuracao/referencias/nodes-agentes-avancados/agenda-conectada).