Vende, cobra y envía dentro de WhatsApp.
El comprador navega, hace preguntas y paga sin salir nunca del chat. Tu agente genera un QR Pix en la propia conversación, confirma el pago, emite la NF-e, contrata al transportista y devuelve el seguimiento al mismo hilo. Sin enlaces, sin redirecciones, sin app que instalar.
Todo el checkout ocurre en la burbuja del chat.
Sin redirección, sin página de pago, sin app. El agente cotiza, genera un QR Pix en la conversación, observa el webhook de liquidación y solo entonces emite la NF-e y contrata la etiqueta — todo dentro del mismo hilo de WhatsApp en el que ya estaba el comprador.
- QR Pix renderizado en el hilo — el comprador paga desde la app de su banco y vuelve enseguida
- La correlación de liquidación marca el pedido como pagado sin que nadie consulte el PSP a mano
- NF-e y seguimiento llegan a la misma conversación
La conversación es la parte fácil.
Buena parte del comercio brasileño ya pasa por WhatsApp, pero la conversación es la parte fácil. Lo difícil es la conciliación de Pix, la emisión de NF-e, las etiquetas del transportista y el fallback de PSP, todo cosido a mano y resuelto otra vez por cada equipo que lanza.
Mandar al comprador a un enlace de pago y rezar para que vuelva
Generar un QR Pix en la conversación con codespar_charge — pagado en el hilo
Consultar el webhook del PSP y conciliar el pago a mano
La correlación de liquidación marca el pedido como pagado automáticamente
Emitir la NF-e en un portal aparte después de cerrar la venta
codespar_invoice emite la NF-e en cuanto se confirma el pago
Copiar y pegar un código de seguimiento del panel del transportista
codespar_ship contrata la etiqueta y devuelve el seguimiento al chat
Un hilo. Todo el loop de comercio.
Tu agente corre la secuencia completa desde una sola sesión. Las meta-tools de CodeSpar comprimen cada proveedor — Asaas o Mercado Pago para Pix, NFe.io para el documento fiscal, Melhor Envio para la logística, Z-API para el canal — en verbos de comercio que el agente habla de forma nativa. NFe.io y Z-API no tienen ambiente de prueba: en un proyecto live, la NF-e se emite y el mensaje se envía de verdad.
codespar_chargeR$ 240 · QR Pix en el chat
AsaasPago correlacionado · pedido pagado
codespar_invoiceNF-e 00421 · PDF + XML
NFe.iocodespar_shipEtiqueta contratada · seguimiento enviado
Melhor EnvioTexto con el seguimiento en el hilo · solo live
Una sola sesión conecta el canal de WhatsApp al router de meta-tools. El agente emite intenciones de comercio (cobrar, facturar, enviar); el router resuelve cada una al proveedor que conectó el proyecto y la ejecuta por el proxy. El comprador solo ve la conversación.
El código, y lo que supone.
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a Pix provider // (Asaas or Mercado Pago) and Melhor Envio connected to the project. NFe.io and // Z-API have no test environment: the NF-e and the WhatsApp text need a live key. import { CodeSpar } from "@codespar/sdk"; const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); const buyer = { name: "Ana Souza", phone: "+5511999990000" }; // Buyer: "Quero 2 × SKU-ABX, pode ser no Pix?" const charge = await session.charge({ amount: 240, currency: "BRL", method: "pix", description: "2 × SKU-ABX", buyer }); console.log(charge.status, charge.pix_copy_paste); // the copia-e-cola for the thread // once paid: the shipping label at Melhor Envio const label = await session.ship({ action: "label", origin: { postal_code: "01310-100" }, destination: { postal_code: "20040-002" }, items: [{ description: "2 × SKU-ABX", weight_g: 1200 }], }); console.log(label.tracking_code);
Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.
codespar_chargeQR Pix en la conversación vía Asaas o Mercado Pago: el comprador paga desde la app de su banco.
codespar_invoiceNF-e emitida por NFe.io tras confirmar el pago, solo en proyectos live; devuelve los enlaces de PDF y XML.
codespar_shipContrata la etiqueta de Melhor Envio y devuelve el código de seguimiento al chat.
Agente de cuentas por pagar
De la factura a pagada, con aprobación solo sobre el tope
MarketplacesAgente de fulfillment autónomo
Cobrar, facturar, enviar y avisar un pedido con cuatro meta-tools
MarketplacesOrquestador de payouts transfronterizos
Pix en Brasil; en el exterior, USDC por el offramp de UnblockPay
Empieza con una clave de prueba.
Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.