Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Enviar links de pagamento no WhatsApp automaticamente

Para enviar links de pagamento no WhatsApp automaticamente, responda às perguntas sobre pagamento com um link fixo do seu prestador de pagamentos, acionado por palavras como «pagar» ou «pix», ou encaminhe a mensagem para o seu sistema, que cria um link para a encomenda desse cliente e o devolve como resposta. O cliente paga na página do prestador, e o seu sistema confirma no chat assim que o pagamento estiver concluído.

O easyCoexistence liga o número de WhatsApp Business que mantém na aplicação à Cloud API da Meta, através do Coexistence, e executa automações sobre ele: uma resposta por palavra-chave com o seu link, a sua própria IA com a sua chave, ou um webhook para o sistema que cria links por encomenda.

20 s

Tempo de que o seu sistema dispõe para criar o link e devolvê-lo no campo de resposta.

24 hours

Validade predefinida de uma Stripe Checkout Session, que pode ser definida entre 30 minutos e 24 horas.

metadata

O Stripe copia os metadados de um Payment Link para as Checkout Sessions que cria, para que um pagamento possa ser associado ao chat.

Static URL button

Os templates cujos botões não têm variáveis podem ser enviados pelo passo Enviar um template de uma automação.

Utility

Categoria da Meta para templates acionados por uma ação ou pedido do utilizador, sem qualquer intuito promocional.

Que formas tem o WhatsApp de enviar links de pagamento automaticamente?

Cinco padrões, desde os que não exigem código até aos totalmente automáticos. Comece pelo link fixo se um só preço ou um checkout de loja cobrir as suas vendas, e passe para um link por encomenda quando os valores variarem. Em todos, o pagamento acontece na página ou na aplicação do seu prestador, pelo que os números de cartão, as transferências PIX e os recibos ficam fora da automação e do seu registo de execução:

Fixed link by keywordHas keyword + Reply with text holding your Payment Link, PIX key or checkout page
Link in the AI's InstructionsReply with AI sends it, copied exactly, when the customer is ready to pay
A link per orderCall my webhook: your system creates the link and returns it as the reply
Template with a link buttonSend a template with a static URL button, inside or outside the 24 hours
Paid confirmationYour system sends it through the Cloud API when the provider reports payment

Como enviar um link fixo por palavra-chave?

Comece em Resposta por palavra-chave, em Começar a partir de um exemplo. Gatilho: Tem palavra-chave, Contém, com as palavras que os clientes usam quando querem pagar. Passo: Responder com texto, com o link numa linha própria, para poder ser tocado ou copiado, e {{first_name}} se quiser. Uma chave PIX ou uma referência de transferência bancária funciona da mesma forma. Contém corresponde a partes de palavras, por isso «pagar» também dispara com «repagar» e «apagar», o que costuma ser útil, enquanto «link» sozinho dispara em muitas mensagens não relacionadas. A automação por palavra-chave responde antes do seu assistente de IA, por isso o link é exato e nunca é parafraseado.

Keyword reply: words and message (example)
Keywords (Contains): pay, payment, pagar, pagamento, pix, pago, link de pago, checkout

Reply with text:
Hi {{first_name}}! You can pay securely here:
https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY

Prefer PIX? Key: payments@bloomcafe.example
Send the receipt here when you are done and we will confirm.

A sua IA pode enviar o link quando o cliente estiver pronto?

Sim, se o link estiver nas suas Instruções. Um passo Responder com IA escreve a partir das Instruções e do chat, por isso coloque lá o link com uma regra sobre quando o enviar e a ordem de confirmar primeiro. Os modelos copiam um URL dado tal e qual, e a regra acrescentada às suas instruções proíbe inventar preços, por isso indique os valores ou diga de onde vêm.

Acrescente duas linhas de segurança: o modelo nunca deve pedir números de cartão ou palavras-passe, e tudo o que disser respeito a reembolsos ou pagamentos falhados passa para uma pessoa. Teste ambas com Testar antes de ligar a automação, incluindo uma pergunta noutra língua.

Lines to add to the Instructions of a Reply with AI step
Payments
- When the customer confirms the order and wants to pay, send this link on its own line:
  https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY
- Before sending it, repeat the items and the total from the price list above.
- Never ask for card numbers, PINs, passwords or one-time codes. The customer pays on the link.
- Refunds, double charges or failed payments: say someone from our team will reply here shortly.

Como é que o seu sistema cria um link para cada encomenda?

Através de um passo Chamar o meu webhook. O seu endpoint verifica o X-EC-Signature, encontra a encomenda aberta do cliente por contact.wa_id ou pelo número da encomenda em message.text, pede ao prestador de pagamentos um link com o valor exato e devolve-o no campo de resposta. Coloque o id da encomenda e o número de WhatsApp nos metadados do link, para que o pagamento possa ser associado mais tarde.

Mantenha a resposta abaixo de 20 segundos: uma chamada ao prestador costuma demorar um ou dois segundos. Reutilize um link ainda válido se o cliente pedir duas vezes a mesma encomenda. Nos testes, dry_run é true: devolva uma frase de exemplo e não crie nada.

Express handler: a Stripe Checkout Session per order, returned as the reply
// signed(req) is the X-EC-Signature check from the live-data page, with this automation's secret.
app.post("/whatsapp/pay", express.text({ type: "application/json" }), async (req, res) => {
  if (!signed(req)) return res.status(401).end();
  const { dry_run, contact } = JSON.parse(req.body);

  const order = await openOrderFor(contact.wa_id); // your system: this customer's unpaid order
  if (!order) return res.json({ reply: "I could not find an open order for this number. Send the order number and I will check." });
  if (dry_run) return res.json({ reply: "Test: the payment link for order " + order.id + " would go here." });

  const form = new URLSearchParams({
    mode: "payment",
    success_url: "https://shop.example/thanks",
    "line_items[0][quantity]": "1",
    "line_items[0][price_data][currency]": order.currency,               // e.g. "usd" or "brl"
    "line_items[0][price_data][unit_amount]": String(order.amountCents),
    "line_items[0][price_data][product_data][name]": "Order " + order.id,
    "metadata[order_id]": order.id,
    "metadata[wa_id]": contact.wa_id,
  });
  const r = await fetch("https://api.stripe.com/v1/checkout/sessions", {
    method: "POST",
    headers: { Authorization: "Bearer " + process.env.STRIPE_SECRET_KEY },
    body: form,
  });
  const session = await r.json();
  if (!session.url) return res.json({ reply: "The payment link is not ready yet. Someone from our team will send it here shortly." });
  res.json({ reply: "Order " + order.id + ", total " + order.total + ". Pay here:\n" + session.url + "\nThe link stays open for 24 hours." });
});

Como recebe o cliente uma confirmação depois de pagar?

Do seu sistema, quando o prestador comunica o pagamento, por exemplo através do evento checkout.session.completed do Stripe com os seus metadados. Leia o número de WhatsApp e o id da encomenda e envie uma mensagem pela Cloud API da Meta, com o endpoint de envio e o token de acesso que devolve get_api_credentials. Nas 24 horas seguintes à última mensagem do cliente, basta um texto simples. Depois disso, a Meta aceita apenas um template aprovado; uma confirmação de pagamento segue a compra do próprio cliente, o que encaixa na categoria utility, embora a Meta decida na revisão. A mensagem aparece também na conversa da aplicação, para que a equipa veja que a encomenda foi paga.

Send the confirmation: text inside the window, template after it
// send_endpoint and access_token come from get_api_credentials for this number.
const insideWindow = Date.now() - lastCustomerMessageAt(waId) < 24 * 3600 * 1000;
await fetch(SEND_ENDPOINT, {
  method: "POST",
  headers: { Authorization: "Bearer " + ACCESS_TOKEN, "Content-Type": "application/json" },
  body: JSON.stringify(insideWindow
    ? { messaging_product: "whatsapp", to: waId, type: "text",
        text: { body: "Payment received for order " + orderId + ". Thank you! We will let you know when it ships." } }
    : { messaging_product: "whatsapp", to: waId, type: "template",
        template: { name: "payment_received", language: { code: "en" },
          components: [{ type: "body", parameters: [{ type: "text", text: orderId }] }] } }),
});

Um template pode levar o botão de pagamento?

Sim, com um URL fixo. Um passo Enviar um template pode enviar um template aprovado cujos botões não têm variáveis: um botão de URL para a sua página de checkout ou para um Payment Link fixo, ou botões de resposta rápida como Pagar agora e Falar connosco, cujos toques chegam como texto que uma automação por palavra-chave pode responder com o link. As variáveis do corpo são preenchidas por posição, por isso o valor ou o número da encomenda vai em {{1}} e {{2}}.

Um botão de URL com variável, como exigiria um link por encomenda, e os botões de copiar código não são preenchidos atualmente pelas automações; o seu sistema envia esses templates pela Cloud API. A Meta cobra as mensagens de template por mensagem, por categoria e por país, à sua própria Conta WhatsApp Business.

Como configurar

  1. Create the link at your providerMake a Payment Link or a checkout page for the product, or note your PIX key. Open it once on a phone to check the amount and the page.
  2. Start a keyword automationIn Automations, click New automation and pick Keyword reply under Start from an example. Choose Contains and enter your payment words, one per line.
  3. Write the replyIn Reply with text, put a short greeting with {{first_name}} and the link on its own line. Save with the switch Off.
  4. Test the wordsClick Test and run "how do I pay?", "quero pagar" and an unrelated message with Run test, to see which ones match and what the customer would receive.
  5. Switch it OnSet the switch to On and save. Write "pay" from another phone and tap the link to check it opens the payment page.

Erros comuns

  • Deixar a IA recolher dados de cartão no chat. Acrescente às Instruções uma linha que proíba números de cartão, PIN e códigos, e envie o link do prestador; as mensagens do chat ficam nos registos de execução durante 30 dias.
  • Enviar um link de sessão que expira. Uma Stripe Checkout Session dura 24 horas por predefinição, por isso um cliente que volta no dia seguinte toca num link inativo; crie um novo a pedido.
  • Confirmar o pagamento com texto livre dias depois. Fora das 24 horas após a última mensagem do cliente, a Meta recusa texto livre, por isso mantenha um template utility aprovado para as confirmações.
  • Acrescentar uma resposta fixa depois do webhook que devolve o link. Ambas são enviadas, pelo que o cliente recebe o link e uma segunda mensagem genérica.
Fazer isto com a EasyCoexistence

Nunca toca no dinheiro: os clientes pagam diretamente ao seu prestador, e a Meta cobra as mensagens à sua própria conta sem margem. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.

Perguntas frequentes

O easyCoexistence processa os pagamentos?

Não. O easyCoexistence envia o texto ou o template que contém o link, e o pagamento decorre entre o cliente e o seu prestador, como o Stripe, o Mercado Pago ou o PIX do seu banco. As taxas, as transferências para a sua conta, os reembolsos e os recibos ficam no painel do seu prestador.

Os clientes podem pagar sem sair do chat?

Não através de automações, que enviam texto e templates; por isso o cliente abre a página do prestador. As mensagens de pagamento nativas da Meta no chat existem apenas em alguns mercados e são enviadas pelo sistema da empresa através da Cloud API; consulte a documentação de pagamentos da Meta para o seu país.

Como é que o meu sistema sabe a que conversa pertence um pagamento?

Coloque contact.wa_id e o id da encomenda nos metadados do link ao criá-lo. Quando o prestador comunicar o pagamento, leia-os de volta para atualizar a encomenda e enviar a confirmação para o número certo.

Posso enviar um lembrete de pagamento a quem não escreve há dias?

Sim, como template aprovado enviado pelo seu sistema ou pela sua IA com send_template, já que texto livre é recusado fora das 24 horas após a última mensagem do cliente. Envie lembretes apenas a clientes que aceitaram recebê-los, e mantenha as promoções fora de um template utility.

Continue a ler

Pronto para começar?

Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.

Começar período experimental gratuito

Verificado em