Agenda & Agendamentos
Por Conversa Labs
Por Conversa Labs
Conectar Google Calendar, tipos de evento, disponibilidade, página pública de agendamento, reagendar/cancelar, Meet e .ics.
Visão geral de Agenda e Agendamentos
Visão geral A Agenda da Conversa Labs é o módulo nativo de calendário e agendamentos. Em um só lugar você cria calendários, registra eventos e compromissos, conecta uma ou mais contas do Google Calendar com sincronização nos dois sentidos e publica uma página pública de agendamento no estilo Calendly, onde clientes marcam horários sozinhos respeitando a sua disponibilidade real. A Agenda é integrada ao resto da plataforma: um agendamento pode abrir uma conversa, criar uma tarefa com lembrete, vincular-se a um negócio do CRM, gerar um link do Google Meet e enviar um e-mail de confirmação com arquivo .ics. Tudo isso fica visível dentro da conversa do contato e pode ser acionado pelo Maestro (IA) e pelas automações. Pré-requisitos - Uma conta Conversa Labs ativa com o módulo Agenda habilitado. Ele é opcional e vem desligado por padrão — um administrador precisa ativá-lo para a conta. - Permissão de acesso adequada (em geral, perfil de administrador para configurar calendários, integrações e a página pública). - Para a sincronização com o Google, uma conta Google com acesso ao Google Calendar. - Para agendamentos pagos (opcional), o módulo Pagamentos ativo na conta. Passo a passo 1. Peça a um administrador para habilitar o módulo Agenda na conta. 2. Abra a Agenda pela barra lateral esquerda. 3. Use Calendário para operar a agenda e Agendamentos para acompanhar reservas, pagamentos e conversas vinculadas. 4. Administradores encontram Tipos de evento, Calendários, Conexões, Relatórios e Configurações no menu Gerenciar. 5. Crie um calendário nativo (com nome, cor e fuso horário) ou conecte o Google Calendar. 6. Defina sua disponibilidade e crie um ou mais tipos de evento para a página pública. 7. Compartilhe o link público de agendamento com seus clientes e acompanhe os compromissos na Agenda. Configurações & opções - Calendários: nativos ou do Google, com fuso horário, cor e atribuição a agentes, equipes ou caixas de entrada. - Conexões Google: várias contas do Google por conta Conversa Labs, cada uma expondo vários calendários para espelhar. - Tipos de evento: modelos da página pública com duração, buffers, antecedência mínima e máxima e perguntas de triagem. - Disponibilidade: faixas semanais recorrentes mais exceções para datas específicas. - Efeitos do agendamento: abrir conversa, criar tarefa, vincular a negócio do CRM e enviar confirmação com Meet e .ics — cada um pode ser ligado ou desligado. - Espaço de trabalho: use o mini calendário, a busca, os filtros de status e a lista de calendários para reduzir a grade ao contexto necessário. No celular, a visualização Dia/Lista é priorizada e os filtros abrem em um painel. - Eventos: clicar em um evento abre primeiro um resumo com horário, contato, local, participantes e ações. A edição completa continua disponível pelo botão Editar evento; ao criar, as opções menos frequentes ficam em Mais opções. Casos de uso - Receber agendamentos de clientes sem trocar mensagens, com horários sempre atualizados. - Manter o Google Calendar e a Conversa Labs em sincronia, sem digitar o mesmo evento duas vezes. - Transformar um compromisso confirmado em conversa, tarefa e negócio do CRM automaticamente. - Enviar reuniões com link do Google Meet e convite .ics já prontos. Dicas, limites e boas práticas - Comece com um calendário e um tipo de evento; amplie depois que a equipe se acostumar. - Mantenha o fuso horário correto em cada calendário para evitar horários trocados. - Na versão atual, a integração externa é com o Google Calendar (outros provedores ficam para uma fase futura). O arquivo .ics gerado funciona em qualquer aplicativo de calendário. - A página pública é não autenticada: ela mostra apenas horários livres, nunca os detalhes de outros agendamentos. Solução de problemas - Não vejo a Agenda na barra lateral: o módulo pode não estar habilitado para a conta ou para o seu perfil — fale com um administrador. - Os horários aparecem errados: confira o fuso horário do calendário — é ele que ancora a disponibilidade. O tipo de evento não tem fuso próprio; o cliente sempre vê os horários no fuso do navegador dele. - Um evento não apareceu no Google (ou vice-versa): confira se a conexão Google está ativa; a sincronização ocorre em tempo quase real, com uma verificação periodica de segurança. Veja também - Conectar o Google Calendar (OAuth) e sincronização - Tipos de evento, disponibilidade e buffers - Página pública de agendamento - Reagendar, cancelar, Google Meet e arquivo .ics
Conectar o Google Calendar (OAuth) e sincronização
Visão geral A Agenda da Conversa Labs sincroniza nos dois sentidos com o Google Calendar: eventos criados na plataforma aparecem no Google e eventos criados no Google aparecem na plataforma, sem duplicar e sem entrar em loop. A conexão é feita uma vez via autorização Google (OAuth) e fica permanente — ela se renova sozinha até que você desconecte manualmente. Você pode conectar várias contas do Google à mesma conta Conversa Labs, e cada conta do Google pode expor vários calendários para espelhar. A autorização é compartilhada (você não precisa criar um app Google próprio). Pré-requisitos - Módulo Agenda habilitado na conta (opcional, desligado por padrão — peça a um administrador). - Perfil com permissão para configurar integrações (em geral, administrador). - Uma conta Google com acesso ao Google Calendar. - Ao autorizar, conceda as permissões de calendário solicitadas — sem elas a sincronização não funciona. Passo a passo 1. Abra a Agenda e vá até a área de conexões / integrações do Google. 2. Clique para conectar o Google Calendar. Você será levado à tela de autorização do Google. 3. Escolha a conta Google e autorize o acesso ao seu calendário. 4. De volta à plataforma, selecione quais calendários daquela conta você quer espelhar. 5. (Opcional) Repita o processo para conectar outras contas do Google. 6. Aguarde a primeira sincronização: os eventos existentes passam a aparecer na Agenda. Configurações & opções - Várias conexões: cada conta Google conectada aparece separadamente, com seus calendários. - Seleção de calendários: ligue apenas os calendários que deseja espelhar. - Atribuição: vincule cada calendário (nativo ou do Google) a agentes, equipes ou caixas de entrada, conforme a operação. - Google Meet, convidados, lembretes e recorrência: quando criados na plataforma, são levados ao Google; quando criados no Google, voltam para a plataforma. - Desconectar: a conexão permanece ativa e auto-renovável até você desconectar manualmente, o que revoga o acesso no Google e remove a conexão. Casos de uso - Centralizar o calendário pessoal/da equipe do Google dentro da operação de atendimento. - Deixar que agendamentos da página pública respeitem os horários ocupados do Google. - Conectar a agenda de mais de uma pessoa ou setor à mesma conta Conversa Labs. Dicas, limites e boas práticas - A sincronização é em tempo quase real (atualizações chegam rápido), com uma verificação periodica de segurança para garantir que nada fique de fora. - Eventos criados pela plataforma são marcados internamente para evitar loops de ida e volta. - Na versão atual, o provedor externo suportado é o Google Calendar. Outros provedores estão previstos para uma fase futura. - Suas credenciais do Google ficam guardadas com segurança no servidor e nunca são exibidas no painel. Solução de problemas - A autorização falhou: refaça o fluxo e confirme que concedeu as permissões de calendário. - Conectei, mas não vejo eventos: confirme que selecionou ao menos um calendário para espelhar e aguarde a primeira sincronização. - Um evento sumiu ou duplicou: verifique se a conexão continua ativa; a verificação periodica reconcilia diferenças automaticamente. Em último caso, reconecte a conta. - Parei de receber atualizações: a conexão pode ter sido revogada no Google — reconecte-a. Veja também - Visão geral de Agenda e Agendamentos - Tipos de evento, disponibilidade e buffers - Página pública de agendamento - Reagendar, cancelar, Google Meet e arquivo .ics
Sincronização com o Google Calendar: importar, status e reconectar
Visão geral Depois de conectar o Google Calendar, a Agenda mantém tudo em sincronia nos dois sentidos. Este artigo trata do acompanhamento dessa sincronização: como importar eventos que já existiam no Google, o que cada status de sincronização significa, como forçar uma atualização com Sincronizar agora e o que fazer quando o acesso do Google expira e é preciso reconectar. A sincronização é em tempo quase real, com uma verificação periódica de segurança que reconcilia diferenças. Você não precisa sincronizar manualmente no dia a dia — as opções abaixo servem para inspeção e para casos pontuais. Pré-requisitos - Módulo Agenda habilitado e uma conexão Google já criada (veja o artigo de conexão/OAuth). - Perfil com permissão para gerenciar integrações. - Ao menos um calendário do Google selecionado para espelhar. Passo a passo Importar eventos existentes: 1. Abra a Agenda e vá até a conexão do Google. 2. Selecione os calendários que deseja espelhar. 3. Aguarde a primeira sincronização: os eventos já existentes no Google passam a aparecer na Agenda. Ver o status e forçar uma atualização: 1. Na conexão do Google, verifique o status de sincronização (veja a tabela abaixo). 2. Se quiser atualizar na hora, use Sincronizar agora. Reconectar quando o acesso expira: 1. Se o status indicar acesso expirado/revogado, clique em Reconectar. 2. Refaça a autorização do Google e conceda as permissões de calendário. 3. A sincronização volta a funcionar e a verificação periódica reconcilia o que ficou pendente. Configurações & opções - Importar eventos existentes: a primeira sincronização traz para a Agenda os eventos que já estavam no Google. - Status de sincronização: | Status | O que significa | |---|---| | Conectado / Sincronizado | Tudo em dia; atualizações fluem nos dois sentidos. | | Sincronizando | Uma sincronização está em andamento (primeira carga ou atualização). | | Acesso expirado / revogado | O Google revogou o acesso — é preciso reconectar. | | Erro | Uma falha temporária; a verificação periódica tenta de novo. | - Sincronizar agora: força uma atualização imediata, sem esperar a verificação periódica. Também destrava uma conexão que ficou presa em "Sincronizando". - Reconectar: refaz a autorização do Google quando o acesso expira ou é revogado. - Último erro / erros recentes: o painel mostra a última falha devolvida pelo Google mesmo enquanto o status ainda é "Sincronizando", para você não ficar esperando um processo que já falhou. O que acontece quando você muda algo direto no Google Uma alteração feita no Google vale exatamente como uma feita na plataforma. Ao arrastar, editar ou cancelar um compromisso no Google Calendar: - O cliente é avisado. Um remarcado ou um cancelado dispara o mesmo aviso (WhatsApp/e-mail e o arquivo .ics) que uma remarcação feita pelo painel — respeitando os mesmos interruptores de notificação que você já configurou. Se você desligou o aviso de remarcação, ele continua desligado. - Suas automações rodam. Regras e fluxos com gatilho de compromisso criado, remarcado ou cancelado passam a disparar também para mudanças vindas do Google. - A tela atualiza sozinha. A grade da Agenda reflete a mudança sem recarregar a página. - Os lembretes do novo horário voltam a valer. Ao arrastar um compromisso para outra data no Google, os lembretes são reprogramados para o novo horário. - A reserva acompanha. Cancelar no Google também encerra a reserva correspondente, então a página pública do cliente deixa de oferecer "remarcar" para um compromisso que não existe mais. A primeira importação é silenciosa. Ao espelhar um calendário que já tinha centenas de compromissos, a carga inicial não dispara avisos, automações nem notificações — ela apenas traz o que já existia. Só as mudanças a partir dali são anunciadas. Importar um compromisso nunca é uma confirmação de agendamento. A plataforma não manda "seu horário está confirmado" para alguém só porque o compromisso apareceu no Google. Integração Google por tipo de evento Cada tipo de evento decide, de forma independente, como conversa com o Google. A configuração fica no editor do tipo de evento, na seção Integração Google: - Bloquear horários ocupados nestes calendários: marque quantos calendários quiser. Nenhum horário já ocupado em qualquer um deles será oferecido na página pública. É assim que você evita ser agendado por cima de um compromisso pessoal que está em outra agenda. - Criar os eventos em: escolha um calendário do Google para receber os agendamentos confirmados. É nele que o convite e o link do Meet são criados. Se você não configurar nada, o comportamento continua o de antes: o tipo usa a própria agenda, e só conversa com o Google quando essa agenda é espelhada. Casos de uso - Trazer para a Agenda a agenda que já existia no Google, sem redigitar eventos. - Conferir rapidamente se a conexão está em dia antes de um dia cheio. - Forçar Sincronizar agora após mexer em vários eventos no Google. - Restabelecer a sincronização com Reconectar depois que a senha/permissão do Google mudou. Dicas, limites e boas práticas - No dia a dia, não é preciso sincronizar manualmente — a sincronização é automática e quase em tempo real. - Use Sincronizar agora apenas para conferência ou após grandes mudanças no Google. - Se o status ficar em acesso expirado, reconecte o quanto antes para não perder atualizações. - Selecione apenas os calendários que realmente quer espelhar — menos ruído na Agenda. - Eventos criados pela plataforma são marcados internamente para evitar loops de ida e volta. - Editar um compromisso na plataforma não muda mais o que você configurou só no Google: eventos marcados como "Livre", a visibilidade (privado/confidencial) e as permissões dos convidados são preservados. Solução de problemas - Conectei, mas os eventos antigos não vieram: confirme que selecionou ao menos um calendário para espelhar e aguarde a primeira sincronização; use Sincronizar agora para forçar. - Parei de receber atualizações: o acesso pode ter expirado/sido revogado no Google — use Reconectar. - Um evento sumiu ou duplicou: a verificação periódica reconcilia diferenças; se persistir, use Sincronizar agora e, em último caso, reconecte a conta. - O status fica em "Sincronizando" por muito tempo: a primeira carga de uma agenda grande leva alguns minutos, mas não deve passar disso. Se continuar em "Sincronizando", não fique só esperando — abra o painel da conexão e olhe o último erro e a contagem de erros recentes, que agora aparecem mesmo enquanto o status ainda é "Sincronizando". Use Sincronizar agora: ele destrava um estado preso e recomeça a carga. Se o erro persistir, reconecte a conta. - O status fica em "Erro": o painel mostra a mensagem que o Google devolveu. Erro de acesso (expirado/revogado) só se resolve com Reconectar. - Parou de sincronizar sozinho depois de alguns dias: se o app OAuth do Google ainda estiver em modo Testing (não verificado), o Google revoga o acesso a cada 7 dias — a conexão vai quebrar semanalmente até o app ser verificado no Google Cloud. Você recebe um aviso por e-mail quando isso acontece; a correção definitiva é publicar/verificar o app. - Eventos marcados como "Livre" no Google: eles aparecem na Agenda, mas não bloqueiam horários da sua página de agendamento — é o mesmo comportamento do Google. - Eventos recorrentes: cada ocorrência é importada individualmente, então a série aparece em todas as datas, não só na primeira. Veja também - Conectar o Google Calendar (OAuth) e sincronização - Excluir ou cancelar um evento: qual usar - Reagendar, cancelar, Google Meet e arquivo .ics - Visão geral de Agenda e Agendamentos
Tipos de evento, disponibilidade e buffers
Visão geral O tipo de evento é o modelo que aparece na sua página pública de agendamento — por exemplo "Reunião de 30 min" ou "Demonstração de 1 h". Cada tipo de evento define a duração, as regras de quando pode ser marcado e o que acontece quando alguém reserva. A disponibilidade define as faixas de horário em que você aceita compromissos, e os buffers garantem respiro entre um agendamento e outro. Os horários oferecidos ao cliente são sempre o cruzamento de três coisas: a sua disponibilidade, os seus horários já ocupados (nativos e do Google) e os buffers configurados. Assim, a página pública nunca oferece um horário que entre em conflito com algo já marcado. Pré-requisitos - Módulo Agenda habilitado e ao menos um calendário criado ou conectado. - Perfil com permissão para configurar tipos de evento e disponibilidade. - (Opcional, para distribuição entre vários atendentes) os agentes que vão receber os agendamentos. Passo a passo 1. Na Agenda, abra a área de tipos de evento e crie um novo. 2. Defina nome, duração e local (presencial, link ou Google Meet automático). 3. (Opcional) Logo abaixo do local, marque Deixar o cliente escolher o local e selecione duas ou mais opções (Google Meet, telefone, presencial ou personalizado). 4. Ajuste as regras de tempo: antecedência mínima, antecedência máxima e os buffers antes e depois. 5. Defina sua disponibilidade: as faixas de horário semanais em que aceita compromissos. Um mesmo dia pode ter mais de uma faixa — use Adicionar intervalo para deixar o almoço de fora, por exemplo 09:00–12:00 e 13:00–18:00. 6. Adicione exceções para datas específicas (feriados, folgas ou horários extras). 7. (Opcional) Adicione perguntas de triagem que o cliente responde ao agendar. 8. (Opcional) Defina os agentes atribuídos e como os agendamentos são distribuídos entre eles. 9. Salve e use o link gerado na página pública de agendamento. Configurações & opções - Duração: quanto tempo dura cada compromisso desse tipo. - O que uma reserva ocupa na agenda: apenas o horário escolhido (padrão) ou o turno inteiro — para quem vende turno e não horário. Veja Ocupação por turno. - Limites de agendamento (buffers, antecedências e horizonte): cada um pode ficar vazio, e aí ele segue o padrão da conta (a dica dentro do campo mostra qual número é esse), ou receber um número — inclusive 0 — e aí vale só para este tipo. Use Usar o padrão da conta, logo abaixo do campo, para voltar a herdar. Detalhes em Padrões de agendamento da conta e herança. - Buffers: intervalo automático antes e depois de cada agendamento. - Antecedência mínima: quanto tempo de aviso prévio é exigido antes do horário. - Antecedência máxima: até quantos dias no futuro é possível marcar. - Antecedência mínima para cancelar: com quanto tempo de aviso o cliente ainda pode cancelar — a mesma janela vale para remarcar. - Limite de remarcações: quantas vezes o mesmo agendamento pode ser movido. Vazio = sem limite. - Marcar não comparecimento após: minutos depois do início em que um compromisso não atendido é marcado como falta. Vazio = nunca automaticamente. - Local / Google Meet: presencial, link manual ou geração automática de link do Meet. - Deixar o cliente escolher o local: fica logo abaixo do campo Local, no editor do tipo de evento. Marque duas ou mais opções (Google Meet, telefone, presencial ou personalizado) para que a página pública exiba o seletor a quem agenda. Com nenhuma ou apenas uma opção marcada, nada muda: vale o Local fixo definido acima. Quando o cliente escolhe Google Meet, o link da videochamada é gerado automaticamente — isso exige uma conexão Google ativa. - Distribuição entre agentes, quando há mais de um atendente: - Rodízio: cada agendamento vai para o atendente livre há mais tempo. É o padrão. - Coletiva: todos os atendentes escolhidos participam do mesmo compromisso e recebem o convite. - Fixo: sempre o primeiro atendente da lista. Use quando o tipo de evento é de uma pessoa só. - Perguntas de triagem: campos personalizados respondidos no momento da reserva. - Efeitos por tipo: ligue ou desligue, por tipo de evento, a criação de conversa, tarefa, vínculo com negócio do CRM e o envio da confirmação. Casos de uso - Oferecer "Reunião de 30 min" e "Demonstração de 1 h" com regras diferentes. - Bloquear marcações de última hora com uma antecedência mínima (por exemplo, 2 horas). - Garantir 10 minutos de respiro entre reuniões usando buffers. - Liberar horários extras em uma data específica sem mexer na disponibilidade semanal. Dicas, limites e boas práticas - Use antecedência mínima para não ser pego de surpresa por marcações imediatas. - Use buffers para deslocamento, anotações ou pausa entre atendimentos. - Mantenha a disponibilidade enxuta e use exceções para casos pontuais. - Ao deixar o cliente escolher o local, marque apenas as opções que você realmente consegue atender — todas aparecem na página pública. Se oferecer Google Meet, mantenha a conexão Google ativa para que o link seja gerado. - Confira sempre o fuso horário do calendário — ele ancora a disponibilidade e, portanto, os horários oferecidos ao cliente. - Em distribuição entre agentes, garanta que cada um tenha disponibilidade e calendário próprios para o rodízio funcionar bem. Solução de problemas - Não aparecem horários livres: verifique a disponibilidade, as antecedências e se há muitos horários já ocupados — os buffers também reduzem as opções. - Aparecem horários que eu não queria: revise as faixas de disponibilidade e as exceções da data. - O link do Meet não foi gerado: confirme que o tipo de evento está com Google Meet automático e que há uma conexão Google ativa. - O cliente não consegue escolher o local: o seletor só aparece com duas ou mais opções marcadas em Deixar o cliente escolher o local — com nenhuma ou uma, vale o local fixo. - Os horários estão deslocados: confira o fuso horário do calendário — o tipo de evento não tem campo de fuso; ele herda o do calendário em que está. Veja também - Visão geral de Agenda e Agendamentos - Conectar o Google Calendar (OAuth) e sincronização - Página pública de agendamento - Ocupação por turno - Reagendar, cancelar, Google Meet e arquivo .ics
Impedir compromissos sobrepostos
Visão geral Impedir compromissos sobrepostos faz a plataforma recusar a criação ou o reagendamento de um compromisso quando ele se sobrepõe a outro no mesmo calendário. Até esta opção existir, a única checagem de conflito da Agenda vivia na página pública de agendamento — que sempre ofereceu apenas horários livres. O caminho direto (o painel, a API e as ferramentas de agenda do Robô) não tinha checagem nenhuma: nada impedia dois compromissos às 08:00 e 08:30 no mesmo calendário. É opcional e vem desligada. E por um bom motivo: em muitas operações vários atendentes compartilham um calendário e marcam no mesmo horário de propósito. Ligar por padrão quebraria essas contas. Ligue apenas onde a sobreposição é de fato um erro. Pré-requisitos - O módulo Agenda habilitado na conta. - Permissão de administrador para alterar as configurações da Agenda e o cadastro dos calendários. - Pelo menos um calendário criado. Passo a passo Definir o padrão da conta 1. Abra a Agenda e vá em Configurações. 2. Na seção Padrões de agendamento, ligue Impedir compromissos sobrepostos. 3. Salve. A partir daí, todo calendário que não tiver uma decisão própria segue esse padrão. Definir a exceção de um calendário 1. Abra a lista de calendários da Agenda e edite o calendário desejado. 2. No campo Compromissos sobrepostos, escolha uma das três opções: - Usar o padrão da Agenda — herda a configuração da conta (é como todo calendário começa); - Bloquear sobreposições — sempre impede, mesmo com o padrão da conta desligado; - Permitir sobreposições — sempre permite, mesmo com o padrão da conta ligado. 3. Salve. Configurações & opções Como a decisão é resolvida A regra é lida de cima para baixo, e a primeira decisão explícita vence: opção do calendário → padrão da Agenda (conta) → desligado Um calendário em Usar o padrão da Agenda simplesmente acompanha a conta — e volta a acompanhar se você mudar o padrão depois. O que exatamente é bloqueado | Caminho | Comportamento com a opção ligada | |---|---| | Criar um compromisso pelo painel, pela API ou por uma ferramenta do Robô | falha se houver sobreposição no mesmo calendário | | Reagendar (mudar a data/hora) | falha se o novo horário se sobrepuser a outro compromisso | | Editar um compromisso sem mexer no horário | não é conferido — a checagem só roda quando a data/hora muda | | Agendar pela página pública | não muda: essa página sempre teve a própria checagem de conflito e só oferece horários livres | A comparação é sempre dentro do mesmo calendário. Dois calendários diferentes nunca conflitam entre si, mesmo que sejam do mesmo atendente. O que conta como ocupado Nem todo compromisso bloqueia o horário. Ficam de fora da checagem: - compromissos cancelados — um cancelamento devolve o horário; - compromissos marcados como Livre (transparentes, no vocabulário do Google Calendar) — eles aparecem na grade, mas não ocupam o anfitrião. É a mesma definição de "ocupado" que a página pública de agendamento já usava, de propósito: os dois lados do módulo concordam sobre o que é um horário tomado. Um compromisso marcado como Livre também não é bloqueado ao ser reagendado — ele nunca ocupou nada. O que o usuário vê Quando a opção está ligada e há choque, a operação falha com uma mensagem que nomeia o compromisso conflitante: Este horário se sobrepõe ao compromisso "Reunião com o cliente" no mesmo calendário. Escolha outro horário. Nada é salvo pela metade: o compromisso simplesmente não é criado (ou não é reagendado). Casos de uso - Agenda de uma pessoa só (consultório, advogado, consultor): ligar no padrão da conta evita a marcação dupla clássica. - Equipe com calendários separados por atendente: ligar no padrão da conta protege todos, já que cada calendário é de uma pessoa. - Calendário compartilhado de propósito (uma sala, uma turma, um plantão com vários atendentes): deixe Permitir sobreposições naquele calendário, mesmo com o padrão da conta ligado. - Agenda operada pelo Robô: com a opção ligada, o Robô não consegue marcar em cima de um horário já ocupado — a ferramenta falha e ele precisa oferecer outro horário. - Migração de agenda: enquanto importa compromissos antigos, deixe desligado; ligue depois de arrumar a base. Dicas, limites e boas práticas - Ligar não arruma o que já existe. A opção vale para o que for criado ou reagendado a partir de agora. Sobreposições já gravadas continuam lá — revise-as à mão. - É por calendário, não por atendente. Se a mesma pessoa atende em dois calendários, um horário em cada um deles não é considerado conflito. - Compromissos vindos do Google entram pela sincronização e passam a contar como ocupados (se estiverem ativos e não marcados como Livre) — mas a sincronização em si não é recusada; a opção atua no caminho direto. - A página pública nunca dependeu desta opção. Ela já evitava conflito antes e continua evitando depois — inclusive com a opção desligada. - Marque como Livre o que realmente não ocupa (um lembrete pessoal, um bloco informativo). Isso mantém a checagem útil em vez de barulhenta. - Se a equipe reclamar de "não consigo salvar", o primeiro lugar a olhar é a opção do calendário, não a da conta: uma exceção em Bloquear sobreposições vence o padrão desligado. Solução de problemas - "Não consigo salvar um compromisso": há sobreposição no mesmo calendário. A mensagem nomeia o compromisso conflitante — abra-o, confirme se ainda é válido e escolha outro horário, ou cancele o antigo. - "Desliguei nas configurações da Agenda e continua bloqueando": aquele calendário tem uma exceção própria em Bloquear sobreposições. Mude para Usar o padrão da Agenda ou Permitir sobreposições. - "Liguei e continua deixando marcar em cima": ou aquele calendário está em Permitir sobreposições, ou o compromisso existente está cancelado ou marcado como Livre — nenhum dos dois ocupa horário. Verifique também se os dois compromissos estão mesmo no mesmo calendário. - "Editei o título e deu erro de sobreposição": a checagem só roda quando a data/hora muda. Se deu erro, o horário foi alterado junto — confira os campos de início e fim. - "O Robô disse que não conseguiu agendar": com a opção ligada, esse é o comportamento esperado num horário ocupado. Peça ao contato outro horário, ou libere o horário no calendário. - "Dois atendentes precisam do mesmo horário": use calendários separados por atendente, ou deixe aquele calendário em Permitir sobreposições. Veja também - Tipos de evento, disponibilidade e intervalos - Disponibilidade em cascata - Página pública de agendamento - Reagendar, cancelar, Meet e .ics - Visão geral da Agenda
Ocupação por turno: uma reserva ocupa a manhã ou a tarde inteira
Visão geral Alguns serviços não são vendidos por horário, e sim por turno. Uma equipe de higienização de estofados que chega às 10:30 não fica livre às 11:30: ela ocupa a manhã inteira. O cliente precisa poder escolher a hora de chegada, mas o resto daquele turno tem que sair da agenda no mesmo instante. É isso que a opção "O turno inteiro" faz. Ela fica no tipo de evento, em O que uma reserva ocupa na agenda: - Apenas o horário escolhido (padrão): o compromisso mais os buffers. É como a Agenda sempre funcionou, e nada muda para os tipos de evento que já existem. - O turno inteiro: reservar qualquer horário ocupa toda a faixa de disponibilidade em que ele está. Marcou 10:30 dentro de 08:00–12:00? A manhã inteira some da página pública e só o turno da tarde continua à venda. O turno É a faixa de disponibilidade. Não existe um campo "turno" separado: a Agenda usa as faixas de horário que você já configura em Disponibilidade. Um dia com dois turnos é um dia com duas faixas separadas por um intervalo. Pré-requisitos - Módulo Agenda habilitado e um tipo de evento criado. - A disponibilidade do dia dividida em faixas separadas — é o que define os turnos. - Perfil com permissão para editar tipos de evento. Passo a passo 1. Abra Disponibilidade (do calendário ou do próprio tipo de evento) e divida cada dia nos turnos que você atende. Exemplo clássico: - 08:00 – 12:00 (manhã) - 14:00 – 18:00 (tarde) Use Adicionar intervalo para criar a segunda faixa. Deixe um intervalo entre elas. 2. Salve a disponibilidade. 3. Abra o tipo de evento e, em O que uma reserva ocupa na agenda, escolha O turno inteiro. 4. Ajuste a duração para o tempo real do atendimento (é ela que aparece para o cliente e vai para o Google e para o arquivo .ics) e o intervalo entre horários para de quanto em quanto tempo você quer oferecer chegadas: de 30 em 30 minutos, de hora em hora… 5. Salve e teste na página pública: escolha um horário da manhã e confira que a manhã inteira desapareceu, restando só a tarde. Configurações & opções - O que uma reserva ocupa na agenda: Apenas o horário escolhido ou O turno inteiro. - Duração: o tempo real do atendimento. Não precisa ser o tamanho do turno — o cliente vê essa duração, e é ela que vai para o calendário dele. - Intervalo entre horários (em Configurações da agenda → Padrões de agendamento): de quanto em quanto tempo as chegadas são oferecidas dentro do turno. - Buffers: com ocupação por turno, eles protegem as bordas do turno — buffer antes empurra o começo, buffer depois estende o fim. - Disponibilidade: as faixas de cada dia. São elas que definem os turnos. Casos de uso - Higienização de estofados: chegada entre 08:00 e 10:00, mas a equipe fica a manhã toda. - Mudanças e fretes: um serviço por turno, dois por dia. - Instalação técnica em domicílio: o cliente escolhe "manhã" e o técnico define a ordem da rota. - Locação de espaço por período: manhã, tarde ou os dois. Dicas, limites e boas práticas - Deixe um intervalo entre os turnos. Duas faixas que se encostam (12:00–14:00 logo após 08:00–12:00) são unidas em uma só faixa de 08:00 às 14:00 — e aí uma reserva ocupa as duas. O intervalo de almoço não é só uma pausa: é o que separa um turno do outro. - Um dia com uma única faixa vira um turno só. Se o dia tem apenas 08:00–18:00, uma reserva ocupa o dia inteiro. Isso pode ser exatamente o que você quer (um serviço por dia) — só precisa ser intencional. - Turno que vira a noite funciona. Uma faixa não atravessa a meia-noite, então um turno das 22:00 às 02:00 é escrito em dois dias: segunda 22:00–24:00 e terça 00:00–02:00. Como as duas se encostam na meia-noite, elas contam como um turno só — a reserva das 23:00 leva a madrugada junto, e o cliente pode escolher um horário que termina depois da meia-noite. - Qualquer compromisso dentro do turno o derruba, não só as reservas da página pública: um evento criado direto na agenda ou importado do Google às 09:00 também tira a manhã da venda. - Remarcar dentro do mesmo turno é permitido — o turno já é do cliente, então mover de 10:30 para 11:00 funciona normalmente. - Na agenda do painel, a reserva aparece no horário real e o turno ocupado aparece como uma faixa esmaecida atrás dela. Não é um segundo compromisso: é a mesma reserva, desenhada. - No Google: o técnico recebe o compromisso no horário real (10:30–11:30), não o turno inteiro. A reserva do turno vale na Agenda do Conversa Labs — quem marca compromisso direto no Google precisa olhar a Agenda também. Solução de problemas - Marquei um horário e o dia inteiro sumiu: o dia provavelmente tem uma faixa só, ou duas faixas que se encostam. Abra a Disponibilidade e separe os turnos com um intervalo. - A tarde sumiu junto com a manhã: as duas faixas estão coladas (por exemplo 08:00–12:00 e 12:00–18:00) e foram unidas. Deixe um intervalo real entre elas. - A página não oferece nenhum horário: a duração pode ser maior do que o turno. Um atendimento de 4 h não cabe numa faixa de 3 h. - Só aparece um horário por turno: aumente o intervalo entre horários — ele é o que decide quantas chegadas são oferecidas dentro do turno. - O cliente reclamou que o compromisso dele está errado no calendário: não está. O convite dele é o horário real que ele escolheu; o turno inteiro é uma reserva interna, e por isso não aparece no convite. Veja também - Tipos de evento, disponibilidade e buffers - Padrões de agendamento da conta e herança - Disponibilidade em cascata: conta, agenda e tipo de evento - Impedir compromissos sobrepostos
Disponibilidade em cascata: conta, agenda e tipo de evento
Visão geral A disponibilidade da Agenda funciona em cascata, em três níveis, do mais geral para o mais específico: 1. Conta — a disponibilidade padrão de toda a operação. Define aqui uma vez e vale para tudo. 2. Agenda (calendário) — pode herdar o padrão da conta ou definir horários próprios para aquele calendário/agente. 3. Tipo de evento — pode herdar o que vem da agenda (ou da conta) ou ter horários próprios só para aquele serviço (por exemplo, "Demonstração" só às terças de manhã). Cada nível herda o de cima até você decidir sobrescrever. Assim você não repete a mesma grade em toda parte: ajusta o padrão uma vez e só cria exceções onde realmente precisa. Os horários oferecidos ao cliente são sempre o cruzamento entre a disponibilidade efetiva (após a cascata), os horários já ocupados e os buffers. Pré-requisitos - Módulo Agenda habilitado e ao menos um calendário criado ou conectado. - Perfil com permissão para configurar disponibilidade. - (Opcional) Uma caixa de entrada com horário de funcionamento definido, se quiser copiar os horários dela. Passo a passo 1) Definir o padrão da conta: 1. Abra as configurações da Agenda e vá em Disponibilidade. 2. Defina as faixas de horário semanais padrão e o fuso horário. 3. (Opcional) Adicione feriados e datas de exceção que valem para toda a conta. 2) Refinar por agenda: 1. Abra o calendário/agenda desejado. 2. Deixe em Herdar da conta ou escolha Personalizar e ajuste as faixas só daquela agenda. 3) Refinar por tipo de evento: 1. Abra o tipo de evento. 2. Deixe em Herdar (da agenda/conta) ou defina horários próprios para aquele serviço. Copiar os horários da caixa de entrada (atalho): 1. Na tela de disponibilidade, use Copiar horários da caixa de entrada. 2. As faixas do horário de funcionamento da caixa entram como ponto de partida — ajuste se precisar. Copiar substitui a grade inteira. A caixa de entrada guarda uma única faixa por dia, então um dia que tinha duas (manhã e tarde separadas pelo almoço) volta com uma só. Se você já separou os turnos, monte as faixas à mão em vez de copiar — ou copie primeiro e recrie os intervalos depois. Configurações & opções - Herança (cascata): cada nível herda o de cima (conta → agenda → tipo de evento) até ser sobrescrito. - Faixas semanais: os intervalos recorrentes por dia da semana em que você aceita compromissos. - Fuso horário: definido por nível; afeta diretamente os horários oferecidos ao cliente. - Feriados / exceções: datas específicas que bloqueiam (ou liberam) horários, sem mexer na grade semanal. - Copiar horários da caixa de entrada: importa as faixas do horário de funcionamento de uma caixa como base da disponibilidade. Casos de uso - Definir um padrão de horário para a conta inteira e não repetir em cada agenda. - Uma agenda de um atendente específico com horários diferentes do padrão. - Um tipo de evento "Demonstração" só em horários reduzidos, mesmo que a agenda aceite mais. - Bloquear um feriado para toda a conta de uma vez. - Aproveitar o horário de funcionamento já configurado na caixa de entrada como ponto de partida. Dicas, limites e boas práticas - Configure primeiro o padrão da conta e só personalize onde há uma real diferença — menos grades para manter. - Deixe os níveis em Herdar sempre que possível: mudou o padrão da conta, muda para todos que herdam. - Confira o fuso horário de cada calendário; um fuso errado desloca todos os horários oferecidos. (Tipos de evento não têm fuso próprio — usam o do calendário.) - Use feriados/exceções em vez de apagar faixas da grade semanal — é reversível e mais claro. - Após copiar os horários da caixa de entrada, revise: o horário de atendimento nem sempre é igual ao horário de agendamento. Solução de problemas - Mudei o padrão da conta e uma agenda não mudou: ela provavelmente está Personalizada (não herda). Volte para Herdar ou ajuste diretamente. - Não aparecem horários livres: a cascata pode ter reduzido demais a disponibilidade efetiva; revise conta, agenda e tipo de evento. Revise também buffers e antecedências: eles têm o próprio padrão de conta em Configurações da agenda → Padrões de agendamento, e cada tipo de evento só sai desse padrão quando você preenche o campo dele. Deixar o campo do tipo vazio é o que faz ele seguir a conta. Veja Padrões de agendamento da conta e herança. - Um feriado não bloqueou: confirme em qual nível você o adicionou — feriados da conta valem para tudo; de uma agenda, só para ela. - Os horários da caixa não vieram: a caixa precisa ter um horário de funcionamento definido para poder copiar. Veja também - Tipos de evento, disponibilidade e buffers - Página pública de agendamento - Visão geral de Agenda e Agendamentos - Sincronização com o Google Calendar: importar, status e reconectar
Padrões de agendamento da conta e herança
Visão geral Quase toda regra de tempo da Agenda existe em dois lugares: um padrão da conta e, se você quiser, um valor próprio de cada tipo de evento. O padrão da conta é o que vale para todo mundo; o campo do tipo de evento só entra em cena quando você o preenche. A regra é simples e vale para todos os campos desta página: Campo vazio no tipo de evento = ele segue o padrão da conta. Campo preenchido = aquele tipo de evento tem a própria regra — inclusive 0. O 0 é uma resposta, não um campo vazio. Buffer depois = 0 quer dizer "este tipo não precisa de respiro", e isso vence o padrão da conta. Já o campo vazio quer dizer "use o que a conta disser" — se amanhã você mudar o padrão da conta, este tipo muda junto. Pré-requisitos - Módulo Agenda habilitado. - Perfil com permissão para abrir Configurações da agenda. Passo a passo 1. Na Agenda, abra Configurações. 2. Vá até o bloco Padrões de agendamento. 3. Ajuste os campos abaixo — eles valem para a conta inteira. 4. Salve. 5. Para conferir a herança, abra um tipo de evento: os campos de limite mostram, como dica dentro do campo, o número que ele herdaria se ficasse vazio. Configurações & opções - Intervalo entre horários: de quanto em quanto tempo os horários são oferecidos na página pública. É independente da duração: uma consulta de 60 minutos com intervalo de 30 aparece às 09:00, 09:30, 10:00… É o campo que controla quantas opções o cliente vê. - Primeiro dia da semana: se o calendário público (e a grade de disponibilidade) começa no domingo, na segunda ou em qualquer outro dia. Só muda o enquadramento visual, nunca a disponibilidade. - Buffer antes / Buffer depois: minutos reservados automaticamente antes e depois de cada compromisso. - Antecedência mínima: com quanto tempo de aviso um horário ainda pode ser marcado. - Antecedência máxima: até quantos dias no futuro a página oferece horários. - Antecedência mínima para cancelar: com quanto tempo de aviso o cliente ainda pode cancelar — ou remarcar, que segue a mesma janela. - Impedir compromissos sobrepostos: a trava de sobreposição para compromissos criados direto na agenda (não pela página pública, que sempre teve a própria checagem). Os cinco campos de limite (buffers, antecedências e horizonte) também existem dentro de cada tipo de evento, e é lá que a herança acontece. Casos de uso - Aumentar de 15 para 30 minutos o intervalo entre horários de todos os tipos de uma vez. - Dar 10 minutos de respiro entre atendimentos na conta inteira, sem tocar em cada tipo. - Manter um único tipo "Encaixe de urgência" com antecedência mínima 0, enquanto todo o resto segue as 2 horas da conta. - Começar a semana na segunda-feira para uma operação que não atende aos domingos. Dicas, limites e boas práticas - Deixe vazio por padrão. Preencher o campo do tipo de evento com o mesmo número que a conta já usa parece inofensivo, mas congela aquele tipo: quando a conta mudar, ele fica para trás. - Se um tipo já tem um número e você quer que ele volte a seguir a conta, apague o valor ou use Usar o padrão da conta, logo abaixo do campo. - O intervalo entre horários é o campo que mais muda a percepção do cliente: intervalo curto = mais opções na tela; intervalo longo = agenda mais organizada. - A antecedência mínima para cancelar também vale para remarcações. Sem isso, bastaria remarcar para escapar da janela de cancelamento. Solução de problemas - Mudei o padrão da conta e um tipo de evento não mudou: o campo dele está preenchido. Abra o tipo e apague o valor (ou clique em Usar o padrão da conta) para voltar a herdar. - Coloquei 0 e ele voltou a usar o valor da conta: não deve acontecer — 0 é um valor válido e vence a conta. Se o campo ficou vazio depois de salvar, é porque foi salvo vazio; digite 0 de novo. - A página pública mostra menos horários do que eu esperava: aumente o intervalo entre horários ou reduza os buffers — cada minuto de buffer também consome opções. - A página pública mostra dias demais: reduza a antecedência máxima. Veja também - Tipos de evento, disponibilidade e buffers - Disponibilidade em cascata: conta, agenda e tipo de evento - Página pública de agendamento - Impedir compromissos sobrepostos
Agendar pela IA na conversa
Visão geral O agente de IA pode cuidar do agendamento dentro da própria conversa: consultar os horários livres de um tipo de evento, enviar o link para o cliente escolher, ou marcar direto o horário combinado. Ele usa exatamente as mesmas regras da página pública — disponibilidade, buffers, antecedências, trava de sobreposição e cobrança — então nada que a IA marca escapa da sua configuração. Você decide quais dessas ações o agente pode usar; nenhuma delas está ligada por padrão. Pré-requisitos - Módulo Agenda habilitado, com pelo menos um tipo de evento publicado. - Um agente de IA configurado na conta. - As ferramentas de agenda habilitadas nesse agente (elas aparecem na lista de ferramentas dele). Passo a passo 1. Abra a configuração do agente de IA e habilite as ferramentas de agenda que quiser: listar tipos de evento, consultar horários livres, enviar link de agendamento, marcar compromisso, remarcar, cancelar e ver os compromissos do contato. 2. Escolha o modo de aprovação. As ações que mexem na agenda do cliente ou mandam mensagem — marcar, remarcar, cancelar, adicionar convidado e enviar o link — pedem aprovação humana antes de executar quando o agente está no modo híbrido. 3. Na conversa, o agente pergunta o que precisa (dia, período, dados do cliente) e usa as ferramentas. 4. Você aprova a ação na própria conversa; só então ela acontece. Configurações & opções - Consultar horários livres: o agente lê os horários de um tipo de evento por janela de datas. Ele deve sempre pedir um dia (ou poucos dias) por vez — a resposta é limitada de propósito, para o agente enxergar o dia certo em vez de uma lista enorme e imprecisa. - Enviar link de agendamento: publica o link público na conversa para o cliente escolher sozinho. É a opção mais segura quando o cliente ainda está decidindo. Como manda uma mensagem visível ao cliente, passa por aprovação. - Marcar compromisso: reserva um horário pelo cliente, usando um dos horários livres lidos no passo anterior. Se o tipo de evento for pago, o agendamento entra como aguardando pagamento e a cobrança é iniciada — o cliente ainda precisa pagar para confirmar. - Remarcar / cancelar: respeitam a antecedência mínima para cancelar e o limite de remarcações do tipo de evento, iguais aos do cliente na página pública. - Ver os compromissos do contato: mostra só os compromissos do contato daquela conversa. Casos de uso - O cliente pergunta "tem horário quinta à tarde?" e o agente responde com os horários reais daquele dia. - O cliente pede para remarcar e o agente propõe as opções da semana seguinte. - O agente envia o link e deixa o cliente escolher, sem ocupar um atendente. - Antes de agendar, o agente confere se o contato já tem um compromisso marcado. Dicas, limites e boas práticas - Peça ao agente para confirmar o dia antes de consultar horários. Uma consulta ampla devolve poucos horários de muitos dias; uma consulta de um dia devolve aquele dia inteiro. - Prefira enviar o link quando o cliente ainda não decidiu, e marcar quando o horário já foi combinado por escrito na conversa. - Mantenha a aprovação humana ligada para marcar, remarcar e cancelar enquanto estiver ganhando confiança no agente: é a agenda de um cliente real do outro lado. - Um tipo de evento arquivado não aceita novos agendamentos, nem pela IA. Solução de problemas - O agente diz que não há horários: confira a disponibilidade, os buffers e as antecedências do tipo de evento — a IA lê os mesmos horários da página pública. - O agente só mostra os próximos horários e não avança de dia: peça explicitamente a data ("dia 12 de setembro"); a consulta é por janela e sem data ela cobre apenas os próximos dias. - O agendamento não confirmou: se o tipo é pago, ele fica aguardando pagamento até a cobrança ser paga. - "Horário indisponível": alguém pegou o horário entre a leitura e a confirmação. Consulte os horários de novo e escolha outro. - A ação não aconteceu: verifique se ela ficou parada aguardando aprovação na conversa. Veja também - Tipos de evento, disponibilidade e buffers - Padrões de agendamento da conta e herança - Página pública de agendamento - Reagendar, cancelar, Google Meet e arquivo .ics
Página pública de agendamento (booking)
Visão geral A página pública de agendamento é o link que você envia para clientes marcarem horário sozinhos, sem precisar trocar mensagens. Ela mostra apenas os horários livres do tipo de evento escolhido — calculados a partir da sua disponibilidade, dos seus horários ocupados (nativos e do Google) e dos buffers. O cliente escolhe um horário, responde às perguntas de triagem e confirma. Ao confirmar, a Conversa Labs pode automaticamente abrir uma conversa, criar uma tarefa com lembrete, vincular a um negócio do CRM e enviar um e-mail de confirmação com link do Google Meet e arquivo .ics — cada efeito pode ser ligado ou desligado por tipo de evento. Pré-requisitos - Módulo Agenda habilitado, com ao menos um tipo de evento e disponibilidade configurados. - Para o link do Meet automático, uma conexão Google ativa. - Para agendamentos pagos (opcional), o módulo Pagamentos ativo — nesse caso o horário fica reservado e só é confirmado após o pagamento. Passo a passo 1. Na Agenda, abra o tipo de evento que deseja publicar e copie o link público. 2. Compartilhe o link com o cliente (mensagem, e-mail, site, bio das redes etc.). 3. O cliente abre a página, escolhe data e horário entre as opções livres. 4. Se o tipo de evento oferecer mais de uma opção, ele escolhe o local do atendimento — por exemplo Google Meet, telefone, presencial ou um local personalizado. 5. Ele preenche os dados de contato — incluindo o telefone (opcional) — e responde às perguntas de triagem, se houver. 6. (Se o tipo de evento exigir pagamento) o cliente conclui o pagamento para confirmar. 7. O cliente confirma e recebe a confirmação por e-mail com os detalhes e o convite. 8. Você vê o novo agendamento na Agenda e dentro da conversa do contato. Configurações & opções - Link por tipo de evento: cada tipo de evento tem seu próprio link, com suas regras. - Perguntas de triagem: campos personalizados que o cliente responde ao agendar. Cada pergunta tem um tipo — texto curto, texto longo, lista suspensa, múltipla escolha, caixas de seleção, número, e-mail, telefone ou data — e o formulário público renderiza exatamente esse campo (listas e escolhas usam as opções que você cadastrar). No editor você pode renomear, trocar o tipo, reordenar e excluir qualquer pergunta. - Local / Google Meet: presencial, link manual ou Meet gerado automaticamente. - Endereço / instruções do local: para local presencial, telefone ou personalizado, preencha o endereço (ou o link/instruções). Ele vai para o convite, para a mensagem de confirmação, para o arquivo .ics e para o evento no Google. Meet não precisa — o link é gerado sozinho. - Escolha do local pelo cliente: quando o tipo de evento oferece duas ou mais opções de local, a página exibe um seletor para quem agenda. Se o cliente escolher Google Meet, o link da videochamada é gerado automaticamente. Com apenas uma opção, vale o local fixo do tipo de evento. - Telefone / WhatsApp: campo do formulário público. Preenchido, o cliente passa a receber a confirmação e os lembretes pelo WhatsApp; em branco, tudo continua chegando por e-mail. Você pode marcar "exigir telefone" no tipo de evento — nesse caso o agendamento só é aceito com um número válido, inclusive por quem chamar a API diretamente. - Número sempre aproveitado: o WhatsApp digitado é gravado no contato mesmo quando ele já existe. Se o contato já tiver um número diferente, o antigo é mantido como identidade e o novo fica registrado no cadastro — nada do que o cliente digita é descartado. - Convidados extras: ative para deixar o cliente incluir outras pessoas no compromisso. Você define o limite de convidados; cada um entra como participante e recebe o convite do Google. - Efeitos do agendamento: conversa, tarefa, negócio do CRM e e-mail de confirmação — por tipo. - Distribuição entre agentes: rodízio ou coletiva, quando há mais de um atendente. - Pagamento (opcional): exija pagamento para confirmar, ou apenas reserve o horário até o pagamento (depende do módulo Pagamentos). Casos de uso - Colocar o link de agendamento na bio do Instagram ou na assinatura de e-mail. - Enviar o link no meio de uma conversa de WhatsApp para o cliente marcar uma demonstração. - Receber agendamentos pagos (consultas, mentorias) com confirmação só após o pagamento. - Distribuir automaticamente os agendamentos entre os atendentes de uma equipe. Dicas, limites e boas práticas - A página é não autenticada e segura: ela mostra apenas horários livres, nunca os detalhes de outros agendamentos. - Mantenha as perguntas de triagem curtas para reduzir desistências. - O telefone é opcional, mas vale a pena: com ele o cliente recebe confirmação e lembretes pelo WhatsApp, o que reduz faltas. Sem telefone nada se perde — o e-mail continua sendo enviado. - Ofereça a escolha do local só com as opções que você realmente consegue atender: tudo o que estiver marcado no tipo de evento aparece para o cliente. - Confira o fuso horário — a página exibe os horários no fuso correto para o cliente. - Cada agendamento confirmado vira um registro completo: aproveite os efeitos (conversa, tarefa, negócio) para não perder o follow-up. Solução de problemas - A página não mostra horários: confirme disponibilidade, antecedências e buffers do tipo de evento — pode não haver janelas livres no período. - O cliente não recebeu a confirmação: confira o e-mail informado e se o envio de confirmação está ligado para aquele tipo de evento. - O agendamento não gerou conversa/tarefa/negócio: verifique se esses efeitos estão habilitados no tipo de evento. - O pagamento não confirmou o horário: confirme que o módulo Pagamentos está ativo e que o pagamento foi concluído — o horário fica reservado até a confirmação. Veja também - Visão geral de Agenda e Agendamentos - Tipos de evento, disponibilidade e buffers - Conectar o Google Calendar (OAuth) e sincronização - Reagendar, cancelar, Google Meet e arquivo .ics
Marca da página pública de agendamento (logo, cor e nome)
Visão geral A página pública de agendamento da Conversa Labs pode usar a sua marca em vez de uma aparência genérica. Você define três elementos que aparecem para o cliente antes de ele escolher um horário: - Logo — a imagem que identifica o seu negócio no topo da página. - Cor — a cor da marca aplicada aos botões e destaques da página. - Nome de exibição — o nome que o cliente vê (do negócio, do serviço ou do responsável). A personalização vale tanto para o portal de agendamento (a página que lista os seus tipos de evento) quanto para a página de um tipo de evento único (o link direto de um serviço específico). Pré-requisitos - Módulo Agenda habilitado, com ao menos um tipo de evento publicado. - Perfil com permissão para configurar a Agenda e a página pública. - Um arquivo de logo adequado (imagem nítida, fundo transparente de preferência). Passo a passo 1. Abra as configurações da Agenda e vá em Marca / Aparência da página pública. 2. Envie o logo do seu negócio. 3. Escolha a cor da marca (aplicada aos botões e destaques). 4. Defina o nome de exibição que o cliente verá. 5. (Opcional) Ajuste a marca também na página de um tipo de evento único, se quiser algo diferente do portal. 6. Salve e abra o link público para conferir como ficou para o cliente. Configurações & opções - Logo: imagem exibida no topo da página pública (portal e tipo único). - Cor da marca: define botões e destaques da página de agendamento. - Nome de exibição: o nome mostrado ao cliente (negócio, serviço ou responsável). - Escopo: portal de agendamento (lista de tipos de evento) e tipo de evento único (link direto de um serviço). Casos de uso - Enviar um link de agendamento com a cara da sua empresa, e não genérico. - Usar um logo e cor consistentes com o site e as redes sociais. - Dar a um serviço específico (ex.: "Mentoria VIP") um nome de exibição próprio no link direto. - Reforçar confiança do cliente ao ver a marca reconhecível antes de agendar. Dicas, limites e boas práticas - Use um logo nítido e, de preferência, com fundo transparente para combinar com a página. - Escolha uma cor com bom contraste para os botões continuarem legíveis. - Mantenha o nome de exibição curto e claro — é a primeira coisa que o cliente lê. - Depois de salvar, teste o link público em um celular e em um computador para ver o resultado real. - Marca é aparência: ela não altera disponibilidade, regras ou efeitos do agendamento. Solução de problemas - O logo não aparece: confirme que o upload foi concluído e que o arquivo é uma imagem válida; tente um arquivo menor ou em outro formato. - A cor não mudou na página: salve novamente e recarregue o link público; limpe o cache do navegador se necessário. - O nome de exibição está errado: verifique se você editou no escopo certo (portal ou tipo de evento único). - A página ainda parece genérica: confirme que a marca foi salva para a página que você está abrindo (o portal e um tipo único são configurados separadamente). Veja também - Página pública de agendamento - Tipos de evento, disponibilidade e buffers - Pagamento e sinal no agendamento - Visão geral de Agenda e Agendamentos
Reagendar, cancelar, Google Meet e arquivo .ics
Visão geral Depois que um agendamento é confirmado, ele não fica preso: o cliente pode reagendar ou cancelar pelos links que recebe na confirmação, e você pode gerenciar o compromisso pela Agenda. Quando o tipo de evento usa Google Meet, o link da videochamada é criado automaticamente e vai no convite. O e-mail de confirmação também traz um arquivo .ics, que adiciona o compromisso a qualquer aplicativo de calendário. Reagendamentos e cancelamentos são refletidos na plataforma e no Google Calendar (quando há conexão), mantendo tudo em sincronia. Pré-requisitos - Um agendamento já confirmado (pela página pública ou criado por um agente). - Para o link do Meet automático, uma conexão Google ativa e o tipo de evento configurado com Google Meet. - O e-mail de confirmação ativo no tipo de evento (para o cliente receber os links e o .ics). Passo a passo Reagendar (cliente): 1. No e-mail de confirmação, o cliente abre o link de reagendar. 2. Escolhe um novo horário livre dentro das regras do tipo de evento. 3. Confirma — o compromisso é movido e uma nova confirmação é enviada. Cancelar (cliente): 1. No e-mail de confirmação, o cliente abre o link de cancelar. 2. Confirma o cancelamento — o horário é liberado e as partes são avisadas. Gerenciar (agente): 1. Abra o compromisso na Agenda (ou pelo painel do contato na conversa). 2. Edite o horário, reagende ou cancele conforme necessário. Não importa como você faz: arrastando o compromisso na grade, editando a data pelo formulário do evento ou pela aba Agendar de dentro da conversa — em todos os casos o cliente recebe a mensagem padrão de remarcação (ou de cancelamento), o Google Calendar é atualizado e as automações de agenda são acionadas. Só a edição de campos que não mexem no horário (por exemplo, mudar o título) é que não avisa o cliente. 3. Para ver todos os agendamentos e copiar o link de gerenciamento de cada um, abra a lista Agendamentos no topo da Agenda. O mesmo link também aparece ao abrir o evento, no campo Link de gerenciamento. Configurações & opções - Links de gerenciamento: cada confirmação traz links seguros para reagendar e cancelar. - Lista de Agendamentos: no topo da Agenda, veja todos os agendamentos filtrando por status e período, e copie o link de gerenciamento de qualquer um para reenviar ao cliente. - Google Meet automático: ative no tipo de evento para gerar o link da videochamada em cada agendamento. - Arquivo .ics: anexado na confirmação; ao abri-lo, o compromisso é adicionado ao calendário do cliente. - Sincronização: mudanças de horário e cancelamentos se refletem no Google Calendar quando há conexão ativa. - Efeitos vinculados: conversa, tarefa e negócio do CRM acompanham o ciclo do agendamento. Casos de uso - Permitir que o cliente remarque sozinho, sem abrir um chamado ou trocar mensagens. - Enviar reuniões com link do Meet já pronto, sem criar a sala manualmente. - Garantir que o compromisso entre no calendário do cliente (Outlook, Apple, Google) via .ics. - Liberar automaticamente o horário quando um cliente cancela, deixando-o disponível para outros. Dicas, limites e boas práticas - O arquivo .ics é um formato universal e funciona em praticamente qualquer aplicativo de calendário. - Oriente o cliente a usar os links de reagendar/cancelar em vez de simplesmente não comparecer. - Reagendar respeita as mesmas regras do tipo de evento (disponibilidade, buffers, antecedência). - Se o tipo de evento não tem Google Meet automático, defina um local ou link manual para não enviar convites sem endereço de reunião. Solução de problemas - Não recebi o link do Meet: confirme que o tipo de evento usa Google Meet automático e que há uma conexão Google ativa. - O .ics não abriu o compromisso: tente abrir o anexo no aplicativo de calendário do dispositivo; alguns clientes de e-mail exigem salvar o arquivo primeiro. - Reagendei, mas o Google não atualizou: verifique se a conexão Google segue ativa; a verificação periodica reconcilia as diferenças. - O link de cancelar/reagendar não funciona: o agendamento pode já ter sido cancelado ou alterado — confira o status na Agenda. Veja também - Visão geral de Agenda e Agendamentos - Página pública de agendamento - Tipos de evento, disponibilidade e buffers - Conectar o Google Calendar (OAuth) e sincronização
Excluir ou cancelar um evento: qual usar
Visão geral Na Agenda da Conversa Labs um compromisso pode sair da sua lista de duas formas diferentes, e a escolha importa: cancelar e excluir não são a mesma coisa. - Cancelar mantém o registro do compromisso na plataforma, apenas muda o status para cancelado. O histórico continua na Agenda, o horário é liberado, as partes são avisadas e, quando há conexão Google, o evento é removido do Google Calendar (o registro cancelado permanece na plataforma para histórico). - Excluir remove o compromisso de vez: ele deixa de existir na plataforma e é apagado do Google Calendar. Não há histórico depois de excluir. A regra prática: use cancelar quando quiser manter rastro (relatórios, no-show, follow-up) e excluir apenas quando o evento foi criado por engano ou não deve deixar nenhum registro. Pré-requisitos - Módulo Agenda habilitado na conta e um compromisso já existente. - Perfil com permissão para editar/remover compromissos. - Para que o cancelamento ou a exclusão reflita no Google, uma conexão Google ativa no calendário do evento. Passo a passo Cancelar um compromisso: 1. Abra o compromisso na Agenda (ou pelo painel do contato na conversa). 2. No formulário do evento, clique em Cancelar. 3. Confirme. O status muda para cancelado, o horário é liberado e, quando há conexão Google, o evento é removido do Google Calendar (o registro cancelado permanece na plataforma). Excluir um compromisso: 1. Abra o compromisso na Agenda. 2. No formulário do evento, clique em Excluir. 3. Confirme a exclusão. O evento é removido da plataforma e do Google Calendar, sem deixar histórico. Reativar um compromisso cancelado: 1. Abra o compromisso cancelado (use o filtro Cancelados para encontrá-lo). 2. No formulário do evento, clique em Reativar. 3. O status volta para confirmado e o compromisso reaparece na visão padrão. Ver o que foi cancelado: 1. Na lista de compromissos da Agenda, use o filtro Cancelados para revisar tudo que foi cancelado (sem misturar com os ativos). Configurações & opções - Cancelar: status cancelado, mantém o registro na plataforma, libera o horário, avisa as partes e remove o evento do Google Calendar (o registro cancelado permanece na plataforma). - Excluir: remove definitivamente o evento nativo e chama a exclusão no Google Calendar (o evento é apagado nos dois lados). Sem histórico. - Filtro "Cancelados": separa os compromissos cancelados dos ativos na listagem da Agenda. - Botões: Cancelar e Excluir ficam no formulário do evento (ao abrir/editar o compromisso). Casos de uso - Cancelar: o cliente desmarcou, mas você quer manter o registro para relatório e follow-up. - Cancelar: registrar oficialmente um cancelamento e liberar o horário para outra pessoa. - Excluir: um evento foi criado por engano (horário errado, duplicado) e não deve constar em lugar nenhum. - Excluir: limpar um teste que você mesmo criou e não quer no histórico nem no Google. Dicas, limites e boas práticas - Prefira cancelar na maioria dos casos: preservar o histórico ajuda em relatórios, no-show e análise de faltas. Excluir é irreversível e não deixa rastro. - Ao excluir, o evento também some do Google Calendar — confirme que é isso mesmo que você quer antes de apagar dos dois lados. - Se o compromisso já tinha uma confirmação enviada ao cliente, cancelar dispara o aviso de cancelamento adequado; excluir simplesmente remove o evento. - Use o filtro Cancelados para auditar cancelamentos sem poluir a visão dos compromissos ativos. Solução de problemas - Cancelei, mas o Google ainda mostra o evento: o cancelamento remove o evento do Google Calendar. Se ele ainda aparece, confirme que a conexão Google segue ativa; a verificação periódica reconcilia diferenças. - Excluí, mas o evento voltou: verifique a conexão Google e se não foi recriado por uma nova sincronização de um evento ainda presente no Google — exclua também no Google, se necessário. - Não encontro um compromisso cancelado: use o filtro Cancelados na listagem da Agenda. - Não vejo os botões Cancelar/Excluir: seu perfil pode não ter permissão para remover compromissos — fale com um administrador. Veja também - Reagendar, cancelar, Google Meet e arquivo .ics - Sincronização com o Google Calendar: importar, status e reconectar - Visão geral de Agenda e Agendamentos - Efeitos do agendamento, lembretes e notificações
Agendamentos pagos: pagamento para confirmar, sinal e assinatura
Visão geral O agendamento pago conecta o módulo Agenda ao módulo Pagamentos: quando um tipo de evento exige pagamento, o horário escolhido não fica confirmado na hora. Ele entra em estado de aguardando pagamento e só vira confirmado depois que a Conversa Labs recebe a aprovação do pagamento pelo gateway. Assim você só bloqueia a agenda para quem realmente pagou. Cada tipo de evento define como o pagamento funciona: uma cobrança única para confirmar, um sinal (depósito) menor que o valor total, ou uma assinatura — exigir que o cliente já seja assinante, ou criar a assinatura no momento do agendamento. Pré-requisitos - Módulo Agenda ativo, com ao menos um tipo de evento e disponibilidade configurados. - Módulo Pagamentos ativo, com uma conexão de gateway (Asaas ou Mercado Pago). - Para assinatura, um plano de pagamento criado. - Perfil com permissão para editar tipos de evento e cobranças. Passo a passo 1. Na Agenda, abra o tipo de evento que deseja cobrar. 2. Escolha o modo de pagamento (veja a tabela abaixo): nenhum, cobrança única, exigir assinatura ou assinar ao agendar. 3. Defina o valor e a moeda. Se o tipo estiver ligado a um produto do Catálogo ou a um plano, o preço pode vir de lá. 4. (Cobrança única, opcional) defina um sinal (depósito) menor que o valor total — apenas o sinal é cobrado para confirmar; o restante você recebe manualmente ou no local. 5. Escolha as formas de pagamento aceitas: PIX, boleto e/ou cartão (link hospedado). 6. Selecione a conexão de gateway e, para assinatura, o plano. 7. Defina o modo de reserva do horário e o tempo de reserva (veja "Reserva e expiração"). 8. Salve. A partir daí, qualquer agendamento desse tipo passa a exigir pagamento. Modos de pagamento | Modo | O que faz | |---|---| | Nenhum (none) | Sem pagamento — o horário confirma na hora. | | Cobrança única (one_off) | Gera uma cobrança única; o horário confirma quando ela é paga. | | Exigir assinatura (subscription_gate) | Quem já tem assinatura ativa no plano agenda grátis; quem não tem é direcionado a pagar ou assinar. | | Assinar ao agendar (recurring) | Cria uma assinatura no gateway no momento do agendamento; a primeira cobrança confirma o horário. | Configurações & opções - Valor e moeda: o preço cobrado para confirmar. A ordem de resolução é: valor definido no tipo de evento → preço do produto do Catálogo vinculado → valor do plano. Se nada resolver, o agendamento não é criado (veja "Solução de problemas"). - Sinal (depósito): válido apenas na cobrança única; precisa ser maior que zero e menor que o valor total. Só o sinal é cobrado para confirmar — o saldo fica para receber depois. - Formas de pagamento: subconjunto de PIX, boleto e cartão. Sem seleção, usa os padrões da conta ou da conexão; por fim, PIX. - Conexão e plano: a conexão de gateway que processa a cobrança; o plano define o ciclo da assinatura. - Tempo de reserva: por quantos minutos o horário fica segurado aguardando pagamento (padrão 15). Reserva e expiração O modo de reserva decide o que acontece com o horário enquanto o pagamento não chega: - Reservar e segurar (reserve_and_hold): o horário é segurado assim que o cliente inicia o pagamento e fica indisponível para outras pessoas até um prazo (hold_expires_at). Uma varredura automática roda a cada minuto: se o prazo passar sem pagamento, ela cancela a cobrança não paga no gateway, libera o horário e marca o agendamento como expirado. - Pagar primeiro (pay_first): o horário não é segurado durante o pagamento. Quando o pagamento é aprovado, o horário é revalidado: se ainda estiver livre, o agendamento confirma; se alguém pegou o horário nesse meio-tempo, o agendamento entra em falha de pagamento e a cobrança (já paga) precisa ser reembolsada manualmente em Pagamentos. Ciclo do agendamento | Estado | Quando acontece | O que o cliente e o agente veem | |---|---|---| | Aguardando pagamento | Cobrança criada; horário em reserva (no modo "reservar e segurar"). | Cliente recebe o link/PIX; o agente vê o agendamento pendente, ainda não confirmado. | | Confirmado | Pagamento aprovado. | Dispara os efeitos do agendamento (conversa, tarefa, negócio, e-mail) e gera o link do Google Meet. | | Falha de pagamento | No "pagar primeiro", o horário foi ocupado antes da aprovação. | O horário não é mantido; é preciso reembolsar e remarcar. | | Expirado | O prazo de reserva passou sem pagamento. | A cobrança não paga é cancelada e o horário volta a ficar livre. | Casos de uso Onde funciona O pagamento para confirmar vale em todos os pontos onde um agendamento é criado: - Página pública de agendamento (booking). - Agente marcando direto na conversa. - Automação e macro. - FlowBuilder (incluindo Flows nativos do WhatsApp). - Maestro (assistente de IA). Exemplos: - Consultas e mentorias que só são confirmadas após o pagamento. - Cobrar um sinal para reduzir faltas, recebendo o restante no atendimento. - Sessões recorrentes vendidas como assinatura. - Atendimentos exclusivos para assinantes (quem é membro agenda sem pagar de novo). Dicas, limites e boas práticas - Use PIX para confirmar mais rápido; boleto pode levar dias e estourar o tempo de reserva. - Ajuste o tempo de reserva ao seu cenário: curto demais expira pagamentos lentos; longo demais segura horários ociosos. - Prefira reservar e segurar quando o horário é disputado; pagar primeiro quando você não quer bloquear a agenda antes de receber. Cancelamento e reembolso - Cancelar um agendamento pago libera o horário e remove o evento do Google, mas não reembolsa automaticamente. O reembolso é uma ação manual no módulo Pagamentos. - Reembolsar ou cancelar a cobrança de um agendamento já confirmado não cancela o compromisso sozinho — quem decide é o agente. Apenas um agendamento ainda aguardando pagamento é liberado automaticamente quando a cobrança falha, é cancelada ou reembolsada. Solução de problemas - O pagamento não confirmou o horário: confirme que a conexão de gateway está ativa e recebendo notificações (webhook). O horário só confirma quando o gateway avisa que a cobrança foi paga — a página de sucesso do pagamento, sozinha, não confirma. - O horário expirou antes de pagar: o tempo de reserva acabou. A cobrança não paga é cancelada e o horário volta a ficar livre — basta agendar de novo. Aumente o tempo de reserva se isso for frequente. - O valor não foi resolvido (erro 422): o tipo de evento não tem um preço calculável — sem valor definido, sem produto do Catálogo com preço e sem plano. Defina um valor (ou vincule um produto ou plano) para o agendamento ser criado. - No "pagar primeiro", o cliente pagou mas perdeu o horário: outra pessoa marcou o mesmo horário antes da aprovação. Reembolse a cobrança em Pagamentos e ofereça um novo horário, ou use reservar e segurar para evitar a disputa. Veja também - Página pública de agendamento (booking) - Tipos de evento, disponibilidade e buffers - Conectar um gateway de pagamento - Assinaturas e planos - Reembolsos, webhooks e relatórios
Pagamento e sinal (depósito) no agendamento
Visão geral Na Agenda da Conversa Labs, um tipo de evento pode exigir pagamento para confirmar o horário. Você escolhe entre duas formas: - Valor total — o cliente paga o serviço inteiro para confirmar. - Sinal (depósito) — o cliente paga apenas uma parte agora para garantir a vaga, e o saldo restante fica combinado para depois (por exemplo, "sinal agora, restante no local"). Enquanto o pagamento não é concluído, o horário fica reservado (não confirmado) e expira se o pagamento não chegar dentro do prazo — liberando a vaga para outra pessoa. O agendamento só dispara os efeitos (conversa, tarefa, negócio, confirmação) quando o pagamento necessário é confirmado. Pré-requisitos - Módulo Agenda habilitado e módulo Pagamentos ativo, com um gateway conectado (Asaas ou Mercado Pago). - Um tipo de evento configurado para exigir pagamento (total ou sinal). - Perfil com permissão para configurar a Agenda e os Pagamentos. Passo a passo Configurar (você): 1. Abra o tipo de evento e ative Exigir pagamento. 2. Escolha valor total ou sinal (depósito) e informe o valor do sinal, quando for o caso. 3. (Opcional) Defina o prazo de expiração da reserva enquanto o pagamento não é concluído. 4. Salve e publique o link. Agendar e pagar (cliente): 1. O cliente escolhe um horário na página pública e preenche os dados. 2. Na etapa de pagamento, ele vê a cobrança — PIX, boleto ou link/cartão, conforme o gateway. 3. O horário fica reservado enquanto o pagamento não é concluído. 4. Ao confirmar o pagamento, o agendamento passa a confirmado e dispara os efeitos. 5. No caso de sinal, o cliente vê o saldo restante a pagar depois. Configurações & opções - Modo de cobrança: valor total ou sinal (depósito) com valor parcial. - Saldo restante: no modo sinal, a diferença entre o total e o sinal fica registrada (ex.: pagar no local). - Meios de pagamento: PIX, boleto ou link/cartão, conforme o gateway conectado. - Status do pagamento: pendente/reservado → pago/confirmado (ou expirado, se o prazo passar). - Expiração da reserva: prazo para o pagamento chegar; sem pagamento, o horário é liberado. Casos de uso - Cobrar uma consulta ou mentoria inteira antes de confirmar o horário. - Cobrar apenas um sinal para reduzir faltas, deixando o restante para o dia do atendimento. - Reservar a vaga por um tempo limitado enquanto o cliente conclui o PIX. - Confirmar automaticamente o agendamento assim que o pagamento é aprovado, sem conferência manual. Dicas, limites e boas práticas - Deixe claro no nome/descrição do tipo de evento se é valor total ou sinal, para o cliente não se surpreender. - Um prazo de expiração curto libera vagas mais rápido; um prazo maior dá folga para o PIX/boleto compensar. - No modo sinal, comunique bem o saldo restante e onde/como ele será pago. - O agendamento só confirma e dispara os efeitos após o pagamento necessário — um horário reservado ainda não é um compromisso garantido. - Os detalhes de gateways, meios e reembolsos ficam no módulo Pagamentos (veja "Veja também"). Solução de problemas - O pagamento não confirmou o horário: confirme que o módulo Pagamentos está ativo, o gateway conectado e que o pagamento foi concluído — o horário fica reservado até a confirmação. - A reserva expirou: o pagamento não chegou dentro do prazo; o cliente precisa agendar novamente. - O cliente não viu a opção de pagar: verifique se o tipo de evento está com Exigir pagamento ativo e se há gateway conectado. - O saldo restante não apareceu: confirme que o tipo de evento está no modo sinal (depósito), não em valor total. Veja também - Agendamentos pagos - Página pública de agendamento - Marca da página pública de agendamento (logo, cor e nome) - Visão geral de Agenda e Agendamentos
Efeitos do agendamento, lembretes e notificações
Visão geral Quando um agendamento é confirmado (pela página pública ou criado por um agente), a Agenda da Conversa Labs pode disparar uma série de ações automáticas — os efeitos do agendamento. Cada efeito é independente e pode ser ligado ou desligado por conta ou por tipo de evento: abrir uma conversa com o contato, criar uma tarefa com lembrete, vincular ou criar um negócio do CRM, enviar um e-mail de confirmação com arquivo .ics e enviar um evento nativo de WhatsApp. Além disso, a Agenda envia lembretes antes do horário, pode marcar não comparecimento (no-show) automaticamente e gera notificações distintas: o cliente recebe a confirmação com .ics, e o agente recebe um aviso (e-mail e in-app) de novo agendamento ou de no-show, com link direto para o negócio ou o contato. Pré-requisitos - O módulo Agenda habilitado na conta e um agendamento que chegue ao estado confirmado. - Para o e-mail de confirmação (.ics) e as notificações do agente, SMTP configurado na conta. - Para o efeito conversa, ao menos uma caixa de entrada na conta (a Agenda usa a caixa atribuída ao calendário ou a primeira disponível). - Para o efeito negócio do CRM, o módulo CRM ativo e um pipeline/estágio padrão definido quando você quiser criar negócios automaticamente. - Para o efeito evento de WhatsApp, o contato precisa ter uma conversa de WhatsApp Web. - Para o link do Google Meet no convite, uma conexão Google ativa e o tipo de evento com Meet. Passo a passo 1. Abra as configurações da Agenda (engrenagem do módulo). 2. Na seção Efeitos do agendamento, ligue ou desligue cada efeito: conversa, tarefa, negócio do CRM, e-mail com .ics e evento de WhatsApp. 3. Na seção Lembretes, defina os tempos de antecedência (em minutos antes do início) e os canais (e-mail e in-app). Padrão: 60 e 1440 minutos (1 hora e 24 horas). 4. Ainda em Lembretes, defina (se desejar) o auto-no-show: minutos após o início para marcar não comparecimento. Vem desligado por padrão. 5. Para regras diferentes por serviço, repita o ajuste no tipo de evento (escopo) — ele sobrepõe o padrão da conta. 6. Crie um agendamento de teste e confirme que os efeitos e lembretes esperados aconteceram. Configurações & opções Efeitos do agendamento (cada um liga/desliga, independente): | Efeito | O que faz | Padrão | |---|---|---| | Conversa | Encontra ou abre uma conversa para o contato na caixa do calendário e vincula o agendamento a ela. | Ligado | | Tarefa | Cria uma tarefa Agendamento: <título> com vencimento no horário de início e um lembrete in-app, ligada ao contato e à conversa. | Desligado | | Negócio do CRM | Vincula um negócio aberto já existente do contato; se não houver, cria um no pipeline/estágio padrão (somente se "criar se não existir" estiver ativo). | Desligado | | E-mail + .ics | Envia a confirmação ao cliente com o anexo .ics (adiciona ao calendário) e o link do Meet no corpo. | Ligado | | Evento de WhatsApp | Envia um evento nativo de WhatsApp (só WhatsApp Web) para a conversa do contato, com o link do Meet na descrição. É gratuito — não usa modelo nem janela de 24h. Tem chave própria aqui em Efeitos do agendamento e é opt-in: vem desligado, e a Entrega não o liga (são controles independentes). Ligue-o quando quiser que o compromisso entre na agenda do celular do cliente, além do texto de confirmação. | Desligado | | Google Meet | Gera o link da videochamada para o convite. | Ligado | Lembretes: - Tempos de antecedência (lead_times): uma lista de minutos antes do início — padrão 60 e 1440. Você pode definir quantos quiser. - Canais: e-mail e in-app (padrão ambos). - Idempotência: cada lembrete dispara exatamente uma vez por agendamento — releituras da fila nunca reenviam o mesmo lembrete. - Escopo: por conta ou por tipo de evento (o tipo de evento sobrepõe o padrão da conta). Auto-no-show: - Minutos após o início para marcar não comparecimento automaticamente, se o agendamento ainda estiver confirmado. Desligado por padrão (defina um valor para ativar). - Marca o agendamento uma única vez e dispara o evento de no-show (automações/webhooks + aviso ao agente). Notificações: - Cliente: e-mail de confirmação com .ics (método REQUEST na confirmação/reagendamento, CANCEL no cancelamento) e o link do Meet. - Agente: aviso de novo agendamento e de no-show por e-mail e in-app, com link direto para o negócio do CRM (quando houver), senão o contato, senão a Agenda. Casos de uso - Transformar cada agendamento confirmado em conversa + tarefa + negócio sem trabalho manual. - Enviar a confirmação com .ics para o compromisso entrar no calendário do cliente. - Avisar o cliente no WhatsApp com um evento nativo já com data, hora e link do Meet. - Lembrar o cliente 24 horas e 1 hora antes para reduzir faltas. - Marcar no-show automaticamente e abrir um follow-up quando ninguém comparece. Dicas, limites e boas práticas - Os efeitos rodam quando o agendamento fica confirmado — um rascunho ou pendente de pagamento não dispara os efeitos ainda. - Os lembretes e o auto-no-show rodam por uma verificação periódica em segundo plano (quase em tempo real). Os lembretes são avaliados para eventos que começam nas próximas ~48 horas; o no-show, para eventos iniciados nas últimas ~24 horas. - Se você definir um lembrete cujo horário já passou no momento da reserva, ele não é reenviado — os lembretes só olham para o futuro. - O efeito negócio do CRM só cria um negócio quando "criar se não existir" está ativo e há um pipeline/estágio padrão; caso contrário, apenas vincula um negócio aberto existente. - Mantenha o SMTP configurado: sem ele, o e-mail com .ics e as notificações do agente não saem. Solução de problemas - Um efeito não disparou: confirme que ele está ligado no escopo certo (conta ou tipo de evento) e que o contato existe. A conversa precisa de uma caixa de entrada; o evento de WhatsApp precisa de uma conversa de WhatsApp Web. - O negócio do CRM não foi criado: ele só é criado com "criar se não existir" ativo e um pipeline/estágio padrão definido; sem isso, apenas um negócio aberto já existente é vinculado. - A tarefa não apareceu: verifique se o efeito tarefa está ligado e se o agendamento tem um horário de início válido. - Lembrete ausente: o agendamento precisa estar confirmado e começar dentro da janela de varredura; confirme o SMTP e que o tempo de antecedência ainda não tinha passado na reserva. - Lembrete duplicado: não deveria acontecer — cada lembrete é idempotente (uma vez por antecedência). Se notar repetição, verifique se não há dois tempos de antecedência iguais configurados. - O agente não recebeu a notificação: confirme o SMTP e que o agente tem e-mail válido; o link aponta para o negócio, senão o contato, senão a Agenda. Veja também - Visão geral de Agenda e Agendamentos - Reagendar, cancelar, Google Meet e arquivo .ics - Página pública de agendamento - Tipos de evento, disponibilidade e buffers - Conectar o Google Calendar (OAuth) e sincronização
Lembretes: tempos e mensagem (template com variáveis)
Visão geral Os lembretes avisam o cliente (e podem avisar o agente) antes do horário do compromisso. Você controla duas coisas: - Quando o lembrete sai — os tempos de antecedência (por exemplo, 24 horas e 1 hora antes do início). Você pode definir quantos quiser. - O que o lembrete diz — a mensagem (template), escrita com variáveis que a Conversa Labs substitui pelos dados reais do compromisso na hora do envio. A configuração é em cascata: você define um padrão na conta, pode sobrescrever por tipo de evento e, se precisar, ajustar direto em um evento específico. Pré-requisitos - Módulo Agenda habilitado e um agendamento que chegue ao estado confirmado. - Para o envio por e-mail, SMTP configurado na conta. Para o envio por WhatsApp, uma caixa de WhatsApp com conversa do contato (veja o artigo de entrega por canal). - Perfil com permissão para configurar a Agenda. Passo a passo 1. Abra as configurações da Agenda e vá em Lembretes. 2. Em Tempos de antecedência, informe os minutos antes do início — por exemplo 1440 (24 h) e 60 (1 h). Adicione ou remova quantos precisar. 3. Em Mensagem, escreva o texto do lembrete usando as variáveis disponíveis (veja a tabela abaixo). Ex.: Olá {{contact_name}}, seu {{title}} é em {{date}} às {{time}}. Link: {{link}}. 4. (Opcional) Para regras diferentes por serviço, abra o tipo de evento e defina ali os tempos e a mensagem — eles sobrepõem o padrão da conta. 5. (Opcional) Em um evento específico, ajuste os lembretes só para aquele compromisso. 6. Salve e crie um agendamento de teste para conferir o texto final e o horário do envio. Configurações & opções - Tempos de antecedência: uma lista de minutos antes do início. Padrão de referência: 1440 e 60 (24 h e 1 h). Cada tempo dispara uma única vez por agendamento. - Mensagem (template): o corpo do lembrete, com variáveis substituídas no envio. - Por idioma (opcional): os corpos de lembrete, confirmação, reagendamento e cancelamento — e os modelos aprovados do WhatsApp correspondentes — podem ser definidos por idioma. A configuração antiga de texto único continua funcionando sem nenhuma mudança: só preencha por idioma se você atende públicos em línguas diferentes. - Escopo (cascata): conta (padrão) → tipo de evento (sobrepõe) → evento (ajuste pontual). - Seletor {x}: em cada campo de mensagem há um seletor que insere a variável no ponto do cursor — a lista é a mesma que o envio resolve, então não existe variável "escondida". - Etiqueta "Padrão" e "Restaurar padrão": um campo vazio mostra, acima dele, o texto embutido que realmente será enviado. Depois de escrever o seu, Restaurar padrão apaga a sua versão daquele idioma (não só da tela: a remoção chega ao servidor). - Botão nativo "Gerenciar agendamento": por padrão o link de gerenciamento sai como botão no WhatsApp, em vez de uma URL solta no texto — dentro e fora da janela de 24 h. Você desliga por tipo em Entrega → Botões nativos. No WhatsApp Cloud a Meta entrega um único botão. - Rótulos auxiliares: o texto do botão e a linha acima dele também são editáveis, por idioma. - Variáveis disponíveis: | Variável | Substituída por | |---|---| | {{title}} | Título do compromisso / tipo de evento | | {{date}} | Data do compromisso (no fuso correto) | | {{time}} | Horário de início | | {{link}} | Link de gerenciamento/reunião (ex.: Google Meet ou reagendar/cancelar) | | {{location}} | Local do compromisso (presencial ou link) | | {{contact_name}} | Nome do contato/cliente | | {{host}} | Nome do responsável/atendente | | {{datetime}} | Data e hora juntas (ex.: 12/05/2026 10:00) | - Prévia e teste: a prévia mostra a mensagem renderizada por canal (o mesmo renderizador do envio) e o modelo aprovado que sai fora da janela de 24 h. O teste envia de verdade para uma conversa que você escolhe, respeitando a janela. Casos de uso - Enviar um lembrete 24 horas antes e outro 1 hora antes para reduzir faltas. - Personalizar o texto com o nome do cliente e o link da reunião já prontos. - Um tipo de evento "Consulta" com mensagem e tempos diferentes de "Demonstração". - Ajustar, em um agendamento importante, um lembrete extra sem mudar o padrão. Dicas, limites e boas práticas - Escreva o mínimo necessário e inclua sempre {{date}}, {{time}} e {{link}} — é o que o cliente mais precisa. - Digite as variáveis exatamente como na tabela (com as chaves duplas). Um nome fora da lista fica como texto literal. - Evite tempos repetidos (dois lembretes de 60 min) — cada tempo dispara uma vez. - Um tempo cujo horário já passou no momento da reserva não é reenviado: os lembretes só olham para o futuro. - Prefira ajustar no nível certo: mude a conta para valer em tudo, o tipo de evento para um serviço, o evento só para um caso pontual. Solução de problemas - O lembrete saiu com {{contact_name}} no texto: a variável foi digitada errada (espaço a mais, chave faltando) ou não existe — compare com a tabela. - Não recebi o lembrete: o agendamento precisa estar confirmado e o tempo de antecedência ainda não pode ter passado na reserva; confirme também o canal (SMTP para e-mail). - Mudei a mensagem e não surtiu efeito: verifique o escopo — um tipo de evento ou um evento pode ter um texto próprio que sobrepõe o padrão da conta. - O horário do lembrete veio deslocado: confira o fuso horário do calendário e do evento. Veja também - Entrega de lembretes por WhatsApp e e-mail (por canal) - Efeitos do agendamento, lembretes e notificações - Tipos de evento, disponibilidade e buffers - Visão geral de Agenda e Agendamentos
Relatórios e métricas da Agenda
Visão geral Os Relatórios da Agenda são o painel analítico do módulo de agendamentos da Conversa Labs. Em uma única tela, um administrador acompanha o volume de agendamentos, as taxas de no-show e cancelamento, o desempenho por tipo de evento e por agente, o lead time (quanto tempo antes as pessoas marcam), a ocupação (horas reservadas) e a saúde da sincronização com o Google Calendar. São números agregados sobre uma conta inteira (ou um calendário específico) dentro de um período que você escolhe. É a visão gerencial da Agenda — não uma lista evento a evento. Pré-requisitos - Perfil de administrador da conta. Os Relatórios são uma superfície administrativa: agentes sem privilégio de administrador não conseguem abri-los. - O módulo Agenda habilitado na conta (ele é opcional e vem desligado por padrão). - Pelo menos alguns agendamentos no período para que os números não fiquem zerados. Passo a passo 1. Abra a Agenda pela barra lateral esquerda. 2. Entre na seção Relatórios da Agenda (visível apenas para administradores). 3. Escolha o período (intervalo de datas) que deseja analisar. 4. Opcionalmente, filtre por um calendário específico. Sem filtro, o relatório cobre a conta toda. 5. Leia cada seção do painel para entender volume, taxas, desempenho e sincronização. Configurações & opções Os Relatórios trazem as seções abaixo. Cada uma é calculada sobre o período e o calendário selecionados. | Seção | O que mostra | | --- | --- | | Visão geral | Total de agendamentos e a divisão entre confirmados, cancelados, no-show e reagendados, com a taxa de cancelamento e a taxa de no-show. | | Por tipo de evento | Agendamentos por tipo de evento (ex.: "Demonstração", "Suporte"), com total, no-show e cancelados de cada tipo, ordenados do mais procurado para o menos. | | Por agente | Agendamentos por anfitrião (o agente responsável), com total e no-show de cada um — útil para comparar a equipe. Mostra os principais agentes do período. | | Taxa de no-show | Quantidade de no-show e a proporção sobre o total de agendamentos. | | Taxa de cancelamento | Quantidade de cancelamentos e a proporção sobre o total. | | Lead time médio | Tempo médio entre a criação do agendamento e o início do compromisso — indica com quanta antecedência as pessoas marcam. | | Ocupação | Horas reservadas e número de eventos ativos no período — sinal de utilização da agenda. | | Saúde da sincronização | Eventos de sincronização classificados em ok, erro e conflito, mais a data da última sincronização com o Google Calendar. | - Filtro por calendário: limita todas as seções a um calendário; sem ele, o relatório é da conta inteira. - Período: define a janela de datas considerada nas contagens e nas taxas. - Funil de pagamentos (opcional): quando o módulo Pagamentos está ativo e o tipo de evento é pago, o relatório também apresenta receita liquidada, conversão de pendente para pago e os casos expirados, falhos e estornados. Casos de uso - Medir absenteísmo: acompanhar a taxa de no-show e agir (lembretes, confirmação prévia, pré-pagamento). - Comparar agentes: ver quem recebe mais agendamentos e quem tem mais faltas, por anfitrião. - Acompanhar utilização: usar horas reservadas e número de eventos para avaliar a carga da agenda. - Monitorar a integração: checar a saúde da sincronização e a última sincronização com o Google. Dicas, limites e boas práticas - Os números respeitam o escopo escolhido: conta inteira ou um calendário, dentro da janela de datas. - Os valores são agregados (contagens, médias e taxas) — não uma lista de cada agendamento. - As taxas (no-show e cancelamento) são proporções sobre o total de agendamentos do período. - O lead time considera apenas agendamentos cujo início é posterior à criação (a antecedência real). - A ocupação soma a duração dos eventos ativos; eventos cancelados/arquivados não entram nessa conta. Solução de problemas - Não vejo os Relatórios: a seção é somente para administradores. Se você é agente comum, peça acesso a um administrador da conta. - Os números aparecem zerados: amplie o período ou remova o filtro de calendário — pode não haver agendamentos na janela selecionada. - Aparecem conflitos na saúde da sincronização: um conflito indica uma divergência entre a Conversa Labs e o Google que a verificação periódica reconcilia. Confirme que a conexão Google segue ativa e revise a última sincronização; erros recorrentes podem exigir reconectar a conta Google. Veja também - Visão geral de Agenda e Agendamentos - Conectar o Google Calendar (OAuth) e sincronização - Tipos de evento, disponibilidade e buffers - Página pública de agendamento - Reagendar, cancelar, Google Meet e arquivo .ics
Entrega de lembretes e confirmações por WhatsApp e e-mail
Visão geral A entrega de confirmações e lembretes da Agenda é ciente do canal: a Conversa Labs escolhe a melhor forma de falar com o cliente conforme onde ele está e as regras de cada canal. - E-mail: enviado sempre que houver e-mail do contato e SMTP configurado — traz os detalhes do compromisso, o arquivo .ics e os links de gerenciar (reagendar/cancelar). - WhatsApp Web: o cliente recebe um evento nativo do WhatsApp (com o link do Meet na descrição). Não há janela de 24 h nesse canal, então não é preciso modelo aprovado. - WhatsApp Cloud dentro da janela de 24h: se o cliente falou com você nas últimas 24 horas, o aviso vai como mensagem de sessão (texto livre, sem custo de modelo). - WhatsApp Cloud fora da janela de 24h: quando a janela fechou, a mensagem só sai como modelo aprovado (HSM) da API oficial — por isso você escolhe qual modelo usar. Uma única chave de WhatsApp. No painel, o WhatsApp é ligado em Entrega → Enviar no WhatsApp — não existe um segundo botão de WhatsApp nos Efeitos colaterais. Essa chave controla o aviso de texto (mensagem de sessão no Web/Cloud e o modelo aprovado fora da janela) e é opt-in, porque fora da janela de 24h ela envia um modelo pago. O evento nativo do WhatsApp Web é um objeto à parte: é gratuito, tem chave própria em Agenda › Configurações › Efeitos do agendamento e vem desligado. Esta seção de Entrega não o liga — ela governa o texto de confirmação e os lembretes. São controles independentes. Pré-requisitos - Módulo Agenda habilitado e o agendamento confirmado. - Para e-mail: SMTP configurado e e-mail no contato. - Para WhatsApp: uma caixa de WhatsApp (Web ou Cloud) e uma conversa com o contato. - Para WhatsApp Cloud fora da janela: um modelo aprovado de lembrete/confirmação. Passo a passo 1. Abra as configurações da Agenda e vá até Entrega. 2. Ative os canais desejados: Enviar por e-mail e Enviar no WhatsApp. 3. Em Caixa de entrada do WhatsApp, escolha a caixa (Web ou Cloud) usada para os avisos. 4. (WhatsApp Cloud) Em Modelos do WhatsApp Cloud, selecione o modelo aprovado de cada aviso (Lembrete, Confirmação, Reagendamento, Cancelamento) e mapeie as variáveis (nome do contato, título, data/hora). 5. Salve. A cada aviso, a Conversa Labs decide sozinha: evento nativo (Web), sessão (Cloud dentro de 24 h) ou modelo (Cloud fora da janela) — e envia o e-mail quando aplicável. 6. Faça um agendamento de teste e confira o recebimento nos canais. Por tipo de evento. A Entrega também pode ser personalizada por tipo: no tipo de evento, a seção Entrega vem como Herda o padrão da conta; ative Personalizar para usar outra caixa ou outros modelos só naquele tipo, e Voltar a herdar quando quiser desfazer. Criar um modelo de agendamento (WhatsApp Cloud) Se você ainda não tem um modelo aprovado, use + Criar modelo ao lado de cada aviso (disponível em caixas WhatsApp Cloud com o pacote de recursos de WhatsApp ativo). 1. Escolha o idioma (pt_BR, inglês ou espanhol) e confirme. 2. A Conversa Labs cria um modelo de UTILIDADE com o texto do aviso e um botão “Gerenciar agendamento” que leva o link — e envia para aprovação da Meta. 3. A aprovação é assíncrona: pode levar de alguns minutos a algumas horas. 4. Acompanhe o status na aba Modelos da caixa de entrada. Enquanto estiver Pendente, ele ainda não aparece para seleção. 5. Quando ficar Aprovado, clique em Sincronizar do WhatsApp e selecione o modelo aqui. Por que o link vai num botão? A Meta rejeita modelos cujo texto termina em variável, e links soltos no corpo têm mais chance de reprovação. Por isso o link de gerenciar fica num botão de URL, preenchido automaticamente com o link do agendamento no momento do envio. Configurações & opções | Canal / situação | Como é entregue | |---|---| | E-mail | Sempre que houver e-mail + SMTP. Inclui .ics e links de gerenciar. | | WhatsApp Web | Evento nativo do WhatsApp (com o Meet na descrição). Sem janela e sem modelo. | | WhatsApp Cloud — dentro de 24h | Mensagem de sessão (texto livre), pois há janela aberta. | | WhatsApp Cloud — fora de 24h | Modelo aprovado (HSM) com as variáveis mapeadas. | - Enviar no WhatsApp: liga os avisos no WhatsApp. O evento nativo do Web tem chave própria em Efeitos do agendamento. - Caixa de entrada do WhatsApp: define qual caixa envia os avisos do calendário. - Modelos (Cloud): um modelo aprovado por tipo de aviso, com as variáveis mapeadas. - Botão de URL: o link de gerenciar é preenchido automaticamente no envio. Casos de uso - Confirmar no WhatsApp logo após a reserva e reforçar por e-mail com o .ics. - Lembrar 24 h antes por modelo aprovado, mesmo que o cliente não fale há dias (Cloud). - Enviar o evento nativo no WhatsApp Web, que entra direto na agenda do cliente. - Usar modelos diferentes num tipo de evento específico, sem mexer no padrão da conta. Dicas, limites e boas práticas - Mantenha o e-mail ligado como rede de segurança: ele sai sempre e leva o .ics. - Para WhatsApp Cloud, tenha um modelo aprovado pronto — sem ele, o envio fora da janela de 24 h não sai (o e-mail ainda cobre o aviso). - A janela de 24h conta a partir da última mensagem do cliente; dentro dela, o texto é livre. - Modelos de UTILIDADE são os indicados para lembrete/confirmação — evite categorias de marketing. - Confira o fuso horário para que data e hora no aviso batam com o combinado. Solução de problemas - O modelo ficou como “Falha no envio”: a Meta recusou o formato. As causas mais comuns são o texto terminar em variável ou um link solto no corpo — use + Criar modelo, que já monta o formato aceito (texto + botão de URL). - Criei o modelo e ele não aparece na lista: ele só aparece depois de aprovado. Veja o status na aba Modelos e clique em Sincronizar do WhatsApp. - O lembrete não chegou no WhatsApp Cloud: provavelmente estava fora da janela de 24h e faltava um modelo aprovado selecionado/mapeado. - Só chegou o e-mail: a caixa de WhatsApp pode não estar definida, ou não há conversa com o contato. - As variáveis do modelo vieram vazias: revise o mapeamento (nome do contato, título, data/hora). Veja também - Lembretes: tempos e mensagem (template com variáveis) - Efeitos do agendamento, lembretes e notificações - Reagendar, cancelar, Google Meet e arquivo .ics - Visão geral de Agenda e Agendamentos
Mensagens agendadas: criar, gerenciar e configurar
Visão geral Mensagens agendadas permitem preparar agora um envio que acontecerá depois na mesma conversa. O módulo aceita uma mensagem única, uma sequência e recorrências no fuso escolhido. Ele usa o mesmo conteúdo e as mesmas validações de canal do envio imediato. O recurso é diferente de: - Campanhas, que distribuem conteúdo para uma audiência ou vários contatos. - Follow-up, que automatiza uma cadência de acompanhamento e suas condições. - Agenda, que gerencia compromissos. Uma mensagem agendada não cria nem altera um compromisso. Pré-requisitos - Recurso Mensagens agendadas habilitado na conta. - Uma conversa existente e um canal apto a enviar o conteúdo. - Agentes criam e gerenciam os próprios agendamentos. Para gerenciar os de outras pessoas ou alterar políticas da conta/inbox, é preciso ser administrador ou ter a permissão Gerenciar mensagens agendadas. - Antes da primeira publicação, um administrador deve completar as políticas da conta. Passo a passo 1. Abra uma conversa e escreva a mensagem normalmente. 2. Ao lado de Enviar, no cabeçalho da conversa ou no painel lateral direito, abra o ícone de calendário e escolha Agendar uma vez, Agendar uma sequência ou Agendar mensagens recorrentes. O clique principal de Enviar continua enviando imediatamente. 3. Informe nome, data, hora e selecione o fuso pela busca de cidade. Em cada mensagem, escreva o texto, arraste uma mídia/arquivo ou abra o compositor de interativos e templates disponível para o canal. Em sequências, ordene os itens e defina o intervalo de cada um. 4. Em recorrências, escolha a frequência e um término: sem término, até uma data ou por quantidade. Para um padrão especial, abra Configuração avançada e comece por um dos exemplos explicados antes de editar a regra. 5. Revise a prévia. Ela mostra bloqueios, políticas efetivas, capacidade do canal e as próximas cinco ocorrências. 6. Confirme. O rascunho da conversa só é limpo depois que a criação for aceita. 7. Para acompanhar tudo, abra Mensagens agendadas no menu principal. Para a conversa atual, use a bandeja Mensagens agendadas no painel lateral. Captura sugerida: botão dividido de envio, diálogo de prévia e módulo global com o detalhe aberto. Configurações & opções Na tela Mensagens agendadas → Configurações, selecione Padrões da conta ou Uma caixa específica. Em uma conta nova, use Aplicar configuração recomendada para preencher uma base segura e revise somente as exceções. As políticas ficam agrupadas por objetivo e podem ser buscadas pelo nome. Em cada política da caixa, escolha Usar padrão da conta ou Personalizar nesta caixa. Contadores mostram políticas personalizadas, herdadas e pendentes antes de salvar. As políticas controlam resposta do cliente, conversa resolvida, atraso de execução, tentativas após falha, retomada, horário silencioso, sobreposição, troca de Inbox, remetente, variáveis, horário de verão e limites de materialização/recuperação. A origem de cada valor fica visível. Se outra pessoa salvar primeiro, recarregue a versão atual antes de repetir a alteração. No detalhe de um agendamento você pode pausar, retomar, cancelar, arquivar, tentar novamente ou reconciliar um resultado incerto. Em uma ocorrência é possível reagendar, pular, enviar agora ou repetir. Sempre confirme o escopo: apenas esta ocorrência, esta e as próximas, ou todas as futuras. Mídias e conteúdo interativo No próprio diálogo de agendamento, use Escolher da biblioteca para reaproveitar uma mídia da conta, Enviar do dispositivo para um arquivo novo, ou arraste imagens, vídeos, áudios e documentos para a mensagem. As opções acompanham a conversa: WhatsApp Cloud mostra Templates e interativos Cloud; WhatsApp Web mostra Interativo WhatsApp Web; uma conversa em Coexistência mostra os dois compositores, claramente separados. Outros canais não recebem ações incompatíveis. Templates de conteúdo também encaminham ao compositor nativo quando o canal oferece esse recurso. Ao aplicar, a prévia mantém o tipo e o conteúdo visíveis e oferece Editar ou Substituir no compositor nativo, sem perder nome, data, fuso, recorrência ou políticas. Em uma sequência, Duplicar mensagem copia o conteúdo completo; os detalhes técnicos ficam recolhidos por padrão. Casos de uso - Confirmar um retorno combinado com o cliente para amanhã. - Enviar uma sequência curta de instruções no mesmo atendimento. - Repetir um lembrete semanal sem criar uma campanha. - Programar um template aprovado para quando a janela do WhatsApp exigir esse formato. Dicas, limites e boas práticas - O alvo é sempre uma conversa existente; o módulo não aceita audiência, segmento ou vários contatos. - Até 500 ocorrências por agenda são materializadas em uma janela de 30 dias. O restante é criado progressivamente. - Anexos ficam vinculados ao agendamento. Não apague o arquivo de origem enquanto houver envios futuros. - O canal é validado na prévia e novamente no vencimento. Desconexão, opt-out, janela fechada, template não aprovado ou permissão removida podem bloquear o envio depois da criação. - Notificações são de exceção: falha ou estado Requer atenção. Um agendamento normal não gera alerta a cada ocorrência. - Um efeito externo incerto nunca é repetido às cegas. Use Reconciliar depois de verificar o provedor. Solução de problemas - Não vejo a opção de agendar: confirme a feature da conta e sua permissão. - A prévia mostra política incompleta: um administrador precisa completar a configuração da conta ou o valor ausente no escopo indicado. - O canal aparece bloqueado: abra o detalhe do bloqueio e corrija conexão, janela, template, anexo, opt-out ou acesso do remetente. - Recebi conflito ao salvar ou executar uma ação: alguém ou um job alterou o registro. Recarregue o detalhe e repita a intenção sobre a versão atual. - A ocorrência está em Requer atenção: confirme no provedor se houve envio e use Reconciliar → Enviado, Falhou ou Cancelado. Veja também - API e MCP de mensagens agendadas - Entrega de lembretes por WhatsApp e e-mail - Referência da API (Swagger/OpenAPI)