Asaas + Verboo: Pix Confirmado no WhatsApp em 2s [Build]
Back to the blog
Artigo

Asaas + Verboo: Pix Confirmado no WhatsApp em 2s [Build]

Mafra
04/05/2026
6 min read

Às 22h37, um cliente manda o Pix. O dinheiro cai. Você não vê. Ele espera confirmação. Nada chega. Às 22h54 ele escreve no WhatsApp: "oi, já paguei, tudo certo?". Na manhã seguinte você responde. A experiência de compra que levou semanas para construir foi destruída em 17 minutos de silêncio.

Por Que Cobranças Manuais Custam Mais do Que Parecem?

79% dos brasileiros já se comunicaram com empresas pelo WhatsApp, segundo pesquisa OpinionBox/Mobile Time 2025. 62% fizeram compras direto no app. O canal está consolidado. O gargalo está no que acontece depois que o link de pagamento é enviado.

Em operações sem automação, o ciclo é: gerar link no Asaas, copiar, colar no WhatsApp, torcer para o cliente pagar, checar o painel de hora em hora, confirmar manualmente quando aparecer. Cada etapa manual é uma janela para atraso e perda de confiança.

Dado-chave: Empresas que automatizaram cobrança via WhatsApp reportam 300% mais cobranças pagas. O diferencial não é o Pix. É a confirmação imediata que chega antes do cliente perguntar.

O gargalo está nos dois extremos do fluxo: envio do link e confirmação de recebimento. Ambos podem ser automatizados com menos de 60 linhas de código.

O Que o WhatsApp Business AI Não Fecha

Em fevereiro de 2026, o WhatsApp lançou o Business AI no Brasil: um agente nativo e gratuito que aprende com o catálogo e responde perguntas. É um passo real. Mas tem um limite claro: sem acesso a webhooks externos, sem mensagens proativas e sem integração com o seu gateway de pagamento.

Ele responde "qual o prazo de entrega?" bem. Mas não detecta quando o pagamento entrou e não envia "seu pedido está confirmado!" automaticamente. Para fechar esse loop você precisa de uma camada que receba eventos do Asaas e dispare mensagens no WhatsApp com contexto. Isso é exatamente o que a integração Asaas + Verboo resolve.

Arquitetura da Integração em 3 Peças

O fluxo completo tem três componentes trabalhando em sequência:

  1. Asaas: gera a cobrança (Pix, boleto ou cartão) e dispara webhooks em cada evento de pagamento.
  2. Endpoint intermediário: recebe o webhook, valida o token e chama a Verboo API.
  3. Verboo: envia a mensagem proativa no WhatsApp do cliente com latência abaixo de 500ms.
Componente Responsabilidade Latência típica
Asaas Webhook Detecta pagamento e dispara evento Imediato ao pagamento
Endpoint (Flask) Valida e roteia o evento <50ms
Verboo API Envia mensagem WhatsApp ao cliente 280-410ms (p50)

Total: o cliente recebe a confirmação em menos de 2 segundos após o Pix ser processado.

Tutorial: Asaas + Verboo em 4 Passos

Passo 1: Crie o Assistente no Verboo

Acesse verboo.ai/lab, crie um novo Assistente e configure a Instrução na aba de configurações:

Você é o assistente de vendas e suporte da [empresa].
Quando receber confirmação de pagamento, responda de forma calorosa
e informe os próximos passos: prazo de entrega, código de rastreio, etc.
Tom: direto, amigável, profissional.
Se o cliente perguntar sobre status do pedido, confirme e ofereça ajuda adicional.

Na aba Integrações, conecte o canal de WhatsApp da sua empresa. Anote o ID do Assistente: você vai precisar dele no Passo 3.

Passo 2: Configure o Webhook no Asaas

No painel Asaas, acesse Minha Conta > Integrações > Webhooks e crie um novo webhook apontando para seu endpoint. Habilite os eventos:

  • PAYMENT_RECEIVED: Pix confirmado na hora
  • PAYMENT_CONFIRMED: cartão de crédito aprovado
  • PAYMENT_OVERDUE: cobrança vencida (para lembrete automático)

Copie o token de acesso gerado pelo Asaas. Ele é enviado como header em cada requisição para autenticar o webhook.

Passo 3: Escreva o Endpoint de Confirmação

Um endpoint Flask que recebe o evento, valida o token e dispara a mensagem via Verboo API:

import json, os, hmac
import requests
from flask import Flask, request, abort

app = Flask(__name__)

ASAAS_TOKEN    = os.environ["ASAAS_ACCESS_TOKEN"]
VERBOO_API_KEY = os.environ["VERBOO_API_KEY"]
VERBOO_ASST_ID = os.environ["VERBOO_ASSISTANT_ID"]

MENSAGENS = {
    "PAYMENT_RECEIVED":  "Pagamento de R${valor} confirmado! Pedido #{pedido} em processamento. Em breve você recebe o rastreio.",
    "PAYMENT_CONFIRMED": "Cartão aprovado! Pedido #{pedido} já está em produção.",
    "PAYMENT_OVERDUE":   "Olá! O pagamento do pedido #{pedido} está em aberto. Novo Pix disponível: {link}",
}

@app.route("/webhook/asaas", methods=["POST"])
def asaas_webhook():
    token = request.headers.get("asaas-access-token", "")
    if not hmac.compare_digest(token, ASAAS_TOKEN):
        abort(403)

    evento = json.loads(request.data)
    tipo   = evento.get("event")
    pgto   = evento.get("payment", {})

    if tipo not in MENSAGENS:
        return {"ok": True}

    telefone = pgto.get("externalReference", "")  # passe o telefone ao criar a cobrança
    valor    = pgto.get("value", "")
    pedido   = pgto.get("description", "")
    link     = pgto.get("invoiceUrl", "")

    mensagem = MENSAGENS[tipo].format(valor=valor, pedido=pedido, link=link)

    requests.post(
        f"https://api.verboo.ai/v1/assistants/{VERBOO_ASST_ID}/messages",
        headers={"Authorization": f"Bearer {VERBOO_API_KEY}"},
        json={"phone": telefone, "message": mensagem},
        timeout=5,
    )

    return {"ok": True}

if __name__ == "__main__":
    app.run(port=5001)

A chave da arquitetura está no campo externalReference: ao criar a cobrança no Asaas, passe o telefone do cliente no formato +5511999999999. Isso elimina a necessidade de um banco de dados só para mapear pagamento ao contato.

Passo 4: Teste e Deploy

Para testar localmente, use ngrok para expor a porta:

pip install flask requests
ngrok http 5001

Cole a URL HTTPS gerada no webhook do Asaas. Faça um pagamento de teste no ambiente sandbox e confirme a mensagem no WhatsApp. Para produção, Cloudflare Workers hospeda de graça até 100 mil requests diários, sem servidor para manter e com infraestrutura presente no Brasil.

O Que Muda Depois do Deploy

Com o loop fechado, cada pagamento confirmado vira um ponto de contato automático. O cliente sente que a empresa está presente, sem delay, sem operador. A Verboo mantém contexto nativo da conversa: se o cliente responder à confirmação com "quando chega?", o Assistente tem o histórico e responde com coerência.

O próximo passo natural para operações com maior volume é adicionar um Gatilho no Assistente Verboo para gerar a cobrança no Asaas diretamente do chat. O cliente pergunta o preço, recebe o Pix sem sair do WhatsApp, paga, recebe a confirmação. Tudo na mesma conversa. Esse é o checkout conversacional que pesquisas mostram converter 40-60% melhor do que páginas externas.

Cole esse código numa conta Verboo e seu agente já confirma Pix no WhatsApp em 2s. Crie sua conta grátis (login Google em 10s).

Enjoyed this article?
Share knowledge with your network.
Read also

Related articles