Calendarios

O que e

A integracao com Google Calendar permite que agents agendem, cancelem e atualizem reunioes diretamente durante a conversa com o lead.

Configuracao do Calendario

Cada calendario e uma calendar_config com os seguintes campos:

Campo	Descricao
name	Nome de exibicao
slug	Identificador unico
calendar_ids	Lista de calendarios Google a considerar
working_hours	Horarios de trabalho por dia da semana
working_days	Dias da semana disponiveis (0=domingo, 6=sabado)
slot_duration	Duracao de cada slot em minutos
buffer_minutes	Buffer entre reunioes (aplicado antes e depois de eventos existentes)

Como Funciona

Consulta de Disponibilidade

1. Agent chama get_available_slots com data desejada
2. O servico consulta o Google Calendar via API (service account)
3. Filtra por horario de trabalho e dias configurados
4. Remove slots que conflitam com eventos existentes (considerando buffer)
5. Retorna lista de horarios disponiveis

Agendamento

1. Agent chama schedule_meeting com data/hora escolhida pelo lead
2. O servico cria o evento no Google Calendar
3. Salva os dados da reuniao no estado da conversa (meeting_{id})
4. Agenda lembretes automaticos (1 dia, 2h, 30min, 5min antes)
5. Move o deal automaticamente para o stage on_meeting no CRM
6. Adiciona nota no deal do RD Station

Cancelamento e Atualizacao

• cancel_meeting: Remove o evento do Google Calendar, cancela lembretes, adiciona nota no CRM
• update_meeting: Atualiza data/hora do evento, reagenda lembretes, adiciona nota no CRM

Lembretes Automaticos

Ao agendar uma reuniao, 4 tarefas de lembrete sao criadas automaticamente:

Antecedencia	Mensagem
1 dia	Lembrete de reuniao amanha
2 horas	Lembrete de reuniao em 2 horas
30 minutos	Lembrete de reuniao em 30 minutos
5 minutos	Lembrete de reuniao em 5 minutos

Os lembretes sao cancelados automaticamente se a reuniao for cancelada.

Autenticacao Google

A integracao usa uma Service Account do Google. As credenciais podem vir de:

1. Variavel de ambiente GCAL_CREDENTIALS (JSON da service account)
2. Fallback para as credenciais do GCS (GCS_CREDENTIALS)

A service account precisa ter acesso aos calendarios configurados (compartilhar o calendario com o email da service account).

Configurando no Frontend

1. Acesse /calendars
2. Clique em "Nova Configuracao"
3. Selecione os calendarios Google (listados via API)
4. Configure horarios de trabalho e dias disponiveis
5. Defina duracao dos slots e buffer
6. Salve
7. No agent desejado, vincule o calendar_config_slug e defina o timezone