Tema
Stripe nas automações
Com a extensão Stripe conectada, a barra lateral do editor ganha o grupo Stripe, com quatro nós, e o grupo Gatilhos ganha o gatilho Pagamento no Stripe. Sem a extensão, nada disso aparece.
Para o atendente cobrar um valor combinado na conversa, sem fluxo, existe também o botão Cobrar do Chat; veja Botão Cobrar ou nó Cobrança no Stripe?
Todos os nós agem sobre o cliente do Stripe do contato da conversa: o Columba o localiza pelo vínculo já gravado, pelo telefone ou pelo e-mail, guarda o vínculo e, nos nós seguintes e nas próximas conversas, não repete a busca. Nenhum nó derruba o atendimento: qualquer falha sai pela saída Erro, com o motivo em texto em {{flow.stripe_error}} e o código em {{flow.stripe_error_code}}.
Conecte a saída Erro
Em fluxos de cobrança, ligue a saída Erro a um Notificar Equipe ou a um Transferir Humano. Sem isso, uma chave revogada, um valor inválido ou o Pix desativado passariam em silêncio e o cliente ficaria sem o link de pagamento. Na primeira falha de cada execução, o Columba também avisa no sino.
Os códigos mais comuns em {{flow.stripe_error_code}}, úteis numa Condição:
| Código | O que aconteceu |
|---|---|
not_connected | A extensão Stripe não está conectada (ou foi desconectada). |
plan_required | A conta não está no plano Profissional ou superior. |
authentication | O Stripe recusou a chave (revogada ou expirada). |
permission_missing | A chave restrita não tem a permissão que o nó usa. Veja a tabela de permissões. |
ambiguous_customer | Dois clientes diferentes no Stripe têm o telefone do contato. |
invalid_amount | Valor vazio, ilegível ou abaixo do mínimo do Stripe (R$ 0,50). |
payment_method_unavailable | Um método fixado no nó (por exemplo, Pix) não está ativo na conta Stripe. |
api_error | Outra falha do Stripe ou de rede. |
Outros códigos podem vir do próprio Stripe, como resource_missing quando a cobrança informada não existe.
Gatilho: Pagamento no Stripe
Dispara quando, na sua conta Stripe, um pagamento é confirmado, uma cobrança falha ou expira, uma fatura vence, uma renovação se aproxima, uma assinatura muda ou há reembolso ou disputa. O contato é resolvido pelo cliente do Stripe e o fluxo começa com os dados do evento em {{stripe.*}}.
Quando usar: agradecer e mover o negócio para Ganho assim que o pagamento entra; mandar a 2ª via quando a fatura vence; avisar o cliente quando o cartão é recusado na renovação; etiquetar o contato quando a assinatura é cancelada; avisar a equipe de um reembolso ou contestação.
Configuração:
| Campo | O que é |
|---|---|
| Eventos | Quais grupos disparam: Pagamento confirmado, Cobrança falhou ou expirou, Fatura venceu, Renovação próxima, Assinatura mudou e Reembolso ou disputa. Nenhum marcado = só pagamento confirmado. Só chegam os grupos ligados em Extensões › Stripe › Notificações. |
| Tipo de cobrança | Qualquer (padrão), Link de pagamento, Fatura ou Assinatura. |
| Só cobranças criadas pelo Columba | Ligado (padrão): só eventos de cobranças geradas pelo Columba, pelos nós ou pelo botão Cobrar da conversa. Desligado: toda cobrança da conta Stripe, inclusive as feitas no Dashboard, por outros sistemas e pelas assinaturas do Stripe. |
| Valor mínimo | Em reais (ex.: 50,00). Vazio = qualquer valor. |
| Canal | WhatsApp: abre (ou reaproveita) a conversa e o fluxo fala com o contato. Sem canal: roda só ações internas (tags, ficha, funil, tickets, avisos), sem conversa. |
| Número de WhatsApp | Com canal WhatsApp, por qual número a conversa nasce. Vazio = número padrão das Notificações da extensão (ou o primeiro número conectado). |
| Criar contato | Cria o contato no Columba quando o cliente do Stripe ainda não existe aqui, pelo telefone dele. Vazio = o padrão das Notificações da extensão. |
| Tags do contato | Aplicadas ao contato criado. |
| Com fluxo em andamento | Reiniciar (padrão) interrompe o fluxo atual daquela conversa; Ignorar mantém o que estava rodando e só registra o evento. |
Regras:
- O contato é encontrado nesta ordem: pelos ids do Columba gravados na cobrança (toda cobrança criada pelo nó Cobrança no Stripe ou pelo botão Cobrar da conversa os carrega), pelo vínculo cliente ↔ contato já gravado e, por fim, pelo telefone do cliente no Stripe. Sem nenhum deles, o evento fica registrado no painel do gatilho ("último evento") e o fluxo não roda.
- Assinaturas não nascem nos nós do Columba. Para Renovação próxima, Assinatura mudou e faturas de mensalidade geradas pelo Stripe, desligue Só cobranças criadas pelo Columba; o contato é então encontrado pelo telefone do cliente no Stripe.
- Conversa em atendimento humano nunca é interrompida.
- Um evento que o Stripe reenviar é ignorado: cada evento roda uma vez.
- Eventos do modo de teste e de produção nunca se misturam: cada chave conecta um modo da conta.
API Oficial e a janela de 24 horas
Fluxos iniciados por evento do Stripe (fatura vencida, renovação próxima) costumam falar com o contato fora da janela de 24 horas. Em números da API Oficial, configure o modelo de fallback no Enviar Texto, senão a mensagem não sai. Veja Janela de 24 horas e modelo de fallback.
Variáveis:
| Variável | Valor |
|---|---|
{{stripe.event}} | O grupo: payment_succeeded, payment_failed, invoice_overdue, invoice_upcoming, subscription_changed ou refund |
{{stripe.type}} | O tipo do evento como o Stripe o chama (ex.: invoice.paid) |
{{stripe.kind}} | checkout, invoice ou subscription |
{{stripe.object.id}} | Id da cobrança (cs_… no link de pagamento, in_… na fatura) |
{{stripe.object.status}} | Situação da cobrança |
{{stripe.object.amount}}, {{stripe.object.amount_formatted}} | Valor em centavos e já formatado ("R$ 150,00") |
{{stripe.object.currency}} | Moeda (brl) |
{{stripe.object.url}} | Página de pagamento (na fatura, a 2ª via) |
{{stripe.object.pdf}} | PDF da fatura |
{{stripe.object.description}} | O que foi cobrado |
{{stripe.object.due_date}}, {{stripe.object.paid_at}} | Vencimento (faturas, AAAA-MM-DD) e quando foi pago |
{{stripe.object.due_date_formatted}}, {{stripe.object.expires_at_formatted}} | Os mesmos prontos para a mensagem: "30/11/2026" e "03/11 às 15:00" |
{{stripe.object.payment_method}} | pix, card ou boleto, quando o Stripe informa |
{{stripe.object.payment_method_label}} | O mesmo meio em português, pronto para a mensagem: "Pix", "cartão" ou "boleto" |
{{stripe.customer.id}}, {{stripe.customer.name}}, {{stripe.customer.email}}, {{stripe.customer.phone}} | O cliente no Stripe |
{{stripe.subscription.id}}, {{stripe.subscription.status}}, {{stripe.subscription.current_period_end}}, {{stripe.subscription.plan_name}} | A assinatura, quando o evento envolve uma |
{{stripe.livemode}} | true em produção, false no modo de teste |
Cliente no Stripe
Localiza o cliente do contato na conta Stripe ou cria um novo, sem duplicar, e grava o vínculo para os próximos nós. A busca segue esta ordem: vínculo já gravado (ou o id do contato que o Columba grava nos metadados do cliente, o que vale também depois de reconectar a conta), telefone do contato e, se ligado, e-mail. O cliente criado leva o nome (no padrão da extensão), o telefone e o e-mail do contato.
Quando usar: antes de cobrar, quando você quer gravar um e-mail que a IA coletou (faturas por e-mail precisam dele) ou metadados como a origem do lead. O nó Cobrança no Stripe já cria o cliente sozinho quando ele não existe; este nó é para quando você quer controlar o cadastro.
Configuração:
| Campo | O que é |
|---|---|
| Nome | Vazio = nome do contato, no padrão da extensão (com ou sem os 4 últimos dígitos do telefone). Aceita variáveis. |
| Vazio = e-mail do contato. Aceita variáveis. | |
| Buscar também pelo e-mail | Se o telefone não achar, tenta pelo e-mail do contato. Ligado por padrão. |
| Atualizar se já existir | Acrescenta o telefone e o e-mail que faltam e os metadados no cliente encontrado. Ligado por padrão; desligado, o cliente encontrado fica como está. |
| Metadados | Pares chave/valor gravados no cliente do Stripe, por exemplo origem = {{flow.origem}}. |
Regras: quando dois clientes diferentes do Stripe casam com o telefone do contato, o nó sai por Erro com o código ambiguous_customer e os ids em {{flow.stripe_customer_candidates}}: ligue essa saída a um Transferir Humano para a conferência manual, em vez de deixar o Columba escolher. Os nós que criam no Stripe seguram uma trava por contato enquanto rodam: se o mesmo cliente escrever em dois números ao mesmo tempo, a segunda conversa espera a primeira e reaproveita o cliente que ela criou.
Saídas:
| Saída | Quando |
|---|---|
| Sucesso | Cliente localizado, atualizado ou criado. |
| Erro | Extensão desconectada, chave recusada, cadastro ambíguo ou falha na API. |
Variáveis: {{flow.stripe_customer_id}} (cus_…), {{flow.stripe_customer_url}} (o cliente no Dashboard do Stripe, para a equipe), {{flow.stripe_customer_email}}, {{flow.stripe_customer_created}} (true quando criou) e, no caso ambíguo, {{flow.stripe_customer_candidates}}.
Cobrança no Stripe
Cria uma cobrança na sua conta Stripe e grava a URL para mandar na conversa. É idempotente: se o motor repetir o passo (uma falha de rede, um reinício), o Stripe devolve a mesma cobrança e o cliente nunca é cobrado duas vezes.
Quando usar: fechar a venda com o link de pagamento no WhatsApp; cobrar o sinal de uma reserva com prazo curto; emitir uma fatura com vencimento, PDF e 2ª via.
O campo Tipo decide o formato:
| Link de pagamento | Fatura com vencimento | |
|---|---|---|
| Para quê | "Pague agora", na conversa | Cobrança com prazo, PDF e 2ª via |
| Validade | Expira em 30 minutos a 24 horas | Vence em N dias |
| O que o cliente abre | Página de pagamento do Stripe (Pix, cartão, boleto) | Página da fatura no Stripe, com o PDF |
| Id gravado | plink_… | in_… |
Configuração:
| Campo | O que é |
|---|---|
| Tipo | Link de pagamento (padrão) ou Fatura com vencimento. O link de pagamento é um Payment Link do Stripe: URL curta (buy.stripe.com/…, uns 50 caracteres, boa para o WhatsApp), de uso único, com a validade escolhida; vencido sem pagamento, o nó Status da Cobrança o desativa. |
| Valor | Em reais: 150,00, 1.234,56 ou uma variável, como {{flow.valor}}. Ignorado quando há um preço do catálogo. |
| Preço do catálogo | Um preço (price_…) da sua conta Stripe, escolhido na lista do catálogo. Vazio = valor avulso. |
| Quantidade | Só com preço do catálogo: de 1 a 999. Padrão: 1. |
| Descrição | O que está sendo cobrado; aparece na página de pagamento e no extrato. Vazio = "Pagamento — nome do contato". Aceita variáveis. |
| Métodos de pagamento | Pix, Cartão e/ou Boleto. Vazio = automático: o Stripe oferece o que a conta tem ativo. |
| Expira em (minutos) | Só no link de pagamento: de 30 a 1440. Vazio = padrão da extensão (24 horas). |
| Página após o pagamento | Só no link de pagamento: URL completa para onde o cliente vai depois de pagar (o Stripe exige uma). Vazio = padrão da extensão, que por sua vez cai na página "Pagamento recebido" do Columba. |
| Vencimento (dias) | Só na fatura: dias até o vencimento, de 0 a 365. Vazio = padrão da extensão (3 dias). |
| Enviar fatura por e-mail | Só na fatura: o próprio Stripe manda a fatura por e-mail ao cliente. Desligado por padrão. |
| Se já houver cobrança aberta igual | Reaproveitar a aberta (padrão): se o contato já tem uma cobrança aberta com a mesma descrição, sai por Já existia com a URL dela. Criar mesmo assim: cria outra. |
| Criar cliente se não existir | Sem cliente no Stripe, cria um com nome, telefone e e-mail do contato. Ligado por padrão; desligado, sem cliente o nó sai por Erro. |
| Metadados | Pares chave/valor gravados na cobrança, por exemplo pedido = {{flow.pedido}}. |
Regras:
- Valor mínimo: R$ 0,50 (regra do Stripe). Abaixo disso, ou com um valor que não dá para ler, o nó sai por Erro com
invalid_amount. - Preço do catálogo vale mais que o Valor: a cobrança fica em preço × quantidade, na moeda do preço.
- Pix precisa estar ativo na sua conta Stripe (no Brasil, é liberado por convite). Com Métodos de pagamento fixos e um método inativo, o nó sai por Erro com
payment_method_unavailable. Com o campo vazio (automático), o nó nunca falha por isso: o cliente vê o que estiver ativo. - Fatura exige e-mail: o Stripe só cria faturas enviadas (com vencimento) para clientes com e-mail. O nó usa o e-mail do contato; sem e-mail, sai por Erro com
customer_email_required. Colete o e-mail antes (nó Cliente no Stripe, campo E-mail) ou use o link de pagamento (Checkout), que não exige e-mail. - Além dos seus metadados, toda cobrança leva os ids do Columba (conta, contato, conversa e execução). É por eles que o gatilho Pagamento no Stripe reconhece as cobranças criadas aqui e encontra o contato certo.
- Como no nó Cliente no Stripe, o nó segura uma trava por contato enquanto cria.
- No modo de teste, a cobrança é de teste:
{{flow.stripe_livemode}}ficafalse.
Saídas:
| Saída | Quando |
|---|---|
| Criada | Cobrança nova: {{flow.stripe_payment_url}} está pronta para enviar. |
| Já existia | Havia uma cobrança aberta igual, que foi reaproveitada (a URL dela está em {{flow.stripe_payment_url}}). |
| Erro | Valor inválido, método indisponível, extensão desconectada ou falha na API. |
Ligue Criada e Já existia ao mesmo passo
As duas saídas têm o link pronto em {{flow.stripe_payment_url}}: ligue ambas ao mesmo Enviar Texto. Para um botão "Pagar agora" em vez do link no texto, use Link com Botão com essa variável no campo do link.
Variáveis:
| Variável | Valor |
|---|---|
{{flow.stripe_charge_id}} | Id da cobrança: plink_… (link de pagamento) ou in_… (fatura) |
{{flow.stripe_charge_kind}} | checkout ou invoice |
{{flow.stripe_payment_url}} | O link para o cliente pagar, já encurtado (pay.columba.com.br/p/…, 36 caracteres), para link de pagamento e fatura. A URL original do Stripe fica em {{flow.stripe_payment_url_long}} |
{{flow.stripe_invoice_pdf}} | PDF da fatura (só fatura), encurtado; original em {{flow.stripe_invoice_pdf_long}} |
{{flow.stripe_amount}} | Valor em centavos (15000) |
{{flow.stripe_amount_formatted}} | Valor formatado ("R$ 150,00") |
{{flow.stripe_expires_at}} | Quando o link expira (só link de pagamento) |
{{flow.stripe_due_date}} | Vencimento (só fatura, AAAA-MM-DD) |
{{flow.stripe_due_date_formatted}} | Vencimento pronto para a mensagem: "30/11/2026" |
{{flow.stripe_expires_at_formatted}} | Validade do link pronta para a mensagem: "03/11 às 15:00" (horário de Brasília) |
{{flow.stripe_charge_status}} | Situação da cobrança |
{{flow.stripe_payment_method}}, {{flow.stripe_payment_method_label}} | Meio de pagamento, quando a cobrança já está paga: cru (pix, card, boleto) e em português ("Pix", "cartão", "boleto"). Numa cobrança nova, ficam vazios |
{{flow.stripe_livemode}} | true em produção, false no modo de teste |
Toda cobrança criada pelo nó aparece também na seção Cobranças da ficha do contato e na aba Cobranças dos Relatórios, com a origem por automação.
Botão Cobrar ou nó Cobrança no Stripe?
Os dois criam a mesma cobrança, com as mesmas regras e o mesmo link curto, e ambos disparam o gatilho Pagamento no Stripe. A diferença é quem decide o valor:
- Nó Cobrança no Stripe (fluxo): para a regra previsível, que se repete do mesmo jeito: o preço do catálogo, o sinal de reserva, a taxa fixa, o valor que a IA extraiu do pedido. Roda sozinho, a qualquer hora, sem ninguém da equipe.
- Botão Cobrar (Chat): para o valor negociado na conversa, o orçamento fechado, o desconto combinado, a cobrança avulsa que não cabe numa regra. O atendente informa o valor e confere a mensagem antes de enviar.
Uma diferença prática: o nó pode reaproveitar uma cobrança aberta igual (campo Se já houver cobrança aberta igual); o botão sempre cria uma nova, porque o atendente vê na conversa o card da anterior e pode usar Reenviar.
Consultar Cobranças no Stripe
Lista as cobranças (links de pagamento e faturas) do cliente do contato na conta Stripe, das mais recentes para as mais antigas, e decide a saída: vencida, pendente, paga ou nenhuma.
Quando usar: o cliente pede a 2ª via ou o boleto; pergunta "já paguei?"; antes de cobrar de novo, para não mandar uma cobrança em dobro; para a Resposta IA responder sobre débitos com dados reais.
Configuração:
| Campo | O que é |
|---|---|
| Quantas cobranças | Quantas das mais recentes consultar: de 1 a 10. Padrão: 5. |
| Consultar assinatura | Grava também a assinatura mais recente do cliente nas variáveis {{flow.stripe_subscription_*}}. Desligado por padrão. |
Regras: a saída segue esta ordem: Vencida se houver fatura vencida sem pagamento; senão Pendente se houver cobrança aberta dentro do prazo; senão Paga se a mais recente estiver paga; senão Nenhuma. O nó só consulta: não cria cliente nem cobrança. Contato sem cliente no Stripe sai por Nenhuma.
Saídas:
| Saída | Quando |
|---|---|
| Vencida | Há fatura vencida sem pagamento. |
| Pendente | Há cobrança aberta dentro do prazo. |
| Paga | A cobrança mais recente está paga e não há nenhuma aberta. |
| Nenhuma | O cliente não tem cobranças (ou o contato não tem cliente no Stripe). |
| Erro | Extensão desconectada, chave recusada ou falha na API. |
Variáveis:
| Variável | Valor |
|---|---|
{{flow.stripe_last_charge_id}}, {{flow.stripe_last_charge_kind}}, {{flow.stripe_last_charge_status}} | A cobrança de referência: id, tipo (checkout ou invoice) e situação |
{{flow.stripe_last_charge_amount_formatted}} | Valor formatado ("R$ 150,00") |
{{flow.stripe_last_charge_url}} | Link para pagar (a 2ª via, na fatura) |
{{flow.stripe_last_charge_due_date}}, {{flow.stripe_last_charge_paid_at}} | Vencimento (AAAA-MM-DD) e quando foi paga |
{{flow.stripe_last_charge_due_date_formatted}} | Vencimento pronto para a mensagem: "30/11/2026" |
{{flow.stripe_open_count}} | Quantas cobranças estão em aberto |
{{flow.stripe_open_total_formatted}} | Soma do que está em aberto, formatada |
{{flow.stripe_charges}} | A lista das cobranças consultadas, útil para a Resposta IA explicar o histórico |
{{flow.stripe_subscription_id}}, {{flow.stripe_subscription_status}}, {{flow.stripe_subscription_plan}}, {{flow.stripe_subscription_renews_at}} | Com Consultar assinatura: a assinatura mais recente, a situação, o plano e a próxima renovação |
Status da Cobrança no Stripe
Confere no Stripe se uma cobrança foi paga, continua pendente ou expirou. Funciona com a cobrança criada pelo fluxo ou com uma informada.
Quando usar: depois de um Aguardar, para lembrar quem não pagou; para liberar uma reserva quando o sinal expira; para responder "já paguei?" sobre uma cobrança específica. Para reagir no momento em que o pagamento entra, prefira o gatilho Pagamento no Stripe com Pagamento confirmado; este nó confere num momento que você escolhe.
Configuração:
| Campo | O que é |
|---|---|
| Cobrança | Id do link de pagamento (plink_…), da sessão de pagamento (cs_…, como chega no gatilho) ou da fatura (in_…). Vazio = {{flow.stripe_charge_id}}, gravado pelo nó Cobrança no Stripe. Num fluxo iniciado pelo gatilho, use {{stripe.object.id}}; depois do Consultar Cobranças, {{flow.stripe_last_charge_id}}. |
Regras: boleto pago fica Pendente até a compensação bancária. Fatura vencida e ainda não paga sai por Expirada, assim como o link que expirou e a fatura cancelada.
Saídas:
| Saída | Quando |
|---|---|
| Paga | Pagamento confirmado. |
| Pendente | Ainda aberta (ou aguardando a compensação do boleto). |
| Expirada | Link expirado, fatura cancelada ou vencida. |
| Erro | Cobrança não encontrada, extensão desconectada ou falha na API. |
Variáveis: atualiza {{flow.stripe_charge_status}}, {{flow.stripe_paid_at}}, {{flow.stripe_payment_method}} (pix, card ou boleto), {{flow.stripe_payment_method_label}} (o mesmo em português: "Pix", "cartão" ou "boleto"), {{flow.stripe_payment_url}} e {{flow.stripe_amount_formatted}}.
Variáveis
| Variável | Quem grava | Valor |
|---|---|---|
{{flow.stripe_customer_id}}, {{flow.stripe_customer_url}}, {{flow.stripe_customer_email}}, {{flow.stripe_customer_created}} | Cliente | O cliente do contato no Stripe |
{{flow.stripe_customer_candidates}} | Cliente, na saída Erro | Ids dos clientes que casaram com o mesmo telefone |
{{flow.stripe_charge_id}}, {{flow.stripe_charge_kind}}, {{flow.stripe_payment_url}}, {{flow.stripe_invoice_pdf}}, {{flow.stripe_expires_at}}, {{flow.stripe_due_date}} | Cobrança | A cobrança criada (ou reaproveitada) |
{{flow.stripe_amount}}, {{flow.stripe_amount_formatted}} | Cobrança, Status | Valor em centavos e formatado |
{{flow.stripe_charge_status}}, {{flow.stripe_paid_at}}, {{flow.stripe_payment_method}} | Cobrança, Status | Situação, quando foi paga e como (pix, card ou boleto) |
{{flow.stripe_payment_method_label}} | Cobrança, Status | O meio de pagamento em português, pronto para a mensagem: "Pix", "cartão" ou "boleto" |
{{flow.stripe_livemode}} | Cobrança | false no modo de teste |
{{flow.stripe_last_charge_*}}, {{flow.stripe_open_count}}, {{flow.stripe_open_total_formatted}}, {{flow.stripe_charges}} | Consultar | O que o cliente deve ou já pagou |
{{flow.stripe_subscription_*}} | Consultar, com Consultar assinatura | A assinatura mais recente |
{{flow.stripe_error}}, {{flow.stripe_error_code}} | Qualquer nó, na saída Erro | O motivo, em texto e em código |
{{stripe.event}}, {{stripe.type}}, {{stripe.kind}}, {{stripe.object.*}}, {{stripe.customer.*}}, {{stripe.subscription.*}}, {{stripe.livemode}} | Gatilho Pagamento no Stripe | O evento recebido |
{{stripe.object.payment_method_label}} | Gatilho Pagamento no Stripe | O meio de pagamento em português: "Pix", "cartão" ou "boleto", quando o Stripe informa |
Use o link do cliente ({{flow.stripe_customer_url}}) em Notificar Equipe ou Avisar no WhatsApp para a equipe abrir o cadastro no Stripe com um toque. Para o cliente, mande sempre o link de pagamento ({{flow.stripe_payment_url}}).
Exemplos de fluxo
1. Cobrança pelo WhatsApp
- Gatilho Nova Conversa (ou o gatilho de vendas que você já usa).
- Resposta IA qualifica o pedido e, com Salvar informações (ou o modo Só extrair), grava o produto em
{{flow.produto}}e o valor em{{flow.valor}}. - Cliente no Stripe: e-mail
{{flow.email}}, se a IA coletou. Ligue Erro a um Transferir Humano. - Cobrança no Stripe: Tipo Link de pagamento, Valor
{{flow.valor}}, Descrição{{flow.produto}}, Métodos de pagamento Pix. Ligue Criada e Já existia ao passo 5 e Erro a um Notificar Equipe. - Enviar Texto:
Aqui está o link para pagar {{flow.stripe_amount_formatted}} por Pix: {{flow.stripe_payment_url}} (vale por 24 horas). - Aguardar: 24 horas.
- Status da Cobrança no Stripe, com o campo Cobrança vazio (usa a cobrança do passo 4):
- Paga → Enviar Texto:
Recebemos seu pagamento de {{flow.stripe_amount_formatted}} via {{flow.stripe_payment_method_label}}. Obrigado!→ Tag no Contato (adicionarCliente) → Mover de Etapa (etapa Ganho do funil). - Pendente → Enviar Texto com o lembrete e o mesmo link:
Seu pagamento de {{flow.stripe_amount_formatted}} ainda está pendente. O link continua aqui: {{flow.stripe_payment_url}} - Expirada → Transferir Humano para o vendedor, ou uma nova Cobrança no Stripe seguida de um Enviar Texto com o link novo.
- Paga → Enviar Texto:
Lembrete antes de o link expirar
O link vale no máximo 24 horas. Com Aguardar de 24 horas, o mais comum é cair em Expirada. Para o lembrete chegar com o link ainda válido, aguarde menos que a expiração (por exemplo, 20 horas). Em número da API Oficial, um lembrete enviado 24 horas depois da última mensagem do cliente precisa do modelo de fallback. Se você também usa o fluxo do exemplo 2, ele assume a conversa assim que o pagamento entra (com Com fluxo em andamento em Reiniciar), e este fluxo para no Aguardar. Nesse caso, deixe a tag e o Mover de Etapa só no fluxo 2.
2. Pagamento confirmado
- Gatilho Pagamento no Stripe: Eventos Pagamento confirmado, Tipo de cobrança Qualquer, Só cobranças criadas pelo Columba ligado, Canal WhatsApp.
- Enviar Texto:
Recebemos seu pagamento de {{stripe.object.amount_formatted}}. Obrigado! - Mover de Etapa: etapa Ganho do seu funil.
Para avisar a equipe também, acrescente um Notificar Equipe: {{stripe.customer.name}} pagou {{stripe.object.amount_formatted}} via {{stripe.object.payment_method_label}} ({{stripe.object.description}}).
Este fluxo vale também para as cobranças feitas pelo botão Cobrar da conversa: elas carregam os ids do Columba como as dos nós. Como o próprio card da conversa já mostra o pagamento e deixa uma nota interna para a equipe, use o fluxo para o que é com o cliente e com o funil (agradecer, mover o negócio, etiquetar).
3. Fatura vencida
- Gatilho Pagamento no Stripe: Eventos Fatura venceu, Tipo de cobrança Fatura, Canal WhatsApp. Se as faturas nascem de assinaturas ou do Dashboard do Stripe (e não do nó Cobrança no Stripe), desligue Só cobranças criadas pelo Columba.
- Enviar Texto com a 2ª via:
Olá! A fatura de {{stripe.object.amount_formatted}} venceu. Segue a 2ª via para pagar: {{stripe.object.url}}. Em número da API Oficial, configure o modelo de fallback. - Aguardar: 48 horas (2 dias).
- Status da Cobrança no Stripe, com Cobrança =
{{stripe.object.id}}:- Paga → fim (ou Tag no Contato
Em dia). - Expirada (a fatura continua vencida) ou Pendente → Transferir Humano para o financeiro.
- Paga → fim (ou Tag no Contato
4. 2ª via
- Gatilho Palavra-Chave: palavras-chave
boleto,segunda viae2 via, uma por linha (acrescente variações como2ª via), modo de correspondência contém. - Consultar Cobranças no Stripe:
- Vencida ou Pendente → Enviar Texto:
Aqui está a sua cobrança de {{flow.stripe_last_charge_amount_formatted}}: {{flow.stripe_last_charge_url}} - Paga → Enviar Texto: "A sua última cobrança já está paga. Posso ajudar em mais alguma coisa?"
- Nenhuma → Transferir Humano.
- Erro → Transferir Humano.
- Vencida ou Pendente → Enviar Texto:
Leia também
- Extensão Stripe: criar a chave restrita, conectar, padrões das cobranças, notificações e problemas comuns
- Cobrar pela conversa: o botão Cobrar do Chat
- Gatilhos
- Ações
- Funil de vendas nas automações
- Referência técnica (JSON)