Pagamentos

Visão geral de Pagamentos

Visão geral O módulo de Pagamentos transforma a Conversa Labs em um balcão de cobrança dentro do próprio atendimento. Com ele você conecta um gateway (Asaas ou Mercado Pago), cria cobranças avulsas, recorrentes ou a partir de um negócio do CRM, e envia o link de pagamento direto na conversa — com PIX (QR Code + copia-e-cola), boleto e cartão (checkout hospedado). Tudo acontece sem sair da plataforma: o cliente recebe a cobrança na mesma janela em que conversa com você, paga, e o status é atualizado automaticamente quando o gateway confirma o pagamento. Você não precisa entrar no painel do banco para acompanhar — a Conversa Labs reflete pago, vencido, reembolsado e cancelado em tempo real. Pré-requisitos - O módulo Pagamentos precisa estar habilitado para a sua conta. Ele é opcional e vem desativado por padrão — peça a um administrador ou ao operador da plataforma para ativá-lo. - Uma conta ativa em um gateway suportado: Asaas ou Mercado Pago. - Permissão de administrador para conectar o gateway e configurar webhooks. - Para cobrar a partir do CRM ou da Agenda, esses módulos também precisam estar habilitados. Passo a passo 1. Garanta que o módulo de Pagamentos esteja habilitado para a conta. 2. Conecte um gateway (Asaas ou Mercado Pago) com suas credenciais e ambiente — veja Conectar gateway. 3. Crie sua primeira cobrança (avulsa, a partir do catálogo ou de um negócio) e envie-a na conversa. 4. Acompanhe o status da cobrança: pendente, aguardando pagamento, pago, vencido ou reembolsado. 5. Para receitas recorrentes, configure assinaturas e planos. 6. Acompanhe os resultados nos relatórios (faturamento, ticket médio, MRR e churn). Configurações & opções - Gateways: conecte um ou mais gateways; cada conexão tem ambiente (produção ou sandbox) e credenciais próprias. - Métodos de pagamento: PIX, boleto e cartão via checkout hospedado. A disponibilidade de cada método depende do gateway escolhido. - Cobranças: avulsas, com itens (linhas de cobrança), descontos e ajuste de valor. - Assinaturas e planos: cobrança recorrente delegada ao gateway, espelhada na plataforma. - Reembolsos: total ou parcial, conforme o suporte do gateway. - Relatórios: faturamento por status, por gateway e por moeda, ticket médio, MRR e churn. Casos de uso - Fechar uma venda no WhatsApp e enviar o PIX na hora, com QR Code e copia-e-cola. - Cobrar um serviço a partir de um negócio ganho no CRM, sem redigitar valores. - Criar uma assinatura mensal para um cliente recorrente. - Aplicar um desconto pontual em uma cobrança antes de enviá-la. - Exigir pré-pagamento de uma reserva na Agenda (agendamento pago). Dicas, limites e boas práticas - O módulo só funciona com checkout hospedado — a plataforma nunca captura dados de cartão, o que mantém você fora do escopo PCI. - Valores são tratados em unidades maiores (reais, não centavos): R$ 49,90 é 49.90. - O webhook é a fonte da verdade do status: confie nele, não na tela de "sucesso" do checkout. - Mantenha as credenciais do gateway atualizadas; tokens expirados interrompem novas cobranças. Solução de problemas - Não vejo Pagamentos no menu: o módulo não está habilitado para sua conta ou seu perfil — fale com um administrador. - Não consigo criar cobrança: verifique se há um gateway conectado e válido. - Status não atualiza: confira a configuração do webhook na seção Reembolsos, webhooks e relatórios. Veja também - Conectar gateway: Asaas e Mercado Pago - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Descontos e ajuste de valor - Agendamento pago - Reembolsos, webhooks e relatórios

Conectar gateway: Asaas e Mercado Pago

Visão geral Antes de cobrar qualquer pessoa, você precisa conectar um gateway de pagamento. A Conversa Labs suporta Asaas e Mercado Pago. Cada conexão guarda as credenciais do gateway, define o ambiente (produção ou teste) e registra um webhook — o canal pelo qual o gateway avisa a plataforma quando uma cobrança é paga, vence ou é reembolsada. Você pode ter mais de uma conexão (por exemplo, um Asaas de produção e um Mercado Pago para outro fluxo). Cada cobrança é criada em uma conexão específica. Pré-requisitos - Módulo Pagamentos habilitado e permissão de administrador. - Uma conta no gateway escolhido: - Asaas: chave de API (API Key), obtida no painel do Asaas. - Mercado Pago: Access Token e Client Secret das suas credenciais de aplicação. - Definir o ambiente: produção (cobranças reais) ou sandbox (testes). Passo a passo 1. Abra as configurações de Pagamentos e escolha adicionar uma nova conexão. 2. Selecione o gateway: Asaas ou Mercado Pago. 3. Informe as credenciais: - Asaas: cole a API Key. - Mercado Pago: cole o Access Token (e o segredo de assinatura usado para validar o webhook). 4. Escolha o ambiente: produção ou sandbox. 5. Salve. A plataforma valida as credenciais junto ao gateway. 6. Configure o webhook: a plataforma gera a URL de notificação e o segredo de verificação. Em muitos casos o registro é automático; quando não for, copie a URL informada e cadastre-a no painel do gateway. 7. Faça um teste em sandbox (uma cobrança PIX, por exemplo) e confirme que o status muda sozinho quando o pagamento é simulado. Configurações & opções - Ambiente: produção ou sandbox por conexão. Não misture credenciais de ambientes diferentes. - Webhook: a URL é única por conexão e o gateway autentica cada notificação: - Asaas envia um token próprio no cabeçalho da requisição, comparado de forma segura ao que a plataforma guardou. - Mercado Pago assina cada notificação; a plataforma valida a assinatura antes de processar. - Diagnóstico da última conciliação: a verificação periódica compara cobranças e assinaturas com o gateway para cobrir notificações perdidas. Se algum registro falhar, o cartão da conexão em Configurações → Pagamentos → Conexões permanece em vermelho com a quantidade total e até os três primeiros identificadores externos e motivos. Os demais registros continuam sendo processados; respostas brutas, dados do cliente e credenciais nunca aparecem nesse diagnóstico. - Métodos suportados por gateway: | Recurso | Asaas | Mercado Pago | |---|---|---| | PIX | Sim | Sim | | Boleto | Sim | Sim | | Cartão (checkout hospedado) | Sim | Sim | | Parcelamento | Sim | Sim | | Assinaturas | Sim | Sim | | Planos reutilizáveis | — | Sim | | Reembolso parcial | Sim | Sim | Casos de uso - Operador que já usa Asaas conecta a chave e passa a cobrar pelo WhatsApp sem trocar de sistema. - Empresa que vende para a América Latina conecta o Mercado Pago. - Time que quer testar antes de cobrar de verdade usa o ambiente sandbox primeiro. Dicas, limites e boas práticas - Trate as credenciais como segredo: elas são armazenadas de forma cifrada e nunca aparecem de volta na tela depois de salvas. - Use sandbox para validar todo o fluxo antes de ir para produção. - A autenticação do Asaas usa um cabeçalho access_token (não Authorization: Bearer). - O Mercado Pago notifica apenas o identificador do pagamento; a plataforma consulta o gateway para ler o estado completo — isso é normal. Solução de problemas - Credenciais inválidas: confira se copiou a chave/token corretos e se o ambiente bate com o do gateway (token de teste só funciona em sandbox). - Status não atualiza: o webhook não está chegando. Confirme se a URL foi registrada no gateway e se o segredo de verificação corresponde. - Notificação rejeitada (401): assinatura/token do webhook não confere — recadastre o webhook. - A última conciliação teve falhas: anote o identificador e o motivo exibidos no cartão, valide a conexão e o ambiente e confirme se o registro ainda existe no gateway. Uma falha fica visível e não altera silenciosamente o registro local. A próxima verificação substitui o diagnóstico; o alerta desaparece somente depois de uma execução sem falhas. Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Reembolsos, webhooks e relatórios

Criar cobrança e enviar na conversa

Visão geral A cobrança é o coração do módulo. Você cria uma cobrança com valor, descrição e itens, escolhe o método (PIX, boleto ou cartão via checkout hospedado) e a envia direto na conversa. O cliente recebe um cartão de pagamento na própria janela — com QR Code e copia-e-cola do PIX, a linha digitável do boleto ou o link do checkout — e o status é atualizado quando o gateway confirma. Há três formas de partir para uma cobrança: avulsa (digita os valores), a partir do catálogo (escolhe produtos prontos) ou a partir de um negócio do CRM (reaproveita o valor já registrado). Pré-requisitos - Um gateway conectado e válido (veja Conectar gateway). - Para cobrar do catálogo, o módulo de Catálogo habilitado e produtos cadastrados. - Para cobrar de um negócio, o módulo de CRM habilitado e um negócio com valor. - Um contato com dados mínimos (nome e, idealmente, e-mail e telefone) para o cliente do gateway. Passo a passo 1. Em uma conversa, abra a ação de criar cobrança (ou crie pela área de Pagamentos). 2. Escolha a origem do valor: - Avulsa: informe valor, descrição e, se quiser, itens (linhas de cobrança). - Catálogo: selecione os produtos; o valor é somado automaticamente. - Negócio: selecione um negócio do CRM; o valor é reaproveitado. 3. Selecione o método de pagamento: PIX, boleto ou cartão (checkout hospedado). 4. (Opcional) Aplique desconto ou ajuste o valor — veja Descontos e ajuste de valor. 5. Defina o vencimento, quando aplicável. 6. Crie a cobrança. A plataforma gera o PIX (QR + copia-e-cola), o boleto (linha digitável) ou o link do checkout, conforme o método. 7. Envie na conversa: o cartão de pagamento aparece para o cliente na mesma janela. Em pagamentos PIX, o rótulo e o código aparecem separados para facilitar a leitura; mesmo um código longo permanece dentro do card. Use a ação de copiar para levar o código completo. 8. Acompanhe o status mudar de pendente para pago automaticamente quando o gateway confirmar. Configurações & opções - Métodos: PIX (QR Code + copia-e-cola), boleto (linha digitável/PDF) e cartão via checkout hospedado — a plataforma nunca pede o número do cartão. - Itens (linhas de cobrança): descreva cada produto/serviço com quantidade e valor; o total é a soma das linhas. - Vencimento: data limite para PIX/boleto. - Opções avançadas do Asaas: multa e juros em percentual e desconto por pagamento antecipado podem ser definidos na cobrança; o envio impresso pelos Correios aparece somente para boleto. Esse desconto é uma condição de pagamento; ele não substitui o desconto comercial aplicado ao valor da cobrança. Deixe multa e juros em branco para manter o padrão da conta; informe 0 para desativá-los explicitamente naquela cobrança. - Retorno do Asaas: informe uma URL HTTPS pública para levar o pagador de volta ao seu site. A opção de redirecionamento automático só é enviada quando há uma URL válida. - Checkout Mercado Pago: no cartão hospedado, escolha o limite de parcelas e, se necessário, informe URLs HTTPS separadas para pagamento aprovado, recusado e pendente. O retorno automático exige a URL de aprovado. - Gate por conexão: a tela mostra somente recursos anunciados pelo gateway escolhido. A API também recusa uma opção incompatível; esconder um campo não é a única proteção. - Marcar como pago manualmente: registre pagamentos recebidos por fora (quando o gateway suportar), para manter o histórico coerente. - Reenviar: é possível reenviar o cartão de pagamento na conversa a qualquer momento. - Dados do pagador automáticos: CPF/CNPJ e endereço vêm dos dados nativos do contato (o documento já vem preenchido para você conferir; endereço de cobrança tem prioridade sobre o principal). Preencha uma vez no contato e nunca mais redigite — veja Dados fiscais e endereço do contato. Ver detalhes e histórico Na lista de cobranças, clique no cliente para abrir o detalhe — inclusive em cobranças PIX ou lançadas manualmente, que não possuem uma página hospedada. A ação principal acompanha o que a cobrança realmente permite: copiar o código PIX, abrir boleto/checkout ou, quando o Asaas autorizar e a cobrança estiver aberta, marcar como paga manualmente com justificativa. O histórico mostra os eventos mais recentes primeiro, identifica operador ou sistema/gateway e exibe a justificativa registrada. Históricos longos são paginados; mudar de página não altera a cobrança. Use essa linha do tempo para conferir criação, atualização, pagamento, atraso, cancelamento e estorno sem depender apenas do status atual. Casos de uso - Fechar a venda no WhatsApp e mandar o PIX na hora. - Montar uma cobrança com vários itens a partir do catálogo. - Cobrar um negócio ganho no CRM sem redigitar o valor. - Oferecer ao cliente a escolha entre PIX e cartão. Dicas, limites e boas práticas - Se a rede falhar depois do envio, tente novamente pela mesma tela sem fechá-la: a tentativa mantém a mesma chave e recupera a cobrança existente em vez de cobrar o cliente duas vezes. - Valores são em unidades maiores (R$ 49,90 = 49.90); o total é a soma de preço × quantidade das linhas — nunca divida por 100. - O cartão sempre passa pelo checkout hospedado do gateway: zero dados de cartão na plataforma. - Confirme nome e contato do cliente antes de criar — o gateway usa esses dados para identificar o pagador. - Não confie na tela de "sucesso": o status real chega pelo webhook. - Use apenas URLs HTTPS públicas nos retornos. Não coloque tokens, senhas ou outros segredos nelas. Solução de problemas - Erro ao criar a cobrança: verifique se o gateway está conectado e se o contato tem os dados mínimos. - Cliente não recebeu o PIX: reenvie o cartão de pagamento na conversa. - Pago mas continua pendente: confira a configuração do webhook (veja Reembolsos, webhooks e relatórios). - Recurso indisponível (ex.: cartão): pode ser uma limitação do gateway escolhido — confira a matriz de recursos em Conectar gateway. Veja também - Visão geral de Pagamentos - Conectar gateway: Asaas e Mercado Pago - Descontos e ajuste de valor - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios

Assinaturas e planos recorrentes

Visão geral Para receitas que se repetem (mensalidades, planos de serviço, retainers), use assinaturas. Você define o valor e o ciclo (semanal, mensal, anual, etc.), e o gateway gera as cobranças recorrentes automaticamente. A Conversa Labs espelha cada cobrança gerada e o estado da assinatura (ativa, pausada, cancelada), além de alimentar os indicadores de MRR e churn nos relatórios. Você também pode usar planos locais reutilizáveis: eles guardam conexão, valor, moeda e ciclo para vários assinantes. Ao criar cada assinatura, a plataforma envia a recorrência ao gateway; ter um plano local não significa que uma entidade de plano já exista no painel do gateway. Pré-requisitos - Um gateway conectado que suporte assinaturas (Asaas e Mercado Pago suportam). - Para usar um plano reutilizável, mantenha ativa a conexão vinculada a ele. A moeda do plano deve ser a moeda de liquidação dessa conexão. - Um contato/cliente com dados válidos no gateway. Passo a passo 1. Na área de Pagamentos, escolha criar uma assinatura. 2. Selecione o gateway (a conexão) e o cliente (contato). 3. Defina o valor e o ciclo de cobrança (por exemplo, mensal). 4. Defina a data da próxima cobrança e o método (PIX, boleto ou cartão, conforme o gateway). 5. (Opcional, Asaas) Defina o máximo de cobranças ou uma data final. O ciclo bimestral também aparece quando a conexão o oferece. 6. (Opcional) Selecione um plano local. A conexão, o valor, a moeda e o ciclo são preenchidos e bloqueados para manter a assinatura coerente com o modelo escolhido. 7. Salve. O gateway passa a gerar as cobranças no ciclo definido. 8. Acompanhe cada cobrança gerada e o estado da assinatura na plataforma; o cliente recebe a cobrança normalmente. Configurações & opções - Ciclo: semanal, quinzenal, mensal, bimestral (Asaas), trimestral, semestral ou anual. A tela mostra apenas os ciclos oferecidos pela conexão. - Limites do Asaas: máximo de cobranças encerra após uma quantidade de ciclos; data final encerra no limite informado e nunca pode ficar antes da primeira cobrança. A data final também pode ser ajustada depois em Editar assinatura; o máximo de cobranças é definido na criação. - Assinatura não é parcelamento: o gateway cobra o valor uma vez em cada ciclo. Para dividir uma compra única em parcelas, crie uma cobrança avulsa no cartão. - Estado da assinatura: ativa, pausada, cancelada — refletido a partir das notificações do gateway. - Planos locais: crie um modelo uma vez e reutilize-o em várias assinaturas compatíveis. O gateway continua recebendo e executando cada assinatura. - Cancelamento: cancele a assinatura na plataforma; o gateway interrompe as próximas cobranças. - Cobranças geradas: cada ciclo vira uma cobrança espelhada, com seu próprio status. Casos de uso - Mensalidade de um serviço de assinatura. - Plano recorrente de suporte ou consultoria (retainer). - Clube/assinatura de conteúdo com renovação automática. Dicas, limites e boas práticas - Se a rede falhar ao criar, tente novamente sem fechar o formulário: a mesma operação é retomada e uma resposta incerta do gateway nunca dispara outra assinatura às cegas. - A recorrência é delegada ao gateway — ele é quem gera e cobra cada ciclo; a plataforma reflete o resultado. - Use planos locais quando muitos clientes assinam a mesma oferta — fica mais fácil manter conexão, preço, moeda e ciclo consistentes. - O MRR dos relatórios normaliza cada assinatura ativa para um valor mensal equivalente; o churn considera as canceladas no período. - Comunique claramente ao cliente o ciclo e o valor antes de ativar a assinatura. Solução de problemas - A próxima cobrança não foi gerada: confirme o estado da assinatura (pode estar pausada ou cancelada) e a configuração do webhook. - Planos não aparecem: confirme que o plano não está arquivado, que sua conexão está ativa, que suporta assinaturas e que a moeda do plano corresponde à moeda de liquidação. - Cancelei e ainda cobrou: verifique se o cancelamento foi confirmado pelo gateway; o efeito vale para os próximos ciclos. Veja também - Visão geral de Pagamentos - Conectar gateway: Asaas e Mercado Pago - Criar cobrança e enviar na conversa - Descontos e ajuste de valor - Reembolsos, webhooks e relatórios

Gerenciar planos e ofertas de pagamento

Visão geral O módulo Pagamentos possui dois catálogos reutilizáveis: - Planos guardam conexão, valor, moeda e ciclo para novas assinaturas. - Ofertas guardam preço, forma de pagamento, tipo e vínculos opcionais com conexão e produto. A tela de Ofertas é administrativa. Ela não aceita uma oferta nem cria uma cobrança sem o contexto de um contato ou de uma compra. Pré-requisitos - O recurso Pagamentos deve estar habilitado na conta. - Tenha ao menos uma conexão Asaas ou Mercado Pago ativa para criar planos. - Para vincular uma oferta, cadastre antes o produto no Catálogo. - Exclusões permanentes exigem permissão de administração de pagamentos. Passo a passo 1. No menu lateral, abra Pagamentos. 2. Acesse Planos ou Ofertas. 3. Use busca, filtros e ordenação para localizar registros. A página e os filtros ficam na URL. 4. Clique em Novo plano ou Nova oferta, preencha os campos e salve. 5. Para retirar um registro de uso, arquive-o. Abra Arquivados para restaurar ou, com a permissão necessária, excluir definitivamente. 6. Para várias linhas, selecione os registros da página e use a barra de ações em massa. Se alguma linha falhar, confira os IDs mostrados e corrija somente essas linhas. 7. Ao criar uma assinatura, selecione o plano opcional. A tela preenche e bloqueia conexão, valor, moeda e ciclo para que a assinatura corresponda ao modelo. 8. Use Exportar CSV para baixar o resultado dos filtros atuais ou, se houver seleção, somente os registros selecionados, inclusive os mantidos ao navegar entre páginas. Configurações & opções Planos O plano é um modelo local; ele não afirma que já exista como entidade no gateway. A recorrência real é criada no gateway somente quando uma assinatura começa. A moeda deve corresponder à moeda de liquidação da conexão, e os ciclos respeitam suas capacidades: por exemplo, o ciclo bimestral aparece apenas quando o gateway o oferece. Ofertas Escolha entre order bump, upsell e downsell. A conexão pode ficar como padrão da conta e o produto é opcional. Ao arquivar uma oferta, ela é desativada; ao restaurar, continua inativa até ser revisada e ativada novamente. Casos de uso - Reutilizar uma mensalidade em várias assinaturas. - Oferecer instalação, suporte prioritário ou um complemento no checkout. - Manter ofertas sazonais inativas sem perder sua configuração. - Separar ofertas por produto, conexão, tipo ou status. Dicas, limites e boas práticas - Confirme a moeda de liquidação da conexão antes de publicar preços. - Arquive antes de excluir definitivamente. A exclusão permanente não pode ser desfeita. - Restaurar uma oferta não a ativa automaticamente; revise preço, produto e conexão primeiro. - Uma ação em massa é processada registro por registro. Resultado parcial é esperado quando alguma linha viola a regra de ciclo de vida. Solução de problemas - O ciclo bimestral não aparece: a conexão selecionada não anuncia essa capacidade. - Uma forma de pagamento não aparece: ela não é suportada pela conexão escolhida. - Não consigo excluir: arquive o registro primeiro e confirme que seu perfil permite exclusão permanente. - A lista ficou vazia após filtrar: use Limpar filtros; o estado também pode ser removido da URL. - A oferta restaurada está inativa: esse é o comportamento seguro. Edite e ative depois de revisar. Veja também - Criar cobranças e enviar na conversa - Assinaturas e planos

Descontos e ajuste de valor

Visão geral Você pode reduzir o valor de uma cobrança ou assinatura aplicando descontos. O desconto pode ser por linha de cobrança (em um item específico) ou no total da transação. O valor enviado ao gateway é sempre o valor líquido — ou seja, o subtotal menos o desconto. Os provedores de pagamento não são alterados; eles só recebem o valor final já calculado. Opcionalmente, sua conta pode exigir um motivo ao aplicar desconto, para manter histórico e controle de quem deu qual abatimento. Pré-requisitos - Módulo Pagamentos habilitado e um gateway conectado. - Permissão para criar/editar cobranças e assinaturas. - Se a sua conexão exigir motivo do desconto, tenha a justificativa em mãos. Passo a passo 1. Ao criar (ou editar) uma cobrança ou assinatura, localize o campo de desconto. 2. Escolha onde aplicar: - Por item: informe o desconto na linha de cobrança correspondente. - No total: informe o desconto sobre a soma das linhas. 3. Defina o valor do desconto. 4. Se solicitado, informe o motivo do desconto. 5. Confira o valor final (subtotal − desconto) antes de salvar. 6. Salve e, no caso de cobrança, envie na conversa normalmente. Configurações & opções - Desconto por item × desconto no total: combine ambos quando precisar — o total reflete a soma dos abatimentos. - Exigir motivo do desconto: opção por conexão; quando ligada, o desconto só é aceito com justificativa. - Valor líquido: o gateway sempre recebe o valor já com o desconto aplicado; não há cálculo posterior do lado do provedor. - Relatórios: o total de descontos concedidos aparece nos relatórios de Pagamentos. Casos de uso - Conceder um desconto pontual para fechar uma venda. - Aplicar abatimento em um item específico de uma cobrança com vários produtos. - Oferecer um valor promocional em uma assinatura. - Manter rastreabilidade de quem concedeu cada desconto, exigindo motivo. Dicas, limites e boas práticas - O desconto reduz o valor líquido enviado ao gateway — confira o total antes de enviar. - Padronize os motivos de desconto para facilitar a análise nos relatórios. - Para acompanhar o impacto, use a métrica de descontos concedidos e o ticket médio nos relatórios. - Lembre-se: valores são em unidades maiores (R$ 10,00 = 10.00). Solução de problemas - Não consigo salvar sem motivo: sua conexão exige justificativa — preencha o motivo do desconto. - O total não bateu: confira se há descontos por item e no total ao mesmo tempo; o valor final é o subtotal menos a soma dos descontos. - Desconto não aparece no gateway: o provedor recebe apenas o valor líquido; o detalhamento do desconto fica na plataforma. Veja também - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios - Visão geral de Pagamentos

Condições de pagamento e simulação do parcelamento

Visão geral Uma cobrança tem mais decisões do que apenas o valor. Condições de pagamento reúne tudo o que muda quanto o cliente paga e quanto a sua empresa recebe: - Multa por atraso — cobrada uma vez, quando a cobrança vence sem pagamento. - Juros ao mês — acumulados enquanto a cobrança permanece vencida. - Desconto por antecipação — abatimento se o cliente pagar antes de uma data. - Parcelamento e quem paga os juros — a empresa absorve o custo, ou o cliente paga. E a simulação responde, antes de cobrar, as duas perguntas que importam: o cliente paga quanto por mês? e você recebe quanto? Pré-requisitos - Uma conexão de gateway ativa em Pagamentos → Configurações. - As condições dependem do gateway. O Asaas aceita multa, juros e desconto por antecipação; o Mercado Pago não expõe esses campos, então eles não aparecem em uma conexão Mercado Pago. - Parcelamento existe apenas em cobranças avulsas no cartão de crédito. Assinaturas cobram um valor por ciclo — nenhum dos dois gateways parcela uma recorrência. Passo a passo Definir o padrão da conta 1. Vá em Pagamentos → Configurações → Conexões e edite a conexão. 2. Em Juros do parcelamento, escolha quem paga: - A empresa absorve — o cliente paga o valor da cobrança dividido, e a taxa do gateway sai do seu líquido. É o comportamento padrão. - O cliente paga — as parcelas são acrescidas de juros para que você receba o valor cheio. 3. Escolhendo O cliente paga, informe a taxa mensal. Deixando em branco, usamos a tabela de taxas do próprio gateway — e a dica abaixo do campo mostra a quanto isso equivale ao mês para o parcelamento escolhido, antes de você decidir sobrescrever. 4. Salve. Toda cobrança nova passa a nascer com essa escolha — e cada cobrança pode mudá-la. Aplicar condições em uma cobrança 1. Abra Nova cobrança e escolha a forma de pagamento. 2. No bloco Opções do gateway, preencha multa, juros e desconto por antecipação. 3. Em multa e desconto, escolha entre Percentual e Valor fixo. O rótulo do campo muda junto: Multa por atraso (%) ou Multa por atraso (Valor fixo). 4. Se for cartão de crédito, escolha o número de parcelas. O bloco Simulação aparece logo abaixo. Ler a simulação O bloco mostra duas colunas: - O cliente paga — por exemplo 12x de R$ 83,08 (última de R$ 83,12) e o total. A última parcela carrega o resto da divisão; é assim que o gateway divide o valor. - Você recebe — o líquido depois da taxa do gateway, com a taxa detalhada abaixo. Quando a simulação é confirmada pelo gateway, aparece o selo Confirmado pelo gateway. Configurações e opções | Condição | Asaas | Mercado Pago | |---|---|---| | Multa por atraso (% ou valor fixo) | Sim | Não | | Juros ao mês | Sim | Não | | Desconto por antecipação | Sim | Não | | As três em assinatura | Sim | Não | | Escolher quem paga os juros do parcelamento | Sim | Não — a empresa sempre absorve | | Máximo de parcelas | 21 | 36 | | Mostrar o líquido antes do pagamento | Sim | Não | Deixar um campo em branco não é o mesmo que preenchê-lo com zero: em branco, a cobrança herda o padrão configurado no painel do gateway; com zero, ela sobrescreve esse padrão para nenhuma multa. Casos de uso - Serviço recorrente com atraso frequente: multa de 2% + juros de 1% ao mês na assinatura. Toda cobrança gerada pela recorrência herda a política. - Produto de ticket alto: 12x com o cliente paga os juros, para você receber o valor cheio. - Incentivo a pagar antes: desconto de 5% até 3 dias antes do vencimento. - Multa em reais: R$ 10,00 fixos em vez de percentual, em cobranças de valores muito diferentes. Dicas, limites e boas práticas - Uma multa ou desconto em valor fixo nunca pode ser maior que a cobrança. - Um percentual nunca passa de 100. - Se escolher O cliente paga sem taxa mensal e sem a tabela de taxas do gateway disponível, a cobrança é recusada com uma mensagem pedindo a taxa — em vez de cobrar a sua empresa em silêncio. - Ao editar uma cobrança pendente, as condições vão junto para o gateway. Limpar todos os campos remove a política da cobrança. - A simulação é uma estimativa até o selo de confirmação aparecer. Quando o gateway não informa o líquido (Mercado Pago), a tela diz isso — nunca mostramos um número estimado ali. Solução de problemas "Não foi possível calcular a simulação agora." Uma indisponibilidade momentânea do gateway. Use Tentar novamente; a cobrança pode ser criada mesmo assim. "Este gateway não informa o valor líquido antes do pagamento." Esperado no Mercado Pago. O valor que o cliente paga continua correto; o líquido só é conhecido depois da liquidação. "Não conseguimos ler a tabela de taxas desta conta no gateway agora." A leitura da tabela falhou — credencial recusada, instabilidade ou resposta inesperada do gateway. Use Ler as taxas novamente ali mesmo: nada é guardado quando a leitura falha, então o botão consulta o gateway de verdade. Salvar a conexão novamente também força uma nova leitura. As opções de multa e juros não aparecem. A conexão é Mercado Pago, que não oferece esses campos. O campo de parcelas não aparece. Parcelamento existe apenas em cartão de crédito, em cobranças avulsas. Veja também - Descontos e ajuste de valor - Criar cobrança e enviar na conversa - Assinaturas e planos - Conectar um gateway

Agendamento pago

Visão geral O agendamento pago conecta a Agenda ao módulo de Pagamentos: o cliente só confirma uma reserva depois de pagar. Quando alguém agenda um tipo de evento marcado como pago, a plataforma cria uma cobrança automaticamente (por exemplo, um PIX), segura o horário enquanto o pagamento está pendente e confirma a reserva sozinha quando o gateway avisa que foi pago. É ideal para consultas, sessões e serviços em que você quer garantir o compromisso do cliente com um pré-pagamento — reduzindo faltas e no-shows. Pré-requisitos - Módulos Agenda e Pagamentos habilitados. - Um gateway conectado e válido. - Um tipo de evento (na Agenda) configurado para cobrar — com valor e modo de pagamento. Passo a passo 1. Na Agenda, abra o tipo de evento que deve exigir pagamento. 2. Defina o modo de pagamento do tipo de evento (por exemplo, pagamento único para liberar a reserva). 3. Informe o valor da reserva e o método (PIX, boleto ou cartão, conforme o gateway). 4. Salve o tipo de evento. 5. Quando um cliente agendar esse tipo de evento, a plataforma cria a cobrança e deixa a reserva aguardando pagamento. 6. O cliente paga; o gateway notifica e a reserva passa a confirmada automaticamente. 7. Acompanhe tanto a cobrança (em Pagamentos) quanto a reserva (na Agenda). Configurações & opções - Modo de pagamento por tipo de evento: definido na Agenda (por exemplo, pré-pagamento obrigatório). - Reserva aguardando pagamento: o horário fica reservado/retido até a confirmação; reservas não pagas podem expirar conforme a regra configurada. - Confirmação automática: a reserva vira confirmada ao receber o evento de pagamento do gateway — sem ação manual. - Método de cobrança: PIX, boleto ou cartão, conforme o gateway conectado. Casos de uso - Consultório que exige pagamento antecipado de consultas. - Profissional que cobra sinal/entrada para reservar um horário. - Serviços com alta demanda em que o pré-pagamento garante o compromisso. Dicas, limites e boas práticas - Use PIX para liberar a reserva mais rápido (confirmação quase imediata). - Deixe claro na descrição do tipo de evento que o horário só é confirmado após o pagamento. - Defina um prazo razoável para a reserva pendente, evitando segurar horários por tempo demais. - A confirmação depende do webhook do gateway; mantenha-o configurado corretamente. Solução de problemas - A reserva não confirma após o pagamento: verifique o webhook do gateway (veja Reembolsos, webhooks e relatórios). - Não aparece a opção de cobrar no tipo de evento: confirme que os módulos Agenda e Pagamentos estão habilitados e que há um gateway conectado. - O horário foi liberado sem pagamento: revise o modo de pagamento do tipo de evento (deve exigir pré-pagamento). Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios

Importar histórico do gateway com segurança

Visão geral A importação de histórico traz para a Conversa Labs cobranças, vínculos de clientes e assinaturas que já existem no gateway. Cobranças criam os eventos financeiros, Pedidos e relatórios; assinaturas passam a aparecer em Pagamentos > Assinaturas; e um cliente importado só cria o vínculo técnico com um contato que já exista na conta. O processo é governado: uma prévia não grava cobranças, vínculos nem assinaturas; ela persiste somente a execução auditável e a captura usada para revisar a seleção. Uma importação real só inclui os registros que você selecionar. A plataforma nunca cria contatos ou empresas silenciosamente: uma cobrança sem correspondência exata fica bloqueada até você escolher um contato existente ou propor um novo, que só será criado depois da confirmação final. Quando a cobrança e a assinatura têm o mesmo identificador de assinatura do gateway, elas também são vinculadas entre si, mesmo que você importe uma antes da outra. Cobranças históricas não disparam mensagens ao cliente, conversões de anúncios, comissões nem webhooks de saída. Pré-requisitos - Você precisa ser administrador da conta. - A conexão do Asaas ou Mercado Pago deve estar ativa e com as credenciais verificadas. - Para cobranças do Mercado Pago, escolha uma data inicial dentro dos últimos 12 meses. A busca completa desse recurso segue essa janela móvel. - Para clientes do Mercado Pago, informe o e-mail do cliente. A API documentada desse gateway não oferece uma varredura total de clientes. - Revise o marco d'água antes de permitir adoção automática de cobranças desconhecidas por webhook. Passo a passo 1. Acesse Configurações > Pagamentos > Conexões e escolha Importar histórico na conexão desejada. Você também pode abrir a ação no estado vazio de Cobranças. 2. Em Recurso para importar, escolha Cobranças, Vínculos de clientes ou Assinaturas. As proteções de entrada e a adoção automática se aplicam somente às cobranças. 3. Para cobranças, defina o marco d'água e mantenha a adoção automática desativada, a menos que sua operação tenha uma regra clara. A opção “Somente a partir do marco d'água” exige um marco válido. 4. Informe o período e o limite de registros. Para cliente do Mercado Pago, informe também o e-mail. Selecione Gerar prévia. 5. Revise a lista detalhada. Cada cobrança mostra os dados de cliente que o gateway forneceu, o contato encontrado e o sinal exato usado na associação. Busque por identificador, referência ou cliente; combine filtros; altere a ordenação e percorra as páginas sem perder a seleção já feita em outras páginas. 6. Em uma cobrança marcada como Cliente pendente, escolha um contato existente ou proponha um novo com nome e pelo menos um identificador (e-mail, telefone ou documento). A proposta não cria nada durante a prévia. Correspondências automáticas usam somente cliente do gateway, e-mail, telefone normalizado ou documento exatos; nomes parecidos nunca bastam. 7. Use Selecionar importáveis desta página, Selecionar todos os importáveis destes filtros (quando a prévia passa de uma página) ou marque cada linha. A seleção global considera todas as páginas do recorte, mas alcança apenas registros importáveis e com cliente resolvido: uma linha ignorada, já sincronizada ou pendente nunca é marcada. Alterar um filtro limpa a seleção de propósito; mudar de página a preserva. A conexão, a execução, os filtros e a ordenação ficam na URL, por isso voltar, avançar ou reabrir o link restaura a mesma visão somente quando a conexão pertence à conta atual. 8. Selecione Importar selecionados, confira a quantidade e as resoluções de cliente na confirmação e confirme. Uma seleção vazia nunca significa “importar tudo”. Contatos propostos são criados dentro da importação confirmada; se qualquer validação falhar, a cobrança correspondente não entra sem contato. 9. Acompanhe o resultado e o histórico da conexão. Registros com falha mostram o identificador e o motivo; o sucesso nunca inclui uma linha que falhou. Configurações & opções Marco d'água e adoção automática O marco d'água limita a entrada de histórico. A adoção automática de cobranças que chegarem por webhook fica desativada por padrão. Se você a habilitar a partir do marco, a plataforma falha de forma segura quando o marco estiver ausente ou inválido. Lista da prévia A prévia é uma captura segura da mesma execução que importaria os dados, sem gravar cobranças, vínculos ou assinaturas. A lista usa paginação e totais retornados pelo servidor; o contador não é calculado apenas com a página visível. Em telas pequenas, os filtros e a ordenação abrem em um painel próprio e cada linha vira um cartão legível. Os chips mostram os filtros ativos. Limpar filtros aparece quando uma combinação não encontra resultados. Se o limite informado for atingido, a prévia avisa que foi truncada: gere outra janela em vez de presumir que todo o histórico foi lido. Registros ignorados Na prévia, use o ícone de bloqueio ao lado de um registro para ignorá-lo permanentemente e informe o motivo. A decisão é separada por cobrança, cliente ou assinatura, mesmo se o gateway reutilizar um identificador. Em Registros ignorados permanentemente, use Permitir novamente para desfazer essa decisão. Vínculos com contatos e empresas A plataforma procura primeiro correspondências exatas por cliente do gateway, e-mail, telefone normalizado, documento e CNPJ. Para uma cobrança sem contato, você precisa escolher manualmente um contato da conta ou propor a criação de um novo antes de selecioná-la. A criação é adiada até a confirmação e o vínculo manual nunca é substituído silenciosamente. Uma assinatura sem contato correspondente continua visível para futura conciliação; um cliente do diretório sem contato correspondente é ignorado, porque não há proprietário local seguro para o vínculo. Cobranças e assinaturas são conectadas somente pelo identificador exato que o gateway informa, nunca por valor, data ou nome. Casos de uso - Recuperar cobranças, Pedidos e assinaturas depois de conectar um gateway que já tinha vendas. - Construir primeiro os vínculos de clientes do Asaas e depois importar assinaturas, para aumentar a associação pelo identificador exato do gateway. - Reconstruir relatórios internos sem reenviar notificações para clientes antigos. - Excluir de forma durável uma cobrança que pertence a outra operação ou que não representa uma venda. - Importar primeiro um período pequeno, validar os resultados e repetir em janelas menores. Dicas, limites e boas práticas - Comece com uma janela curta e um limite baixo; amplie somente após conferir a prévia. - Cada prévia/importação e cada seleção explícita aceitam no máximo 5.000 registros. - A importação confirmada deve usar exatamente o mesmo tipo de recurso, período, limite e e-mail da prévia concluída. Se qualquer parâmetro mudar, gere uma nova prévia; isso vale para cobranças, clientes e assinaturas. - A seleção é obrigatória. A plataforma nunca interpreta uma seleção vazia como “importar tudo”. - A seleção sobrevive à paginação e Selecionar todos cobre todas as páginas dos filtros atuais, mas ela é limpa ao mudar busca ou filtros para impedir que uma linha invisível seja importada por engano. - Cobranças sem contato resolvido não podem ser selecionadas. Resolva cada uma manualmente; a API também bloqueia tentativas de contornar a prévia. - A lista de registros ignorados é carregada por completo em páginas internas; mais de 100 exclusões não desaparecem silenciosamente. - Clientes não usam filtro de data; eles só podem vincular um contato já existente. No Mercado Pago, a busca é sempre por e-mail. - Os totais são mostrados por moeda; não compare a soma de moedas diferentes como se fosse um único valor. - A reversão remove apenas registros locais que aquela execução criou. Ela nunca altera o gateway. - Para reverter, abra uma execução elegível no histórico, digite undo e confirme. Se uma cobrança, vínculo de cliente, assinatura, Pedido ou evento posterior tiver movimentado os dados, a reversão é recusada inteira para preservar a auditoria. A reversão remove somente registros e vínculos criados pela execução; contatos e organizações são preservados, inclusive um contato proposto e confirmado manualmente. - Execuções antigas, feitas antes da trilha de reversão, podem não ser elegíveis. Nesse caso, mantenha o histórico e faça os ajustes financeiros pela operação normal. Solução de problemas Mercado Pago pede uma data inicial Informe uma data dentro da janela de histórico suportada pelo Mercado Pago. Uma data anterior pode produzir uma visão incompleta e é recusada pela plataforma. Não consigo importar sem selecionar registros Isso é esperado. Gere a prévia, marque os registros desejados e execute a importação selecionada. Uma cobrança não pode ser selecionada porque o cliente está pendente Abra a resolução de cliente na própria linha. Escolha um contato existente ou proponha um novo com nome e e-mail, telefone ou documento. Depois de salvar a decisão, selecione a cobrança e confirme a importação. O contato novo ainda não existe até essa confirmação. O Mercado Pago pede o e-mail do cliente Isso é esperado. A busca documentada de clientes do Mercado Pago exige e-mail e não permite uma importação geral da agenda. Informe o e-mail do cliente existente que deseja vincular ou importe assinaturas, que tentam associar os dados de pagador fornecidos pelo gateway. Uma cobrança aparece como ignorada Abra Cobranças ignoradas permanentemente na mesma tela, confirme o motivo e use Permitir novamente se ela puder voltar a ser considerada. A reversão foi recusada Ocorreu movimentação posterior ou o registro não foi criado pela execução escolhida. Nenhum dado foi removido. Revise a linha do histórico, os eventos da cobrança e faça o ajuste apropriado pela operação financeira normal. Veja também - Conectar um gateway de pagamentos - Gerenciar cobranças - Reembolsos, webhooks e relatórios

Reembolsos, webhooks e relatórios

Visão geral Este artigo cobre o que acontece depois que a cobrança é enviada: como devolver dinheiro (reembolso), como o webhook mantém os status sincronizados sem você fazer nada e quais relatórios mostram a saúde financeira da operação. O webhook é o canal pelo qual o gateway avisa a plataforma a cada mudança (pago, vencido, reembolsado, cancelado). Por isso ele é a fonte da verdade: a plataforma atualiza o status da cobrança a partir do webhook, não da tela de "sucesso" do checkout. Pré-requisitos - Módulo Pagamentos habilitado e um gateway conectado com webhook configurado. - Permissão para emitir reembolsos. - Para os relatórios, ter cobranças/assinaturas registradas no período. Passo a passo Reembolsar uma cobrança 1. Abra a cobrança que deseja reembolsar (já paga). 2. Escolha reembolsar. 3. Selecione total (devolve o valor inteiro) ou parcial (informe o valor a devolver). 4. Confirme. A plataforma solicita o reembolso ao gateway. 5. Acompanhe o status mudar para reembolsado (ou parcialmente reembolsado) quando o gateway confirmar. Verificar o webhook 1. Nas configurações da conexão do gateway, confira a URL do webhook e o segredo de verificação. 2. Garanta que a URL esteja registrada no painel do gateway. 3. Faça um teste e veja o status atualizar automaticamente. Ler os relatórios 1. Abra os relatórios de Pagamentos. 2. Filtre por período. 3. Analise os indicadores (faturamento, ticket médio, MRR, churn) e os recortes por status, gateway e moeda. Configurações & opções - Reembolso total × parcial: ambos suportados pelos gateways atuais. - Webhook: autenticado por cada gateway (token no cabeçalho no Asaas; assinatura no Mercado Pago); notificações repetidas são tratadas com segurança (sem duplicar efeitos). - Indicadores dos relatórios: | Indicador | O que mostra | |---|---| | Faturamento | Total recebido no período | | Ticket médio | Valor médio por cobrança paga | | Descontos concedidos | Soma dos descontos aplicados | | Por status | Distribuição entre pago, pendente, vencido, etc. | | Por gateway | Quanto entrou por Asaas / Mercado Pago | | Por moeda | Recortes quando há mais de uma moeda | | MRR | Receita recorrente mensal das assinaturas ativas | | Churn | Assinaturas canceladas no período | Casos de uso - Devolver um valor a um cliente que desistiu (reembolso total). - Estornar parte de uma cobrança (reembolso parcial). - Acompanhar o crescimento de receita recorrente pelo MRR. - Identificar perda de assinantes pelo churn. Dicas, limites e boas práticas - Sempre confie no webhook para o status; a tela do checkout pode renderizar antes da confirmação. - O reembolso é processado pelo gateway — o prazo de devolução ao cliente segue as regras do provedor/meio de pagamento. - Acompanhe MRR e churn juntos para ter a foto real da recorrência. - Mantenha a URL do webhook acessível e o segredo de verificação correto; sem isso, os status não atualizam. Solução de problemas - Status nunca muda para pago: o webhook não está chegando ou foi rejeitado (assinatura/token incorretos) — reconfigure o webhook na conexão. - Reembolso não conclui: confirme que a cobrança estava paga e que o gateway suporta o tipo de reembolso solicitado. - Relatório vazio: verifique o filtro de período e se há cobranças no intervalo. - MRR parece incorreto: confirme os ciclos das assinaturas; o MRR normaliza cada uma para o equivalente mensal. Veja também - Visão geral de Pagamentos - Conectar gateway: Asaas e Mercado Pago - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Descontos e ajuste de valor

Configurar as mensagens de pagamento

Visão geral Os pagamentos enviam duas mensagens ao cliente: a cobrança e a confirmação de pagamento. Aqui você personaliza o corpo de cada uma por idioma, sem depender de IA. O que não personalizar continua usando a mensagem embutida da Conversa Labs. Além do corpo, você edita os rótulos auxiliares da cobrança (legendas, textos de botão, as linhas de valor e vencimento e as instruções de copiar o código) e configura, para cada tipo de mensagem e cada idioma, o modelo aprovado do WhatsApp usado quando a janela de 24h está fechada. Pré-requisitos - Pagamentos habilitado na conta e permissão de administrador. - Para configurar o envio fora da janela: uma caixa de entrada de WhatsApp Cloud com modelos aprovados na Meta. Passo a passo 1. Abra Configurações → Pagamentos → Mensagens. 2. Escolha o idioma no seletor do topo. Ele abre no idioma da conta e lista todos os idiomas habilitados na instalação (até 40), mostrando quantos já têm texto seu ("N de M idiomas com conteúdo"). 3. Escreva o corpo da cobrança e da confirmação em Markdown. Vazio = mensagem padrão do idioma (selo Padrão). 4. Use as variáveis ({x}) para inserir dados do contato, da conta e da própria cobrança. O seletor oferece apenas as variáveis que realmente resolvem naquela mensagem. 5. Abra o bloco Rótulos auxiliares para ajustar os 12 rótulos da cobrança. 6. O bloco Fora da janela de 24h (WhatsApp Cloud) aparece aberto, logo abaixo de cada tipo de mensagem. Escolha o modelo aprovado daquele tipo naquele idioma, mapeie os parâmetros {{1}}, {{2}}… e preencha o botão de link, se houver. Se ainda não houver um modelo, use Criar a partir do meu texto para gerá-lo a partir do corpo que você escreveu. 7. Confira a prévia por canal, use Enviar teste se quiser validar numa conversa real e clique em Salvar mensagens — inclusive depois de criar um modelo, porque criar o modelo não grava a configuração. Restaurar padrão remove a personalização no servidor, não só na tela. Configurações & opções Idiomas e fallback O idioma é um seletor com todos os idiomas habilitados na instalação. No envio, a Conversa Labs procura o texto nesta ordem: idioma do contato → mesmo idioma-base (pt_BR ↔ pt) → idioma da conta → mensagem padrão embutida. Rótulos auxiliares São 12 rótulos: legendas, textos de botão, as linhas de valor e vencimento e as instruções de copiar o código. Ficam num bloco recolhível e seguem as mesmas regras de idioma e de restauração do corpo. Fora da janela de 24h (WhatsApp Cloud) O bloco aparece aberto e embutido logo abaixo de cada tipo de mensagem — não é uma seção que você precisa expandir. O modelo é por tipo de mensagem e por idioma — cobrança e confirmação têm o seu, em vez de um único modelo para o módulo inteiro. Nele você tem: - Escolher o modelo aprovado entre os do catálogo. - Sincronizar da Meta e Criar a partir do meu texto ficam sempre visíveis. Quando a ação não está disponível, o botão aparece desabilitado com o motivo escrito ao lado: a caixa não é WhatsApp Cloud, a conta não tem o WhatsApp Inbox Suite, ou o seu perfil não gerencia caixas de entrada. - Sincronizar da Meta atualiza a lista de modelos aprovados. - Criar a partir do meu texto gera o modelo a partir do texto daquele tipo naquele idioma, enviando-o à Meta como modelo UTILITY, convertendo cada {{ variável }} em {{1}}, {{2}}… e já deixando o mapeamento pronto. Sem texto para gerar, o botão fica desabilitado e a tela pede para escrever o texto primeiro. - Depois do envio, o modelo ainda não está aprovado: ele aparece no seletor marcado como aguardando aprovação e só passa a entregar quando a Meta aprovar e você sincronizar. Enviar de novo com o mesmo nome substitui o rascunho pendente, em vez de falhar. - Criar o modelo não salva a configuração — clique em Salvar mensagens para gravar o mapeamento. - Mapeamento dos parâmetros {{n}} e o campo do botão de link. - Entrega: escolhe de qual caixa do WhatsApp o catálogo de modelos aprovados é consultado. O envio continua saindo pela caixa da própria conversa. Modelos cujo cabeçalho exige mídia ou uma variável não entram nesta lista — este envio não tem como preencher esse cabeçalho — e a tela informa quantos ficaram de fora. Eles continuam utilizáveis pela aba Modelos da própria caixa de entrada, com link direto a partir desta tela. Observações: WhatsApp Web (WazMeow) não tem janela de 24h (o bloco nem aparece); 360dialog pode selecionar um modelo, mas não criar; a Meta casa nome + idioma + aprovado, então um modelo no idioma errado é sinalizado na tela e seria recusado no envio. Prévia e envio de teste A prévia é renderizada no servidor, por canal, e mostra só os canais que a conta realmente tem. Também exibe o modelo resolvido para fora da janela, com os valores que cada parâmetro vai carregar. O Enviar teste manda a mensagem para uma conversa escolhida respeitando a janela de 24h: com a janela fechada e sem modelo configurado, o teste é pulado com o motivo escrito na tela. Variáveis de pagamento Além de contato, conta, conversa, caixa de entrada, agente, CRM e organização — que agora renderizam de verdade —, estas mensagens oferecem os dados da cobrança: | Variável | Substituída por | |---|---| | {{ payment.amount }} | Valor da cobrança | | {{ payment.currency }} | Moeda | | {{ payment.description }} | Descrição da cobrança | | {{ payment.status }} | Situação atual | | {{ payment.due_date }} | Data de vencimento | | {{ payment.billing_type }} | Forma de cobrança (PIX, boleto, cartão…) | | {{ payment.pay_url }} | Link de pagamento | | {{ payment.pix_payload }} | PIX copia e cola | | {{ payment.boleto_url }} | Link do boleto | | {{ payment.boleto_line }} | Linha digitável do boleto | | {{ payment.gateway }} | Gateway usado | Dicas, limites e boas práticas - Markdown por canal: anexos somem em LINE/TikTok/X; HTML some no e-mail/widget; *negrito* no WhatsApp vira um par de asteriscos. - Configure o modelo fora da janela no mesmo idioma do corpo — são pares, não uma configuração única. - Ofereça sempre um caminho de pagamento no texto: {{ payment.pay_url }}, {{ payment.pix_payload }} ou {{ payment.boleto_line }}, conforme a forma de cobrança. - Depois de "Criar a partir do meu texto", o modelo fica aguardando aprovação na Meta — use Sincronizar da Meta para ver quando ele for aprovado e passar a entregar. Solução de problemas - Saiu no padrão: o tipo estava vazio (selo Padrão) naquele idioma, ou o idioma do contato não tem texto e o fallback chegou ao padrão embutido. - Fora da janela não enviou: confirme o modelo aprovado daquele tipo naquele idioma. - O modelo aparece sinalizado: está num idioma diferente do da mensagem — troque por um aprovado no idioma certo. - "Criar a partir do meu texto" está desabilitado: o motivo aparece escrito ao lado do botão — a caixa não é WhatsApp Cloud (em 360dialog você escolhe um modelo já aprovado), a conta não tem o WhatsApp Inbox Suite, seu perfil não gerencia caixas de entrada, ou não há texto naquele tipo e idioma para gerar o modelo. - Criei o modelo, mas ele não aparece / não é usado: logo após o envio ele fica aguardando aprovação — só entrega depois que a Meta aprovar e você usar Sincronizar da Meta. E confirme que clicou em Salvar mensagens: criar o modelo não grava a configuração. - Não encontro um modelo na lista: modelos com cabeçalho de mídia ou com variável no cabeçalho não são listados aqui; use-os pela aba Modelos da própria caixa de entrada. - O envio de teste foi pulado: a conversa estava fora da janela de 24h e a mensagem não tinha modelo configurado — a tela informa o motivo. Veja também - Conectar gateways de pagamento (Asaas / Mercado Pago) - WhatsApp Inbox Suite: Templates, Flows e Chamadas

Gerenciar e conciliar cobranças

Visão geral A área de Cobranças é onde você acompanha e administra tudo o que foi cobrado. Ela tem uma lista pesquisável e paginada (busca, período de criação, status, gateway/conexão, ordenação e uma alternância para mostrar as arquivadas), ações por linha em cada cobrança (ver, editar, corrigir cliente e vínculos, enviar na conversa, reembolsar, marcar como pago, cancelar, arquivar, restaurar, excluir) e uma barra flutuante de ações em lote que aparece quando você seleciona várias cobranças de uma vez. O objetivo é a conciliação: deixar o status de cada cobrança coerente com a realidade — refletindo o que o gateway confirmou e também os pagamentos recebidos por fora da plataforma. Pré-requisitos - Módulo Pagamentos habilitado e ao menos um gateway conectado (veja Conectar gateway). - Cobranças já criadas (veja Criar cobrança e enviar na conversa). - Para excluir definitivamente e para as ações em lote financeiras, é necessária permissão de administrador. Passo a passo 1. Filtrar e abrir uma cobrança 1. Abra a área de Pagamentos → Cobranças. 2. Pesquise por descrição, identificador do gateway/referência externa, nome/e-mail do cliente ou nome da conexão. Combine com status, conexão e o período de criação no fuso da conta. 3. Ordene por criação, vencimento, valor, status ou descrição; ative arquivadas para ver a lixeira. Cada controle ativo aparece como um marcador removível, e a URL preserva página, filtros e ordenação para voltar ou compartilhar a mesma visão. 4. Clique na cobrança para abrir os detalhes. A ação principal respeita o artefato disponível: página hospedada, boleto ou PIX copia e cola — uma cobrança manual continua auditável mesmo sem link. 5. Use Exportar CSV para baixar todo o recorte filtrado, sem limitar à página visível. Se houver cobranças selecionadas, o arquivo contém somente essa seleção. Em telas pequenas, os filtros ficam no painel Filtros e cada cobrança vira um cartão legível, sem tabela horizontal. 2. Ver a linha do tempo de status (auditoria) 1. Nos detalhes da cobrança, abra a aba de linha do tempo. 2. Cada evento (criada, paga, reembolsada, cancelada, atualizada) é registrado de forma imutável, com o agente responsável, o horário e a justificativa informada — é o histórico financeiro auditável da cobrança. 3. Corrigir cliente e vínculos sem editar os fatos financeiros 1. Na linha ou nos detalhes, use Corrigir cliente e vínculos da venda quando o contato estiver ausente ou errado, inclusive em uma cobrança paga que não pode mais ser editada. 2. Escolha um contato existente ou proponha um novo com nome e pelo menos e-mail, telefone ou documento. Revise também pedido, recuperação, organização, negócio e conversa alcançados pela mesma venda. 3. Gere a prévia e confira conflitos, histórico e eventual impacto em vendedor/afiliado. Alterações de crédito ou comissão exigem confirmação explícita. A aplicação é transacional e auditada. 4. Essa ação nunca muda valor, status, liquidação, vencimento nem identificador do gateway. Para esses fatos, use a operação financeira correspondente ou corrija a origem. 4. Marcar como pago manualmente (e desfazer) 1. Para um pagamento recebido por fora (dinheiro, PIX direto na conta), use Marcar como pago. 2. Informe a justificativa (obrigatória) — ela fica gravada no evento de auditoria. 3. A cobrança passa a paga. Disponível apenas para cobranças ainda em aberto (pendente, aguardando pagamento ou vencida) e em gateways que suportam baixa manual. 4. Para reverter, use Desfazer baixa manual — só funciona em uma cobrança que você mesmo liquidou manualmente; ela volta para pendente/vencida. 5. Cancelar (em aberto) × reembolsar (paga) 1. Use Cancelar cobrança quando a cobrança ainda estiver em aberto (não paga): o cliente não conseguirá mais pagá-la. 2. Use Reembolsar quando a cobrança já estiver paga: escolha total (devolve tudo) ou parcial (informe o valor). Você pode reembolsar parcialmente mais de uma vez, até o total. 3. Em ambos é possível registrar um motivo, que fica na auditoria. 6. Reenviar na conversa 1. Use Enviar para a conversa e informe a conversa de destino. 2. O cartão de pagamento volta a aparecer para o cliente na própria janela do atendimento. 7. Arquivar → restaurar → excluir definitivamente 1. Arquivar tira a cobrança da lista padrão sem apagá-la (vai para a lixeira de arquivadas). 2. Restaurar traz a cobrança arquivada de volta para a lista ativa. 3. Excluir definitivamente apaga de vez — só é permitido em cobranças arquivadas e não liquidadas; cobranças pagas/reembolsadas são mantidas para auditoria e nunca podem ser apagadas. 8. Ações em lote 1. Selecione várias cobranças; a barra flutuante aparece com a contagem. 2. Na lista ativa (admin): marcar como pago, cancelar e reembolsar (apenas total), além de arquivar. 3. Na lista de arquivadas: restaurar e excluir definitivamente (admin). 4. Todas as ações em lote são best-effort: o resultado informa quantas foram processadas e lista os IDs que falharam. Somente as falhas continuam selecionadas para revisão ou nova tentativa; nenhum item pedido desaparece silenciosamente do resultado. Configurações & opções - Ação por linha × em lote: a mesma operação existe individualmente em cada cobrança e em lote sobre a seleção. - Permissões: excluir definitivamente e as ações financeiras em lote (marcar como pago, reembolsar, cancelar) e a exclusão em lote são restritas a administradores. - Reembolso em lote = só total: o reembolso parcial existe apenas como ação por linha. - Excluir exige arquivar antes: a exclusão permanente é sempre uma ação deliberada em duas etapas (arquivar e só então excluir). - Exportação: respeita busca, período, filtros e a seleção corrente; dados textuais são protegidos para não serem interpretados como fórmulas pela planilha. - Editar × corrigir vínculos: editar continua sujeito ao status e às regras do gateway. Corrigir vínculos é uma operação separada, inclusive para liquidadas, e atua somente nas associações da venda. Casos de uso - Conciliar um PIX pago por fora: marque a cobrança como paga com a justificativa, mantendo o histórico coerente. - Limpar cobranças de teste: arquive em lote e, em seguida, exclua definitivamente as arquivadas. - Estornar em massa: selecione as cobranças pagas e reembolse em lote (total). Dicas, limites e boas práticas - Cancelar só vale para cobranças em aberto; para uma cobrança paga, o caminho é o reembolso. - O reembolso depende do gateway — o tipo (total/parcial) e o prazo de devolução seguem as regras do provedor e do meio de pagamento. - O webhook continua sendo a fonte da verdade: a baixa manual serve para o que foi pago por fora; os pagamentos do próprio gateway chegam e atualizam o status sozinhos. - Desfazer baixa manual só funciona no que você liquidou manualmente — não é o caminho para reverter um pagamento real do gateway (use o reembolso). - Se o valor está correto, mas o cliente, pedido ou evento de recuperação está errado, use Corrigir cliente e vínculos; não cancele nem reembolse apenas para consertar uma associação. Solução de problemas - "Não consigo excluir": a cobrança precisa estar arquivada primeiro; e cobranças pagas/ reembolsadas nunca são excluídas (ficam para auditoria). Arquive-a em vez de tentar apagar. - "Desfazer indisponível": a baixa manual só pode ser desfeita pela mesma origem — apenas uma cobrança que você marcou como paga manualmente (em gateway compatível) pode ser revertida. - "Marcar como pago indisponível": a cobrança não está em aberto ou o gateway não suporta baixa manual. - "Editar está indisponível em uma cobrança paga": os fatos liquidados são imutáveis. Para corrigir apenas cliente, organização, negócio ou conversa, use Corrigir cliente e vínculos da venda. - Ação em lote ignorou cobranças: é o comportamento esperado — inelegíveis (status incompatível ou gateway sem o recurso), IDs ausentes e itens fora da visão permitida aparecem como não processados e permanecem selecionados para revisão. - A lista não carregou: use Tentar novamente; se ainda falhar, revise a conexão com o servidor. Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Reembolsos, webhooks e relatórios - Conectar gateway: Asaas e Mercado Pago

Ofertas: order bump, upsell e downsell

Visão geral Uma oferta é um preço reutilizável que você cadastra uma vez e reaproveita em várias vendas. Existem três tipos: - Order bump: aparece no checkout como uma oferta-relâmpago e, quando aceita, entra como uma linha extra na cobrança que está sendo criada. - Upsell: oferta pós-compra de um clique, normalmente um item de maior valor, que gera uma nova cobrança para o contato. - Downsell: também pós-compra de um clique, usada como alternativa mais barata quando o cliente recusa o upsell — igualmente gera uma nova cobrança. Em todos os casos a oferta guarda nome, valor, moeda e método; você só a vincula a uma venda ou contato no momento certo. Pré-requisitos - Um gateway conectado e válido (veja Conectar gateway). - Opcional: um produto do Catálogo vinculado à oferta (catalog_product_id), para reaproveitar o cadastro do produto. - Defina na oferta a conexão (gateway) e o método (billing_type) que serão usados quando ela virar cobrança — especialmente para upsell e downsell. - Para aceitar uma oferta (upsell/downsell), o contato precisa de dados mínimos (nome e, idealmente, e-mail/telefone) para o pagador no gateway. Como funciona - Order bump no checkout: a oferta é convertida em uma linha de cobrança (nome, valor e moeda são "fotografados" no momento). Ela soma ao total somando uma nova linha — nunca altera o valor de uma cobrança já existente. A linha guarda apenas a referência da oferta nos metadados. - Upsell / downsell pós-compra: ao aceitar a oferta para um contato, a plataforma cria uma nova cobrança reaproveitando a conexão, o valor e os dados do pagador já conhecidos — sem redigitar nada. Essa cobrança segue o fluxo normal (gateway → webhook → cartão de pagamento na conversa), exatamente como qualquer outra cobrança. - A oferta nunca é alterada quando é aceita: ela é um modelo; cada aceite gera uma cobrança nova e independente. - O aceite pós-compra só funciona para uma oferta ativa e não arquivada. Um order bump pertence ao checkout e é recusado nessa ação. Repetir a mesma tentativa de rede recupera a mesma cobrança. Configurações & opções Campos de uma oferta: | Campo | Para que serve | |---|---| | Nome | Identifica a oferta e vira a descrição da cobrança/linha. Obrigatório. | | Tipo (kind) | order_bump, upsell ou downsell. | | Valor | Preço da oferta (unidades maiores, ex.: 49.90). Precisa ser maior que zero. | | Moeda | Código de 3 letras (ex.: BRL). | | Método (billing_type) | PIX, boleto ou cartão usado quando a oferta virar cobrança. | | Conexão | O gateway (conexão de pagamento) usado para cobrar. | | Produto do catálogo | Vínculo opcional a um produto do Catálogo. | | Descrição | Texto auxiliar da oferta. | | Ativa / inativa | Ofertas inativas não são oferecidas. | Passo a passo 1. Na área de Pagamentos, abra Ofertas e crie uma nova oferta. 2. Informe nome, escolha o tipo (order bump, upsell ou downsell), o valor e a moeda. 3. Defina o método e a conexão (gateway) que serão usados ao gerar a cobrança. 4. (Opcional) Vincule um produto do catálogo e escreva uma descrição. 5. Salve. A oferta fica disponível enquanto estiver ativa. 6. Para aplicar um order bump, use a oferta no checkout: aceita pelo cliente, ela vira uma linha extra na cobrança. 7. Para aceitar um upsell/downsell, dispare o aceite da oferta para o contato (opcionalmente ligado a uma conversa): a plataforma gera uma nova cobrança e a envia na conversa. 8. Para desativar uma oferta, arquive-a — ela some das ofertas disponíveis, mas o preço é preservado (nunca apagamos um preço que um funil ativo possa referenciar). Casos de uso - Aumentar o ticket com um order bump no checkout ("adicione a garantia estendida por R$ 19,90"). - Oferecer um upsell logo após a compra ("leve a versão Pro com 1 clique"). - Recuperar a venda com um downsell quando o cliente recusa o upsell mais caro. - Reutilizar a mesma oferta em várias conversas e checkouts, sem recadastrar o preço. Dicas, limites e boas práticas - O order bump não altera uma cobrança já criada — ele apenas adiciona uma linha ao total no momento do checkout. - Aceitar upsell/downsell sempre cria uma cobrança nova e independente; a oferta original permanece intacta. - Ofertas são arquivadas, não apagadas — assim nenhum funil ou histórico que dependa daquele preço quebra. - Defina conexão e método na oferta de upsell/downsell: sem eles, o aceite não consegue gerar a cobrança corretamente. - Valores são em unidades maiores (R$ 49,90 = 49.90); o total do checkout é a soma das linhas — nunca divida por 100. Solução de problemas - A oferta não aparece: confira se ela está ativa e não arquivada (ofertas inativas ou arquivadas não são oferecidas). - O aceite falhou: verifique se o contato tem os dados mínimos e se a conexão (gateway) da oferta é válida — o aceite cria uma cobrança real e precisa desses dados. - O valor saiu errado no order bump: lembre que ele soma uma linha ao total; ele não substitui nem reduz o valor das demais linhas. - Não consigo excluir uma oferta: ofertas são arquivadas (reversível) e não removidas — use o arquivar. Veja também - Criar cobrança e enviar na conversa - Conectar gateway: Asaas e Mercado Pago - Catálogo nativo de produtos e serviços