> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agendamento Inteligente

> Como a Mia agenda visitas e reuniões — com validação de horários ou integração ao Google Agenda do atendente.

A Mia pode agendar visitas e reuniões durante a conversa. Dependendo de como a operação está configurada, o agendamento segue um de dois caminhos:

| Caminho                        | O que acontece                                                                                                                                 | Quando usa                                                                       |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Agendamento convencional**   | A Mia valida data/hora contra os horários de agendamento do empreendimento ou da Mia, registra o compromisso na Morada e encaminha para a fila | Padrão quando não há fila no modo **Agendamento de Visita** vinculada à Mia      |
| **Agendamento com calendário** | A Mia consulta disponibilidade real (Google Agenda + regras da fila), propõe horários livres e cria o evento no calendário do atendente        | Quando existe fila configurada no modo **Agendamento de Visita** vinculada à Mia |

<Tip>
  Disponível para a **Mia** (pré-venda) — visita ao stand, apartamento decorado, reuniões online de apresentação de empreendimento.
</Tip>

## O que a Mia consegue fazer

Com a ferramenta de agendamento ativa, a Mia pode:

* **Criar** um novo agendamento (visita ou reunião)
* **Alterar** data/hora de um agendamento existente
* **Cancelar** um agendamento ativo
* **Listar** agendamentos em aberto do lead
* **Buscar horários disponíveis** — apenas no modo com calendário (filas de Agendamento de Visita)

## Agendamento convencional

É o fluxo padrão quando a conversa **não resolve** uma fila de Agendamento de Visita.

<Steps>
  <Step title="Lead informa data e hora">
    A Mia identifica a intenção ("posso visitar sábado?", "tem horário amanhã?") e pede ou confirma data e hora.
  </Step>

  <Step title="Validação de horários">
    A Mia valida o horário contra os **horários de agendamento** configurados no empreendimento ou na Mia, respeitando os dias e horários permitidos. A antecedência mínima nesse modo é definida pelo time técnico (em **horas úteis**) — diferente do campo **Antecedência mínima (minutos)** da fila de Agendamento de Visita, usado apenas no modo com calendário.
  </Step>

  <Step title="Registro na Morada">
    O compromisso é registrado na plataforma, o negócio é atualizado e o ticket é encaminhado para a **fila de distribuição de agendamentos** — que **não precisa** ser uma fila no modo Agendamento de Visita. **Sem criar evento no Google Agenda.**
  </Step>

  <Step title="Confirmação ao lead">
    A Mia confirma data e hora ao lead. Se o empreendimento tiver endereço de stand, pode informá-lo.
  </Step>
</Steps>

## Agendamento com calendário (Beta)

Quando a Mia está vinculada a uma fila no modo **Agendamento de Visita**, consulta a disponibilidade real antes de confirmar.

<Steps>
  <Step title="Detecção de intenção">
    A Mia identifica que o lead quer agendar.
  </Step>

  <Step title="Consulta de disponibilidade">
    A Mia busca horários livres considerando:

    * Google Agenda do atendente (eventos já marcados)
    * Regras da fila (duração, antecedência mínima, modo online/presencial)
    * **Escala de atendimento** — quando **Utilizar escala dos atendentes** está ativo na fila, os horários disponíveis seguem a [escala vinculada](/guias/fila/escala-atendimento)
  </Step>

  <Step title="Oferta de horários">
    A Mia pode sugerir os próximos horários disponíveis ou confirmar diretamente o horário escolhido pelo lead.
  </Step>

  <Step title="Lead confirma">
    A Mia cria o evento no Google Agenda do atendente e dos convidados configurados, com:

    * Título da visita ou reunião
    * Endereço (quando presencial)
    * Link de **Google Meet** (quando online)
    * Descrição com contexto do lead
  </Step>

  <Step title="Alteração ou cancelamento">
    A Mia pode remarcar ou cancelar — o evento no Google Agenda é atualizado ou removido conforme a ação.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/LS9hStYiccK57wFM/images/mia/agendamento-conversa-ia.png?fit=max&auto=format&n=LS9hStYiccK57wFM&q=85&s=e17c77395abfef38aa2e77660dce6751" alt="Conversa no WhatsApp com a Mia consultando agenda e ofertando horários disponíveis ao lead" className="mx-auto" style={{ width:"47%" }} width="1140" height="2400" data-path="images/mia/agendamento-conversa-ia.png" />
</Frame>

## Como o atendente conecta o calendário

Necessário **apenas** para filas no modo Agendamento de Visita (modo com calendário). Cada atendente conecta o **próprio Google Agenda** nas configurações da conta.

<Steps>
  <Step title="Acesse Configurações da conta">
    Abra **Configurações da conta** no menu do seu perfil.
  </Step>

  <Step title="Conecte o Google Agenda">
    Na seção **Integrações**, clique em **Conectar** ao lado de **Google Agenda** e autorize o acesso.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/mia/agendamento-google-agenda.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=a173243594ed7ede429b1fbf4ef9235f" alt="Tela de Configurações da conta com integração Google Agenda" width="1225" height="971" data-path="images/mia/agendamento-google-agenda.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  Sem o Google Agenda conectado, o atendente **não recebe agendamentos** em filas de **Agendamento de Visita**.
</Info>

## Fila com Agendamento de Visita

Para o modo com calendário, configure uma fila no modo **Agendamento de Visita**.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/mia/agendamento-fila-visita.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=3cc37974c57d44607e0bd28014c88270" alt="Configuração de fila com modo Agendamento de Visita" width="1608" height="1073" data-path="images/mia/agendamento-fila-visita.png" />
</Frame>

Na criação ou edição da fila, em **Modo de distribuição**, selecione **Agendamento de Visita**. Em seguida configure:

| Campo                                | O que faz                                                                                                                                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Modo de agendamento**              | Online, Presencial ou Ambos. Online cria evento com Google Meet; Presencial usa endereço cadastrado na fila. No modo **Ambos**, o lead escolhe durante a conversa.                                      |
| **Utilizar escala dos atendentes**   | Quando ativo, os horários disponíveis respeitam a [escala de atendimento](/guias/fila/escala-atendimento) vinculada à fila. Quando inativo, usa os horários de agendamento do empreendimento ou da Mia. |
| **Duração do agendamento (minutos)** | Quanto dura cada compromisso (ex: 60).                                                                                                                                                                  |
| **Antecedência mínima (minutos)**    | Tempo mínimo entre o agendamento e o início do evento (ex: 120 minutos = 2 horas).                                                                                                                      |
| **Endereços**                        | Obrigatório nos modos Presencial ou Ambos. Cadastre um ou mais endereços e, se necessário, vincule cada um a empreendimentos específicos da fila.                                                       |
| **E-mails no convite**               | Lista de e-mails adicionais incluídos no convite (ex: gerente, supervisor).                                                                                                                             |
| **Rodapé da descrição do evento**    | Texto fixo adicionado ao final da descrição de todo evento criado por essa fila.                                                                                                                        |
| **Equipes / Atendentes**             | Quem pode receber agendamentos — **somente atendentes com Google Agenda conectado** recebem visitas nesse modo.                                                                                         |

<Warning>
  Apenas atendentes com **Google Agenda conectado** recebem agendamentos em filas no modo Agendamento de Visita. Se **Utilizar escala dos atendentes** estiver ativo, o atendente também precisa ter escala vinculada à fila.
</Warning>

## Horários de agendamento (modo convencional)

No fluxo convencional, a validação usa os **horários de agendamento** configurados em:

1. **Empreendimento** — prioridade quando definido
2. **Mia** — quando o empreendimento não tem horário próprio

Esses horários são distintos dos **horários gerais de atendimento** da Mia e dos horários de escala usados na distribuição de tickets. A **antecedência mínima** do modo convencional (em horas úteis) também é configurada pelo time técnico — não use o campo da fila de Agendamento de Visita como referência nesse fluxo.

<Info>
  Horários de agendamento e antecedência mínima do modo convencional são definidos pelo **time técnico da Morada**. Se quiser entender como estão configurados hoje ou solicitar ajustes, abra um ticket pelo [Iago Suporte](/guias/suporte/iago).
</Info>

## Casos de uso

* Visita ao stand de vendas
* Visita ao apartamento decorado
* Reunião online de apresentação de empreendimento

<Info>
  Agendamento para **pós-venda (Iago)** — vistoria de entrega, chamado técnico, etc. — ainda não está coberto por este guia. No Iago, agendamentos costumam seguir integrações específicas com o ERP do parceiro.
</Info>

## Quando ativar

* Operação tem SLA de "visita marcada em 24h" e o corretor não confirma a tempo.
* Stand cheio com muitas visitas — gestão manual de agenda virou gargalo.
* Cliente quer agendar fora do horário comercial sem esperar atendente.

Para começar sem Google Agenda, o **agendamento convencional** já resolve validação de horário e registro na plataforma. O modo com calendário entra quando a operação estiver pronta para integrar Google Agenda e configurar a fila de Agendamento de Visita.

***

## FAQ

<AccordionGroup>
  <Accordion title="Qual a diferença entre agendamento convencional e com calendário?">
    **Convencional:** a Mia valida o horário contra os horários de agendamento configurados, registra o compromisso na Morada e encaminha o ticket para a fila de distribuição de agendamentos — **sem** evento no Google Agenda e **sem** exigir fila no modo Agendamento de Visita.

    **Com calendário:** exige fila no modo Agendamento de Visita e que **cada atendente da fila tenha o próprio Google Agenda conectado**. A Mia consulta a disponibilidade real de cada atendente, cria o evento no calendário de quem receber a visita e sincroniza alterações e cancelamentos.

    **CRM:** nos dois modos, **CRMs integrados que suportam o evento de agendamento** — como CV, Pipedrive, HubSpot, RD Station, Salesforce, Moskit, Facilita, Hypnobox, Dommus e outros compatíveis — podem receber a visita sincronizada, desde que a integração esteja configurada para isso.
  </Accordion>

  <Accordion title="Como a Mia decide qual caminho usar?">
    Ao agendar, a Mia verifica se está vinculada a alguma fila ativa no modo Agendamento de Visita. Se encontrar, usa o modo com calendário. Se não encontrar, usa o convencional.
  </Accordion>

  <Accordion title="O atendente precisa autorizar a conexão com Google Agenda?">
    Sim — mas **somente** para filas no modo Agendamento de Visita. Cada atendente conecta em **Configurações da conta → Integrações → Google Agenda**.
  </Accordion>

  <Accordion title="A Mia pode ofertar horário fora do expediente?">
    Não. A Mia só propõe horários permitidos pela configuração da operação:

    * **Agendamento convencional:** segue os horários de agendamento do empreendimento ou da Mia, e a antecedência mínima em horas úteis definida pelo time técnico.
    * **Agendamento com calendário:** considera a disponibilidade real no Google Agenda de cada atendente, as regras da fila (duração e antecedência mínima em minutos) e, quando **Utilizar escala dos atendentes** estiver ativo, a escala vinculada à fila.
  </Accordion>

  <Accordion title="O que acontece se o atendente bloquear o horário depois?">
    No modo com calendário, o evento permanece no Google Agenda até ser cancelado. Conflitos manuais criados depois do agendamento precisam ser tratados pelo atendente.

    No modo convencional, o registro fica na Morada — alterações no calendário pessoal do atendente não afetam o agendamento na plataforma.
  </Accordion>

  <Accordion title="Posso usar a agenda da sala do stand em vez do calendário pessoal do corretor?">
    Por padrão, **cada atendente conecta o próprio Google Agenda** e as visitas são registradas na agenda de quem receber o agendamento.

    Se o stand ou a sala de vendas usa uma **agenda compartilhada do Google** (por exemplo, um e-mail da equipe ou da recepção), um atendente responsável pode conectar essa conta em **Configurações da conta → Integrações → Google Agenda**. As visitas passam a ser criadas nessa agenda compartilhada — desde que essa conta tenha permissão para criar eventos nela.
  </Accordion>

  <Accordion title="Qual a duração padrão dos eventos?">
    No modo **convencional**, não há duração configurada — o agendamento registra apenas **data e hora** de início da visita ou reunião.

    No modo **com calendário**, a duração vem do campo **Duração do agendamento (minutos)** da fila (ex: 60 minutos) e define o término do evento no Google Agenda.
  </Accordion>

  <Accordion title="O atendente sem calendário conectado pode receber agendamentos?">
    No modo **Agendamento de Visita**, não — sem Google Agenda conectado, o atendente não recebe agendamentos.

    No modo **convencional**, sim — após o agendamento, o ticket segue a fila de distribuição de agendamentos configurada na operação. Essa fila **não precisa** ser uma fila no modo Agendamento de Visita, e o atendente **não precisa** ter Google Agenda conectado.
  </Accordion>

  <Accordion title="Como a escala de atendimento se relaciona com o agendamento?">
    Na fila de Agendamento de Visita, com **Utilizar escala dos atendentes** ativado, a Mia respeita a escala vinculada à fila ao calcular horários disponíveis. Veja o [guia de escala de atendimento](/guias/fila/escala-atendimento).
  </Accordion>

  <Accordion title="Quando o modo Agendamento de Visita estará disponível para todos?">
    A Morada está liberando gradualmente (Beta). Entre em contato com seu gerente de conta para saber se sua operação já está habilitada.
  </Accordion>
</AccordionGroup>