Diretriz Prática & Artigos da Categoria IA & Atendimento no WhatsApp
Para aprofundar esta diretriz na operação do escritório, consulte também nossos estudos complementares sobre Leona no WhatsApp: recepção, triagem e encaminhamento ao advogado e IA no atendimento jurídico: LGPD, sigilo e dados sensíveis, ou conheça a arquitetura de Conhecer o S.H.I.O..
As APIs informam disponibilidade dentro de um período consultado
O Google Calendar FreeBusy consulta calendários ou grupos em um período e retorna intervalos ocupados (`busy`) ou erros. A resposta informa disponibilidade, não o assunto dos eventos.
Microsoft Graph `getSchedule` retorna disponibilidade no período consultado. No acesso delegado, a permissão mínima indicada para conta profissional ou escolar é `Calendars.ReadBasic`; conta pessoal não é suportada.
As consultas dependem de calendário, permissão, fuso e período corretos. Se houver erro ou indisponibilidade, sinalize a falha; ausência de resposta não significa horário livre.
Consulte a documentação oficial do FreeBusy do Google e do getSchedule do Microsoft Graph para campos e permissões.
Questão-Chave de Gestão (IA & Atendimento no WhatsApp): "Quais integrações e regras de disponibilidade precisam ser validadas antes de sincronizar agendamentos entre canais e agendas?" — Entenda o que Google Calendar FreeBusy e Microsoft Graph getSchedule informam e quais regras, permissões e testes definir.
O escritório define buffers, duração e quais agendas consultar
Deslocamento, preparação e pausas são regras do escritório; a API não as infere. Defina esses intervalos antes de oferecer horários.
Defina agendas, duração e intervalos entre compromissos. Se um evento privado só deve bloquear o período, consulte disponibilidade sem expor seu assunto.
Teste alterações, cancelamentos, recorrências, fusos, feriados e calendários compartilhados. Determine quem gerencia acessos e trata falhas.
A recepção com IA pode ser avaliada junto ao fluxo de recepção e encaminhamento pelo WhatsApp, mantendo separados o atendimento automatizado e a disponibilidade de uma pessoa.
Conheça o escopo deste serviço, seus pré-requisitos e limites. A implantação depende da avaliação da rotina do escritório e da aprovação do advogado responsável.
Consultar um intervalo não equivale a reservar o horário
A resposta reflete o período consultado e pode ficar desatualizada. Revalide o horário e trate conflito ou falha antes de confirmar ao interessado.
FreeBusy e getSchedule consultam disponibilidade; não criam reservas, enviam convites ou sincronizam mudanças por si sós. Essas operações exigem implementação e permissões próprias.
Defina contingência manual e responsável por divergências. Teste pedidos simultâneos e alterações feitas diretamente na agenda.
O serviço de IA & Triagem no WhatsApp pode incluir avaliação de integração quando ela fizer parte do escopo contratado; compatibilidade e permissões devem ser confirmadas para as contas utilizadas.
Use permissões compatíveis com a consulta e teste os limites
No Google Calendar, escolha um escopo FreeBusy compatível com a consulta necessária e confirme as permissões concedidas pelo titular.
No Graph, `Calendars.ReadBasic` é a permissão delegada menos privilegiada para getSchedule em conta profissional ou escolar. Conta pessoal não é suportada.
No aceite, teste conta, calendários, fuso, intervalos `busy`, erros e indisponibilidade com eventos fictícios.
Na operação, use apenas dados de disponibilidade necessários à finalidade. Restrinja o acesso à equipe responsável e defina prazo de retenção e descarte dos registros.
Agenda, atendimento e CRM podem exigir componentes distintos. O diagnóstico delimita o que será avaliado; não pressupõe implantação de todas as integrações.
Fontes consultadas
- Google Calendar API — Freebusy: query — consulta em 2026-10-24
- Microsoft Graph — calendar: getSchedule (v1.0) — consulta em 2026-10-24
- Lei nº 13.709/2018 (LGPD) — texto compilado oficial — consulta em 2026-10-24
- Provimento CFOAB nº 205/2021 — publicidade e informação da advocacia — consulta em 2026-10-24
A confiabilidade depende de regras e testes da implantação
Google FreeBusy e Microsoft Graph getSchedule informam disponibilidade nos limites documentados e das permissões concedidas.
A equipe ainda precisa definir regras de agenda, tratar falhas e confirmar a reserva antes de comunicar um compromisso como marcado.
Perguntas Frequentes
O retorno busy bloqueia o horário automaticamente?
Não. A consulta retorna intervalos ocupados; filtrar opções e criar o compromisso são etapas distintas da implementação.
O getSchedule funciona com uma conta pessoal Microsoft?
Não. O método não suporta conta Microsoft pessoal nesse acesso. Para conta profissional ou escolar, a permissão delegada mínima indicada é `Calendars.ReadBasic`.
Uma consulta de disponibilidade elimina colisões de agenda?
Não. A resposta pode ficar desatualizada. A implementação deve prever revalidação, concorrência e confirmação.
Avalie regras, contas e dependências da integração
O diagnóstico S.H.I.O. ajuda a organizar componentes, responsáveis e dependências. Integração de agenda só faz parte do escopo quando for avaliada, contratada e validada; o Core não pressupõe a implantação de todos os módulos.
