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

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

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