Tema
Cobrar pelo WhatsApp sem sair da conversa: chegou a extensão Stripe do Columba
Dez da manhã na Pousada Mar Alto. A Carla escreve pelo WhatsApp: quer o fim de semana do dia 14, duas diárias. A Rose, na recepção, manda a tarifa e as fotos do quarto. A Carla responde "fechado". E aí começa a parte que ninguém vê.
A Rose abre o Stripe (ou o app do banco) em outra aba, cria o link do sinal, copia, volta ao WhatsApp e cola. A Carla diz que pagou. Pagou mesmo? Pelo celular, não dá para saber. A Rose confere à noite, no extrato, junto com os outros sinais do dia. Até lá, a vaga fica meio reservada: não dá para oferecer a outro hóspede nem confirmar para a Carla.
Quem cobra pelo WhatsApp conhece essa cena. A venda acontece na conversa, a cobrança mora em outro lugar e a confirmação chega horas depois, quando chega.
Agora o Columba conecta a sua conta Stripe, e a cobrança vira um passo da conversa.
A Pousada Mar Alto é um exemplo. As conversas desenhadas neste artigo ilustram a história; as telas reais do Columba aparecem logo depois de cada uma.
A cobrança vira um passo da conversa
O Stripe é a segunda extensão do Columba, depois do Pipedrive, e fica no mesmo lugar: Configuração › Extensões. Você conecta a sua própria conta Stripe com uma chave restrita (o passo a passo está mais abaixo) e o Columba passa a criar as cobranças nela. O dinheiro vai direto para você, com as taxas do seu contrato com o Stripe, e o Columba não cobra nada por cobrança criada.
São dois jeitos de cobrar, e eles convivem:
| Automático (fluxo) | Botão Cobrar (atendente) | |
|---|---|---|
| Quem cobra | Uma automação, sem ninguém na conversa | O atendente, no valor que acabou de combinar |
| Bom para | Preço fixo, sinal de reserva, taxa, mensalidade | Desconto negociado, orçamento sob medida, valor que muda a cada cliente |
| Como a equipe fica sabendo | O fluxo confere no Stripe ou reage ao aviso dele | O card da cobrança vira Pago sozinho na conversa |
Nos dois casos, o cliente recebe um link curto, paga por Pix, cartão ou boleto na página do Stripe, e o Columba fica sabendo sem ninguém abrir o extrato.
Caminho 1: o fluxo cobra sozinho
Voltemos à Carla, agora com a pousada usando o fluxo de cobrança. Ela escreve "quero pagar":
Carla
WhatsApp · Pousada Mar Alto
3 de novembro
Cliente:
Fechado! Fico com o quarto do fim de semana do dia 14, duas diárias. 😍
Empresa:
Que ótimo, Carla! Para garantir a reserva, o sinal é de R$ 150,00. Quando quiser, é só escrever pagar aqui.
Cliente:
Quero pagar
Empresa:
Perfeito, Carla! Vou gerar o seu link de pagamento agora. Um instante…
Empresa:
Aqui está o seu link de pagamento de R$ 150,00 (Pix, cartão ou boleto):
https://pay.columba.com.br/p/Ab3k9Qz
Ele vale por 1 hora. Assim que o pagamento cair eu te aviso por aqui. 😉
Empresa:
Pagamento de R$ 150,00 confirmado via cartão! ✅ Obrigado, Carla. Sua reserva está garantida.
Cliente:
Uhuul! Até o dia 14 🏖️
A Carla pagou com cartão às 10h04. Às 10h05, três minutos depois de mandar o link, o fluxo conferiu no Stripe e confirmou a reserva. Por trás, ele fez isto:
- Palavra-Chave dispara com "pagar", "quero pagar", "pagamento" e variações (palavra exata).
- Cliente no Stripe localiza a Carla na sua conta Stripe pelo telefone (ou pelo e-mail) e, se ela ainda não existe lá, cria o cadastro. Sem duplicar: na próxima cobrança, o vínculo já está gravado.
- Cobrança no Stripe cria o sinal de R$ 150,00 como link de pagamento, de uso único e válido por 1 hora. Se a Carla pedir de novo enquanto o link está aberto, recebe o mesmo, e não um segundo.
- Enviar Texto manda o link curto, no formato
pay.columba.com.br/p/Ab3k9Qz, que cabe numa linha do WhatsApp. - Aguardar 3 minutos e Status da Cobrança conferem no Stripe:
- Paga: sai a confirmação com o meio de pagamento ("via cartão", "via Pix"), o contato ganha a tag reserva paga e o negócio da Carla passa de Orçamento para Confirmada no funil de vendas.
- Pendente: um lembrete com o mesmo link. Quando o link vence, uma hora depois, o fluxo confere de novo: se ela pagou nesse meio-tempo, confirma; se o link expirou, avisa e oferece outro.
- Erro (chave revogada, Pix desligado na conta, valor inválido): aviso no sino da equipe com o motivo, para ninguém ficar sem o link em silêncio.
O fluxo está pronto para importar:
Stripe: cobrança pelo WhatsApp (link de pagamento)
No Columba: Automações › Importar automação e escolha o arquivo.
Ao importar, o Columba avisa que o passo Mover de Etapa está sem etapa. É de propósito: funis e etapas são da sua conta e não viajam no arquivo. Escolha a sua no editor (no exemplo, "Confirmada"), crie a tag reserva paga em Configurações › Tags e ajuste o valor e a validade do link. A nota amarela dentro do fluxo lembra cada ajuste.
Os quatro nós e o gatilho
Com a extensão conectada, a barra lateral do editor ganha o grupo Stripe:
| Nó | O que faz | Saídas |
|---|---|---|
| Cliente no Stripe | Localiza ou cria o cliente do contato na sua conta Stripe, sem duplicar, e grava o vínculo. | Sucesso · Erro |
| Cobrança no Stripe | Cria o link de pagamento (uso único, validade de 30 minutos a 24 horas) ou a fatura com vencimento (com página de 2ª via e PDF), por valor avulso ou por um preço do seu catálogo no Stripe. | Criada · Já existia · Erro |
| Consultar Cobranças | Lista as cobranças do cliente no Stripe e decide: vencida, pendente, paga ou nenhuma. É o nó da 2ª via e do "já paguei?". | Vencida · Pendente · Paga · Nenhuma · Erro |
| Status da Cobrança | Confere se uma cobrança específica foi paga, continua pendente ou expirou. | Paga · Pendente · Expirada · Erro |
E o gatilho Pagamento no Stripe inicia um fluxo quando o Stripe avisa um destes seis eventos: pagamento confirmado, cobrança falhou ou expirou, fatura venceu, renovação próxima, assinatura mudou e reembolso ou disputa. É ele que agradece o cliente quando o boleto compensa, lembra a fatura vencida ou avisa a equipe de uma contestação no cartão.
As mensagens usam variáveis prontas, como {{flow.stripe_payment_url}} (o link curto), {{flow.stripe_amount_formatted}} ("R$ 150,00") e {{flow.stripe_payment_method_label}} ("Pix", "cartão" ou "boleto").
Caminho 2: o botão Cobrar
Nem toda cobrança cabe num fluxo. Imagine agora que, em vez de pagar o sinal de tabela, a Carla negocia:
Carla
WhatsApp · Pousada Mar Alto · com a Rose
3 de novembro
Cliente:
Rose, e se eu ficar as duas noites, fecha em 380 com o desconto?
Empresa:
Fecha, sim! Vou te mandar o link agora. 😊
Empresa:
Aqui está o seu link de pagamento de R$ 380,00 (Fim de semana 14/11, 2 diárias):
https://pay.columba.com.br/p/Q8v2LmT
O link vale até 04/11 às 14:06.
Link de pagamento
R$ 380,00
Fim de semana 14/11, 2 diárias
Aguardando pagamentoLink vale até 04/11 às 14:06
A Rose não precisou montar fluxo nenhum. Ela clicou em Cobrar, no cabeçalho da conversa, ao lado de Negócio e Ticket (no celular, o botão fica no menu ⋯).
No modal, à esquerda, ela preencheu:
- Tipo: Link de pagamento (o cliente paga agora, dentro da validade) ou Fatura com vencimento (prazo em dias, PDF e página de 2ª via; exige o e-mail do cliente, que fica salvo no cadastro do contato).
- Valor: 380,00, o combinado.
- Descrição: "Fim de semana 14/11, 2 diárias". Aparece na mensagem, na página de pagamento e no extrato da Carla.
- Meios de pagamento: Pix, cartão e/ou boleto. Nenhum marcado é o automático: o Stripe oferece o que a sua conta tem ativo.
- Validade do link: de 30 minutos a 24 horas. Na fatura, o campo vira Vence em (dias).
- Mensagem: um modelo pronto com
{{valor}},{{descricao}},{{link}}e{{prazo}}, que dá para editar à vontade. A mensagem nunca sai sem o link.
À direita, a prévia mostra a mensagem exatamente como a Carla vai recebê-la. O botão de confirmar já diz o valor, Cobrar R$ 380,00, e o mesmo clique nunca cria duas cobranças.
O card da cobrança
A Carla recebe só o texto com o link. A equipe vê, na conversa, um card com o valor, a descrição, a situação (Aguardando pagamento) e até quando o link vale, com três botões: Copiar link, para mandar por outro canal; Reenviar, que manda a mesma mensagem com o mesmo link, sem criar outra cobrança; e Cancelar, que desativa o link no Stripe.
Seis minutos depois, a Carla paga com Pix. Ninguém recarrega a tela:
Carla
WhatsApp · Pousada Mar Alto · com a Rose
Empresa:
Aqui está o seu link de pagamento de R$ 380,00 (Fim de semana 14/11, 2 diárias):
https://pay.columba.com.br/p/Q8v2LmT
O link vale até 04/11 às 14:06.
Link de pagamento
R$ 380,00
Fim de semana 14/11, 2 diárias
Pago em 03/11 às 14:12 (Pix)Nota interna · Stripesó a equipe vê
✅ Pagamento de R$ 380,00 confirmado (Pix). Fim de semana 14/11, 2 diárias.
Cliente:
Pronto, paguei! 🙌
Empresa:
Recebido, Carla! Reserva confirmada. Até o dia 14! 🌊
Três coisas acontecem sozinhas:
- o card passa de Aguardando pagamento para Pago em 03/11 às 14:12 (Pix);
- a conversa ganha uma nota interna, assinada como Stripe, que só a equipe vê: "✅ Pagamento de R$ 380,00 confirmado (Pix). Fim de semana 14/11, 2 diárias.";
- a ficha da Carla ganha a cobrança, com a origem pela conversa.
A Rose não abriu o Stripe nenhuma vez. Viu a nota, respondeu a Carla e foi atender o próximo hóspede.
Pix e cartão confirmam em segundos; o boleto só aparece como pago depois da compensação bancária. E se o cliente disser que pagou e o card não mudou, o botão de atualizar, no canto do card, consulta o Stripe na hora.
Botão e fluxos juntos
A cobrança do botão leva os mesmos dados das cobranças dos fluxos. Por isso, um fluxo com o gatilho Pagamento no Stripe também dispara para ela: o fluxo que aplica uma tag ou move o negócio no funil funciona igual, venha a cobrança do botão ou de um nó.
Com uma regra que vale para todo o Columba: um fluxo nunca atropela um atendente. Se a conversa está com a Rose, o fluxo do pagamento não roda, e quem agradece é ela, que acabou de ver a nota. Se o que importa nessa hora é a tag e o funil, monte esse fluxo no modo Sem canal: ele não manda mensagem ao cliente, mas roda mesmo com a conversa no atendimento humano. É o mesmo princípio do follow-up que não atropela o atendimento.
Quem pode cobrar
O botão depende da permissão nova Cobrar pela conversa, no recurso Chat de Funções e permissões. Administrador, Gerente e Operador já a têm; o Visualizador, não. Funções personalizadas nascem sem ela: para liberar o botão, marque a ação. Cada cobrança criada, reenviada ou cancelada pela conversa fica registrada na auditoria da conta.
O que o cliente vê
Do lado da Carla, nada de aplicativo novo nem cadastro:
- Uma mensagem comum no WhatsApp, com o link curto do Columba (
pay.columba.com.br/p/…). - Ao tocar, abre a página de pagamento do Stripe, com o valor, a descrição e os meios que a sua conta oferece: Pix, cartão ou boleto.
- Depois de pagar, ela cai na página Pagamento recebido, que orienta a voltar ao WhatsApp. O texto dessa página é configurável, e você pode mandar o cliente para uma página do seu site no lugar dela.
O link curto respeita a validade: passado o prazo, mostra "Link expirado" em vez de abrir a página. E o cliente não vê o card nem a nota; esses são da equipe.
A ficha do contato e o relatório de Cobranças
Cada cobrança fica no histórico do cliente e nos números da operação.
Na ficha do contato, a seção Cobranças lista as últimas cobranças, da mais recente para a mais antiga: valor, situação (em aberto, paga, vencida, expirada ou cancelada), descrição, data e origem, pela conversa ou por automação. Abrir no Stripe leva à cobrança no painel do Stripe, e Copiar link fica disponível enquanto ela está em aberto.
Em Relatórios › Cobranças, a gestão vê:
- cobrado × recebido no período: do que foi cobrado, quanto entrou;
- em aberto e vencidas, em quantidade e em reais;
- a conversão (cobranças pagas sobre as criadas) e o tempo mediano até pagar;
- a divisão por formato (link de pagamento ou fatura), por origem (pela conversa ou por automação) e por meio (Pix, cartão, boleto);
- quem cobrou, nas cobranças feitas pelo botão;
- as últimas cobranças, com contato, valor e situação.
Os outros relatórios mostram até o dia anterior. O de Cobranças vale no mesmo dia: a cobrança das 14h já aparece às 14h.
Conectar em dois minutos
No Stripe:
- Entre no Dashboard do Stripe com um usuário Administrador ou Desenvolvedor. Para testar sem dinheiro de verdade, ligue o modo de teste.
- Abra Desenvolvedores › Chaves de API e clique em Criar chave restrita.
- Quando o Stripe perguntar como a chave será usada, escolha Criando a minha própria integração. Dê o nome
Columba. - Ajuste as permissões: Customers, Payment Links, Checkout Sessions, Invoices e Webhook Endpoints em Write; Products, Prices e Subscriptions em Read; todo o resto em None. Accounts em Read é opcional: só mostra o nome e a moeda da conta na página da extensão. (No Dashboard em português, os nomes aparecem traduzidos.)
- Crie a chave e copie-a inteira: ela começa com
rk_test_ourk_live_.
No Columba:
- Abra Configuração › Extensões › Stripe, cole a chave e clique em Conectar.
Na hora, a página mostra a conta conectada, o selo Modo de teste ou Produção, os meios de pagamento ativos e cada permissão conferida (ok ou faltando). Para conferir as permissões, o Columba só faz leituras, sem criar nada de teste na sua conta. Em seguida, registra sozinho o webhook Columba, que traz os avisos de pagamento, e o editor ganha o grupo Stripe.
Na mesma página ficam os padrões das cobranças (validade do link, vencimento da fatura, meios de pagamento e para onde o cliente vai depois de pagar) e as notificações, ou seja, quais avisos do Stripe chegam ao Columba. Pagamento confirmado, cobrança falhou ou expirou e fatura venceu já vêm ligados.
Comece pelo modo de teste. Com a chave rk_test_, o cartão 4242 4242 4242 4242 paga de mentira, e o Pix e o boleto são simulados. Validou os fluxos? Desconecte e conecte com a chave de produção. Os dois modos nunca se misturam.
O que a integração não faz
Preferimos dizer antes que você descobrir depois.
- Não faz reembolso. Nem pela conversa nem pelos fluxos: reembolso, cancelamento de assinatura e mudança de preço ficam no painel do Stripe. Cobrança já paga também não se cancela pelo card.
- O Pix depende do Stripe. No Brasil, o Stripe libera o Pix por convite, conta a conta, e quem decide é ele, não o Columba. O cartão funciona de cara, e o boleto é só ligar nos métodos de pagamento do Stripe. Enquanto o Pix não chega, deixe os meios no automático: o cliente vê cartão e boleto, e nada falha.
- Cobranças feitas direto no painel do Stripe não entram na ficha do contato nem no relatório. Os dois mostram o que o Columba criou, pelo botão ou pelos fluxos. Para as outras, o nó Consultar Cobranças enxerga tudo o que o cliente tem no Stripe, e o gatilho reage a elas se você desligar Só cobranças criadas pelo Columba.
- O link de pagamento vale no máximo 24 horas. Para um prazo maior, use a fatura com vencimento.
- Assinaturas nascem no Stripe, não no Columba. O Columba reage a elas: avisa a renovação próxima, o cartão recusado na renovação, a assinatura cancelada.
- Na API Oficial do WhatsApp, a mensagem da cobrança respeita a janela de 24 horas, como qualquer outra. Fora dela, reabra a conversa com um modelo aprovado antes de cobrar.
- Só a partir do plano Profissional.
Segurança
- Chave restrita, não a secreta. Ela só faz o que as permissões liberam. Se um dia vazar, o estrago é limitado, e você a revoga no Stripe sem afetar os outros sistemas que usam a conta.
- A chave fica no AWS Secrets Manager, separada do banco de dados. Não aparece de novo na tela nem sai em exportação de fluxo.
- Nunca cobra duas vezes. Toda criação de cobrança leva uma chave de idempotência: se o motor repetir um passo depois de uma falha de rede, ou se alguém clicar duas vezes, o Stripe devolve a mesma cobrança em vez de criar outra.
- Avisos conferidos. Cada aviso do Stripe chega assinado com um segredo exclusivo do seu webhook; sem assinatura válida, é recusado.
- Tudo na auditoria. Conectar, testar, mudar padrões e desconectar exige a permissão Configurações › Editar. Essas ações, e cada cobrança criada, reenviada ou cancelada pela conversa, ficam registradas na auditoria da conta.
- Verificação diária. Uma vez por dia, o Columba testa a chave e recria o webhook se o Stripe o tiver desligado. Se a chave for revogada, um aviso chega ao sino da equipe.
- Contas separadas. A sua assinatura do Columba é cobrada por outra conta Stripe, da AtivoCode. A extensão não consulta o seu saldo nem faz saques.
Fluxos prontos para baixar
O fluxo da Carla está lá em cima. Estes quatro completam o kit. Todos entram como rascunho, com uma nota amarela do que ajustar antes de publicar (tags, etapa do funil, time que recebe a conversa).
Pagamento confirmado. O gatilho Pagamento no Stripe agradece o cliente, aplica a tag "cliente-pagou", move o negócio e avisa a equipe com o atalho para a cobrança no Stripe. Se outro fluxo estiver rodando na conversa, ele ignora o aviso, para não interromper um fluxo de cobrança que ainda vai conferir o status.
Stripe: pagamento confirmado
No Columba: Automações › Importar automação e escolha o arquivo.
Fatura vencida. Quando uma fatura vence sem pagamento, o fluxo manda a 2ª via na conversa e aplica a tag "em atraso". Dois dias depois, se ela continuar vencida, a conversa vai para o financeiro, com aviso no sino.
Stripe: fatura vencida (lembrete e financeiro)
No Columba: Automações › Importar automação e escolha o arquivo.
2ª via pelo WhatsApp. O cliente escreve "segunda via", e o fluxo consulta as cobranças dele no Stripe e responde com o link certo, sem atendente.
Stripe: 2ª via pelo WhatsApp
No Columba: Automações › Importar automação e escolha o arquivo.
Fatura com vencimento. O cliente pede "boleto" ou "mensalidade": o fluxo pede o e-mail, cria a fatura com vencimento em 5 dias e manda o link e o PDF.
Stripe: fatura com vencimento (boleto)
No Columba: Automações › Importar automação e escolha o arquivo.
Para começar
A documentação completa está na Central de Ajuda: conectar e configurar a extensão e o gatilho e os quatro nós, campo a campo. A extensão está disponível a partir do plano Profissional, e o teste de 7 dias libera tudo: dá para conectar o Stripe no modo de teste no primeiro dia e ver o card virar Pago antes do almoço.
Se você cobra por outro meio de pagamento, conte para a gente pelo WhatsApp do site. O catálogo de extensões cresce na ordem do que os clientes pedem.