Pagos

Visión general de Pagos

Visión general El módulo de Pagos convierte a Conversa Labs en un mostrador de cobro dentro de la propia atención. Con él conectas una pasarela (Asaas o Mercado Pago), creas cobros únicos, recurrentes o a partir de un negocio del CRM, y envías el enlace de pago directo en la conversación — con PIX (QR + copiar y pegar), boleto y tarjeta (checkout alojado). Todo ocurre sin salir de la plataforma: el cliente recibe el cobro en la misma ventana en la que habla contigo, paga, y el estado se actualiza automáticamente cuando la pasarela confirma el pago. No necesitas entrar al panel del banco para hacer seguimiento — Conversa Labs refleja pagado, vencido, reembolsado y cancelado en tiempo real. Requisitos previos - El módulo Pagos debe estar habilitado para tu cuenta. Es opcional y viene desactivado por defecto — pide a un administrador o al operador de la plataforma que lo active. - Una cuenta activa en una pasarela compatible: Asaas o Mercado Pago. - Permiso de administrador para conectar la pasarela y configurar webhooks. - Para cobrar desde el CRM o la Agenda, esos módulos también deben estar habilitados. Paso a paso 1. Asegúrate de que el módulo de Pagos esté habilitado para la cuenta. 2. Conecta una pasarela (Asaas o Mercado Pago) con tus credenciales y entorno — consulta Conectar pasarela. 3. Crea tu primer cobro (único, desde el catálogo o desde un negocio) y envíalo en la conversación. 4. Sigue el estado del cobro: pendiente, esperando pago, pagado, vencido o reembolsado. 5. Para ingresos recurrentes, configura suscripciones y planes. 6. Sigue los resultados en los informes (facturación, ticket medio, MRR y churn). Configuración y opciones - Pasarelas: conecta una o varias pasarelas; cada conexión tiene su propio entorno (producción o sandbox) y credenciales. - Métodos de pago: PIX, boleto y tarjeta vía checkout alojado. La disponibilidad de cada método depende de la pasarela elegida. - Cobros: únicos, con ítems (líneas de cobro), descuentos y ajuste de valor. - Suscripciones y planes: cobro recurrente delegado a la pasarela y reflejado en la plataforma. - Reembolsos: total o parcial, según el soporte de la pasarela. - Informes: facturación por estado, por pasarela y por moneda, ticket medio, MRR y churn. Casos de uso - Cerrar una venta en WhatsApp y enviar el PIX al instante, con QR y copiar y pegar. - Cobrar un servicio a partir de un negocio ganado en el CRM, sin volver a teclear valores. - Crear una suscripción mensual para un cliente recurrente. - Aplicar un descuento puntual a un cobro antes de enviarlo. - Exigir pago anticipado de una reserva en la Agenda (agendamiento pago). Consejos, límites y buenas prácticas - El módulo solo funciona con checkout alojado — la plataforma nunca captura datos de tarjeta, lo que te mantiene fuera del alcance PCI. - Los valores se tratan en unidades mayores (reales, no centavos): R$ 49,90 es 49.90. - El webhook es la fuente de verdad del estado: confía en él, no en la pantalla de "éxito" del checkout. - Mantén las credenciales de la pasarela al día; los tokens vencidos interrumpen nuevos cobros. Solución de problemas - No veo Pagos en el menú: el módulo no está habilitado para tu cuenta o tu perfil — habla con un administrador. - No puedo crear un cobro: verifica que haya una pasarela conectada y válida. - El estado no se actualiza: revisa la configuración del webhook en Reembolsos, webhooks e informes. Ver también - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Descuentos y ajuste de valor - Agendamiento pago - Reembolsos, webhooks e informes

Conectar pasarela: Asaas y Mercado Pago

Visión general Antes de cobrar a alguien, necesitas conectar una pasarela de pago. Conversa Labs admite Asaas y Mercado Pago. Cada conexión guarda las credenciales de la pasarela, define el entorno (producción o prueba) y registra un webhook — el canal por el que la pasarela avisa a la plataforma cuando un cobro se paga, vence o se reembolsa. Puedes tener más de una conexión (por ejemplo, un Asaas de producción y un Mercado Pago para otro flujo). Cada cobro se crea en una conexión específica. Requisitos previos - Módulo Pagos habilitado y permiso de administrador. - Una cuenta en la pasarela elegida: - Asaas: una clave de API (API Key) del panel de Asaas. - Mercado Pago: un Access Token y Client Secret de tus credenciales de aplicación. - Definir el entorno: producción (cobros reales) o sandbox (pruebas). Paso a paso 1. Abre la configuración de Pagos y elige agregar una nueva conexión. 2. Selecciona la pasarela: Asaas o Mercado Pago. 3. Ingresa las credenciales: - Asaas: pega la API Key. - Mercado Pago: pega el Access Token (y el secreto de firma usado para validar el webhook). 4. Elige el entorno: producción o sandbox. 5. Guarda. La plataforma valida las credenciales con la pasarela. 6. Configura el webhook: la plataforma genera la URL de notificación y el secreto de verificación. En muchos casos el registro es automático; cuando no lo sea, copia la URL indicada y regístrala en el panel de la pasarela. 7. Haz una prueba en sandbox (un cobro PIX, por ejemplo) y confirma que el estado cambia solo cuando se simula el pago. Configuración y opciones - Entorno: producción o sandbox por conexión. No mezcles credenciales de entornos distintos. - Webhook: la URL es única por conexión y la pasarela autentica cada notificación: - Asaas envía un token propio en el encabezado de la solicitud, comparado de forma segura con el que la plataforma guardó. - Mercado Pago firma cada notificación; la plataforma valida la firma antes de procesar. - Diagnóstico de la última conciliación: la comprobación programada compara cobros y suscripciones con la pasarela para cubrir notificaciones perdidas. Si falla algún registro, la tarjeta de la conexión en Configuración → Pagos → Conexiones permanece roja con la cantidad total y hasta los tres primeros identificadores externos y motivos. Los demás registros siguen procesándose; las respuestas brutas, los datos del cliente y las credenciales nunca aparecen en este diagnóstico. - Métodos admitidos por pasarela: | Capacidad | Asaas | Mercado Pago | |---|---|---| | PIX | Sí | Sí | | Boleto | Sí | Sí | | Tarjeta (checkout alojado) | Sí | Sí | | Cuotas | Sí | Sí | | Suscripciones | Sí | Sí | | Planes reutilizables | — | Sí | | Reembolso parcial | Sí | Sí | Casos de uso - Un operador que ya usa Asaas conecta la clave y empieza a cobrar por WhatsApp sin cambiar de sistema. - Una empresa que vende en América Latina conecta Mercado Pago. - Un equipo que quiere probar antes de cobrar de verdad usa el entorno sandbox primero. Consejos, límites y buenas prácticas - Trata las credenciales como secreto: se almacenan cifradas y nunca vuelven a mostrarse en pantalla después de guardarlas. - Usa sandbox para validar todo el flujo antes de pasar a producción. - La autenticación de Asaas usa un encabezado access_token (no Authorization: Bearer). - Mercado Pago notifica solo el identificador del pago; la plataforma consulta la pasarela para leer el estado completo — esto es normal. Solución de problemas - Credenciales inválidas: verifica que copiaste la clave/token correctos y que el entorno coincide con el de la pasarela (un token de prueba solo funciona en sandbox). - El estado no se actualiza: el webhook no está llegando. Confirma que la URL esté registrada en la pasarela y que el secreto de verificación coincida. - Notificación rechazada (401): la firma/token del webhook no coincide — vuelve a registrar el webhook. - La última conciliación tuvo fallos: anota el identificador y el motivo mostrados en la tarjeta, valida la conexión y el entorno y confirma que el registro todavía existe en la pasarela. Un fallo permanece visible y nunca modifica silenciosamente el registro local. La siguiente comprobación sustituye el diagnóstico; la alerta desaparece solo después de una ejecución sin fallos. Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Reembolsos, webhooks e informes

Crear un cobro y enviarlo en la conversación

Visión general El cobro es el corazón del módulo. Creas un cobro con valor, descripción e ítems, eliges el método (PIX, boleto o tarjeta vía checkout alojado) y lo envías directo en la conversación. El cliente recibe una tarjeta de pago en la propia ventana — con el QR y el copiar y pegar del PIX, la línea del boleto o el enlace del checkout — y el estado se actualiza cuando la pasarela confirma. Hay tres formas de iniciar un cobro: único (tecleas los valores), desde el catálogo (eliges productos listos) o desde un negocio del CRM (reutilizas el valor ya registrado). Requisitos previos - Una pasarela conectada y válida (consulta Conectar pasarela). - Para cobrar desde el catálogo, el módulo de Catálogo habilitado con productos registrados. - Para cobrar desde un negocio, el módulo de CRM habilitado y un negocio con valor. - Un contacto con datos mínimos (nombre y, idealmente, correo y teléfono) para el cliente de la pasarela. Paso a paso 1. En una conversación, abre la acción de crear cobro (o créalo desde el área de Pagos). 2. Elige el origen del valor: - Único: ingresa valor, descripción y, si quieres, ítems (líneas de cobro). - Catálogo: selecciona los productos; el valor se suma automáticamente. - Negocio: selecciona un negocio del CRM; el valor se reutiliza. 3. Selecciona el método de pago: PIX, boleto o tarjeta (checkout alojado). 4. (Opcional) Aplica un descuento o ajusta el valor — consulta Descuentos y ajuste de valor. 5. Define el vencimiento, cuando aplique. 6. Crea el cobro. La plataforma genera el PIX (QR + copiar y pegar), el boleto (línea) o el enlace del checkout, según el método. 7. Envíalo en la conversación: la tarjeta de pago aparece para el cliente en la misma ventana. En pagos PIX, la etiqueta y el código aparecen separados para facilitar la lectura; incluso un código largo permanece dentro de la tarjeta. Usa la acción de copiar para llevar el código completo. 8. Observa el estado pasar de pendiente a pagado automáticamente cuando la pasarela confirme. Configuración y opciones - Métodos: PIX (QR + copiar y pegar), boleto (línea/PDF) y tarjeta vía checkout alojado — la plataforma nunca pide el número de tarjeta. - Ítems (líneas de cobro): describe cada producto/servicio con cantidad y valor; el total es la suma de las líneas. - Vencimiento: fecha límite para PIX/boleto. - Opciones avanzadas de Asaas: puedes definir multa e interés en porcentaje y descuento por pago anticipado en el cobro; el envío impreso por correo aparece solo para boleto. Esta condición de pago no sustituye al descuento comercial aplicado al importe. Deja multa e interés vacíos para conservar los valores predeterminados de la cuenta; introduce 0 para desactivarlos explícitamente en ese cobro. - Retorno de Asaas: introduce una URL HTTPS pública para devolver al pagador a tu sitio. La redirección automática solo se envía cuando existe una URL válida. - Checkout de Mercado Pago: en tarjeta alojada, elige el límite de cuotas y, si hace falta, URLs HTTPS públicas separadas para pagos aprobados, rechazados y pendientes. El retorno automático requiere la URL de aprobado. - Control por conexión: la pantalla solo muestra capacidades anunciadas por la pasarela elegida. La API también rechaza opciones incompatibles; ocultar un control no es la única protección. - Marcar como pagado manualmente: registra pagos recibidos por fuera (cuando la pasarela lo admita) para mantener el historial coherente. - Reenviar: puedes reenviar la tarjeta de pago en la conversación en cualquier momento. - Datos del pagador automáticos: el documento y la dirección vienen de los datos nativos del contacto (el documento viene precargado para que lo verifiques; la dirección de facturación tiene prioridad sobre la principal). Complétalos una vez en el contacto y no los vuelvas a escribir — mira Datos fiscales y dirección del contacto. Ver detalles e historial En la lista de cobros, haz clic en el cliente para abrir el detalle, incluso para cobros Pix o registrados manualmente que no tienen una página de pago alojada. La acción principal sigue lo que el cobro realmente permite: copiar el código Pix, abrir el boleto/checkout o, cuando Asaas lo permita y el cobro esté abierto, marcarlo como pagado manualmente con una justificación. El historial muestra primero los eventos más recientes, identifica al operador o al sistema/gateway y presenta la justificación registrada. Los historiales largos están paginados; cambiar de página no modifica el cobro. Usa esta línea de tiempo para revisar creación, actualización, pago, vencimiento, cancelación y reembolso sin depender solamente del estado actual. Casos de uso - Cerrar la venta en WhatsApp y mandar el PIX al instante. - Armar un cobro con varios ítems desde el catálogo. - Cobrar un negocio ganado en el CRM sin volver a teclear el valor. - Ofrecer al cliente elegir entre PIX y tarjeta. Consejos, límites y buenas prácticas - Si la red falla después del envío, vuelve a intentarlo desde el mismo formulario abierto: conserva la clave de la operación y recupera el cobro existente en lugar de cobrar dos veces al cliente. - Los valores van en unidades mayores (R$ 49,90 = 49.90); el total es la suma de precio × cantidad de las líneas — nunca dividas por 100. - La tarjeta siempre pasa por el checkout alojado de la pasarela: cero datos de tarjeta en la plataforma. - Confirma el nombre y el contacto del cliente antes de crear — la pasarela usa esos datos para identificar al pagador. - No confíes en la pantalla de "éxito": el estado real llega por el webhook. - Usa solo URLs HTTPS públicas para el retorno. No incluyas tokens, contraseñas ni otros secretos. Solución de problemas - Error al crear el cobro: verifica que la pasarela esté conectada y que el contacto tenga los datos mínimos. - El cliente no recibió el PIX: reenvía la tarjeta de pago en la conversación. - Pagado pero sigue pendiente: revisa la configuración del webhook (consulta Reembolsos, webhooks e informes). - Recurso no disponible (p. ej., tarjeta): puede ser una limitación de la pasarela elegida — consulta la matriz de capacidades en Conectar pasarela. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Descuentos y ajuste de valor - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes

Suscripciones y planes recurrentes

Visión general Para ingresos que se repiten (mensualidades, planes de servicio, retainers), usa suscripciones. Defines el valor y el ciclo (semanal, mensual, anual, etc.), y la pasarela genera los cobros recurrentes automáticamente. Conversa Labs refleja cada cobro generado y el estado de la suscripción (activa, pausada, cancelada), además de alimentar los indicadores de MRR y churn en los informes. También puedes usar planes locales reutilizables: guardan conexión, importe, moneda y ciclo para varios suscriptores. Al crear cada suscripción, la plataforma envía la recurrencia a la pasarela; tener un plan local no significa que ya exista una entidad de plan en el panel de la pasarela. Requisitos previos - Una pasarela conectada que admita suscripciones (Asaas y Mercado Pago las admiten). - Para usar un plan reutilizable, mantén activa su conexión vinculada. La moneda del plan debe coincidir con la moneda de liquidación de esa conexión. - Un contacto/cliente con datos válidos en la pasarela. Paso a paso 1. En el área de Pagos, elige crear una suscripción. 2. Selecciona la pasarela (la conexión) y el cliente (contacto). 3. Define el valor y el ciclo de cobro (por ejemplo, mensual). 4. Define la fecha del próximo cobro y el método (PIX, boleto o tarjeta, según la pasarela). 5. (Opcional, Asaas) Define un número máximo de cobros o una fecha final. El ciclo cada dos meses también aparece cuando la conexión lo admite. 6. (Opcional) Selecciona un plan local. La conexión, el importe, la moneda y el ciclo se completan y bloquean para mantener la suscripción coherente con la plantilla elegida. 7. Guarda. La pasarela empieza a generar los cobros en el ciclo definido. 8. Sigue cada cobro generado y el estado de la suscripción en la plataforma; el cliente recibe el cobro normalmente. Configuración y opciones - Ciclo: semanal, quincenal, mensual, cada dos meses (Asaas), trimestral, semestral o anual. La pantalla solo muestra los ciclos admitidos por la conexión. - Límites de Asaas: número máximo de cobros termina tras una cantidad de ciclos; fecha final termina en el límite elegido y no puede ser anterior al primer cobro. También puedes ajustar la fecha final después en Editar suscripción; el máximo de cobros se define al crearla. - Una suscripción no es un pago en cuotas: la pasarela cobra el importe una vez por ciclo. Para dividir una compra única en cuotas, crea un cobro único con tarjeta. - Estado de la suscripción: activa, pausada, cancelada — reflejado desde las notificaciones de la pasarela. - Planes locales: crea una plantilla una vez y reutilízala en suscripciones compatibles. La pasarela sigue recibiendo y ejecutando cada suscripción. - Cancelación: cancela la suscripción en la plataforma; la pasarela detiene los próximos cobros. - Cobros generados: cada ciclo se convierte en un cobro reflejado, con su propio estado. Casos de uso - Mensualidad de un servicio de suscripción. - Plan recurrente de soporte o consultoría (retainer). - Club/suscripción de contenido con renovación automática. Consejos, límites y buenas prácticas - Si la red falla durante la creación, vuelve a intentarlo sin cerrar el formulario: se retoma la misma operación y una respuesta incierta de la pasarela nunca crea otra suscripción a ciegas. - La recurrencia se delega a la pasarela — ella genera y cobra cada ciclo; la plataforma refleja el resultado. - Usa planes locales cuando muchos clientes se suscriben a la misma oferta: facilita mantener conexión, precio, moneda y ciclo consistentes. - El MRR de los informes normaliza cada suscripción activa a un valor mensual equivalente; el churn considera las canceladas en el período. - Comunica claramente al cliente el ciclo y el valor antes de activar la suscripción. Solución de problemas - El próximo cobro no se generó: confirma el estado de la suscripción (puede estar pausada o cancelada) y la configuración del webhook. - Los planes no aparecen: confirma que el plan no está archivado, que su conexión está activa y admite suscripciones, y que la moneda coincide con la moneda de liquidación. - Cancelé y aún cobró: verifica que la cancelación fue confirmada por la pasarela; el efecto aplica a los próximos ciclos. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Descuentos y ajuste de valor - Reembolsos, webhooks e informes

Gestionar planes y ofertas de pago

Visión general El módulo Pagos ofrece dos catálogos reutilizables: - Planes guardan conexión, importe, moneda y ciclo para nuevas suscripciones. - Ofertas guardan precio, método de pago, tipo y vínculos opcionales con una conexión y un producto. La pantalla de Ofertas es administrativa. Nunca acepta una oferta ni crea un cobro sin el contexto de un contacto o una compra. Requisitos previos - Pagos debe estar habilitado para la cuenta. - Ten al menos una conexión activa de Asaas o Mercado Pago para crear planes. - Para vincular una oferta, crea primero el producto en Catálogo. - La eliminación permanente requiere permiso de administración de pagos. Paso a paso 1. Abre Pagos en el menú lateral. 2. Entra en Planes u Ofertas. 3. Usa búsqueda, filtros y ordenación para encontrar registros. La página y los filtros permanecen en la URL. 4. Haz clic en Nuevo plan o Nueva oferta, completa los campos y guarda. 5. Archiva un registro para retirarlo del uso. Abre Archivados para restaurarlo o, con el permiso necesario, eliminarlo definitivamente. 6. Para varias filas, selecciona los registros de la página y usa la barra de acciones masivas. Si una fila falla, revisa los IDs mostrados y corrige solo esas filas. 7. Al crear una suscripción, selecciona el plan opcional. La pantalla completa y bloquea conexión, importe, moneda y ciclo para que la suscripción coincida con la plantilla. 8. Usa Exportar CSV para descargar el resultado filtrado actual o, si hay una selección, solo los registros seleccionados, incluidos los conservados al cambiar de página. Configuración y opciones Planes Un plan es una plantilla local; no afirma que ya exista como entidad en la pasarela. La recurrencia real se crea en la pasarela solo cuando comienza una suscripción. La moneda debe coincidir con la moneda de liquidación de la conexión, y los ciclos visibles respetan sus capacidades; por ejemplo, el ciclo de cada dos meses aparece únicamente cuando la pasarela lo admite. Ofertas Elige order bump, upsell o downsell. La conexión puede usar la predeterminada de la cuenta y el producto es opcional. Al archivar una oferta se desactiva; al restaurarla permanece inactiva hasta que se revise y habilite de nuevo. Casos de uso - Reutilizar una cuota en varias suscripciones. - Ofrecer instalación, soporte prioritario o un complemento durante el checkout. - Mantener ofertas estacionales inactivas sin perder su configuración. - Separar ofertas por producto, conexión, tipo o estado. Consejos, límites y buenas prácticas - Confirma la moneda de liquidación de la conexión antes de publicar precios. - Archiva antes de eliminar definitivamente. La eliminación permanente no se puede deshacer. - Restaurar una oferta no la activa automáticamente; revisa primero precio, producto y conexión. - Una acción masiva se procesa registro por registro. Es normal obtener un resultado parcial si una fila incumple una regla de ciclo de vida. Solución de problemas - No aparece el ciclo de cada dos meses: la conexión seleccionada no anuncia esa capacidad. - No aparece un método de pago: la conexión elegida no lo admite. - No puedo eliminar: archiva primero el registro y confirma que tu perfil permite la eliminación permanente. - La lista quedó vacía tras filtrar: usa Limpiar filtros; también puedes quitar el estado de la URL. - La oferta restaurada está inactiva: es el comportamiento seguro. Edítala y actívala después de revisarla. Ver también - Crear cobros y enviarlos en una conversación - Suscripciones y planes

Descuentos y ajuste de valor

Visión general Puedes reducir el valor de un cobro o suscripción aplicando descuentos. El descuento puede ser por línea de cobro (en un ítem específico) o sobre el total de la transacción. El valor enviado a la pasarela es siempre el valor neto — es decir, el subtotal menos el descuento. Los proveedores de pago no se modifican; solo reciben el valor final ya calculado. Opcionalmente, tu cuenta puede exigir un motivo al aplicar un descuento, para mantener historial y control de quién otorgó cada reducción. Requisitos previos - Módulo Pagos habilitado y una pasarela conectada. - Permiso para crear/editar cobros y suscripciones. - Si tu conexión exige motivo del descuento, ten la justificación a mano. Paso a paso 1. Al crear (o editar) un cobro o suscripción, ubica el campo de descuento. 2. Elige dónde aplicarlo: - Por ítem: ingresa el descuento en la línea de cobro correspondiente. - Sobre el total: ingresa el descuento sobre la suma de las líneas. 3. Define el valor del descuento. 4. Si se solicita, ingresa el motivo del descuento. 5. Revisa el valor final (subtotal − descuento) antes de guardar. 6. Guarda y, en el caso de un cobro, envíalo en la conversación normalmente. Configuración y opciones - Descuento por ítem vs. descuento sobre el total: combina ambos cuando lo necesites — el total refleja la suma de las reducciones. - Exigir motivo del descuento: una opción por conexión; cuando está activa, el descuento solo se acepta con justificación. - Valor neto: la pasarela siempre recibe el valor con el descuento ya aplicado; no hay cálculo posterior del lado del proveedor. - Informes: el total de descuentos otorgados aparece en los informes de Pagos. Casos de uso - Otorgar un descuento puntual para cerrar una venta. - Aplicar una reducción a un ítem específico de un cobro con varios productos. - Ofrecer un valor promocional en una suscripción. - Mantener trazabilidad de quién otorgó cada descuento exigiendo un motivo. Consejos, límites y buenas prácticas - El descuento reduce el valor neto enviado a la pasarela — revisa el total antes de enviar. - Estandariza los motivos de descuento para facilitar el análisis en los informes. - Para seguir el impacto, usa la métrica de descuentos otorgados y el ticket medio en los informes. - Recuerda: los valores van en unidades mayores (R$ 10,00 = 10.00). Solución de problemas - No puedo guardar sin motivo: tu conexión exige justificación — completa el motivo del descuento. - El total no cuadró: verifica si hay descuentos por ítem y sobre el total al mismo tiempo; el valor final es el subtotal menos la suma de los descuentos. - El descuento no aparece en la pasarela: el proveedor solo recibe el valor neto; el detalle del descuento queda en la plataforma. Ver también - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes - Visión general de Pagos

Condiciones de pago y simulación de cuotas

Visión general Un cobro tiene más decisiones que solo el importe. Condiciones de pago reúne todo lo que cambia cuánto paga el cliente y cuánto recibe tu empresa: - Multa por demora — se cobra una vez, cuando el cobro vence sin pagarse. - Intereses mensuales — se acumulan mientras el cobro sigue vencido. - Descuento por pago anticipado — una reducción si el cliente paga antes de una fecha. - Cuotas y quién paga los intereses — la empresa asume el costo, o lo paga el cliente. Y la simulación responde, antes de cobrar, las dos preguntas que importan: ¿cuánto paga el cliente por mes? y ¿cuánto recibes? Requisitos previos - Una conexión de pasarela activa en Pagos → Configuración. - Las condiciones dependen de la pasarela. Asaas acepta multa, intereses y descuento por pago anticipado; Mercado Pago no expone esos campos, así que no aparecen en una conexión Mercado Pago. - Las cuotas existen solo en cobros únicos con tarjeta de crédito. Las suscripciones cobran un importe por ciclo — ninguna de las dos pasarelas divide una recurrencia en cuotas. Paso a paso Definir el valor predeterminado de la cuenta 1. Ve a Pagos → Configuración → Conexiones y edita la conexión. 2. En Intereses de las cuotas, elige quién paga: - La empresa los asume — el cliente paga el importe del cobro dividido en cuotas y la comisión de la pasarela sale de tu neto. Es el comportamiento predeterminado. - Los paga el cliente — se añaden intereses a cada cuota para que recibas el importe completo. 3. Si eliges Los paga el cliente, indica la tasa mensual. En blanco, usamos la tabla de comisiones de la propia pasarela — y la ayuda debajo del campo muestra a cuánto equivale por mes en la cantidad de cuotas elegida, antes de que decidas sobrescribirla. 4. Guarda. Cada cobro nuevo nace con esa elección — y cada cobro puede cambiarla. Aplicar condiciones a un cobro 1. Abre Nuevo cobro y elige la forma de pago. 2. En el bloque Opciones de la pasarela, completa multa, intereses y descuento por pago anticipado. 3. En la multa y el descuento, elige entre Porcentaje e Importe fijo. La etiqueta del campo cambia con la elección: Multa por demora (%) o Multa por demora (Importe fijo). 4. Si es tarjeta de crédito, elige la cantidad de cuotas. El bloque Simulación aparece debajo. Leer la simulación El bloque muestra dos columnas: - El cliente paga — por ejemplo 12x de R$ 83,08 (última de R$ 83,12) y el total. La última cuota lleva el resto de la división; así es como la pasarela divide el importe. - Recibes — el neto después de la comisión de la pasarela, con la comisión detallada debajo. Cuando la pasarela confirma la simulación, aparece la etiqueta Confirmado por la pasarela. Configuración y opciones | Condición | Asaas | Mercado Pago | |---|---|---| | Multa por demora (% o importe fijo) | Sí | No | | Intereses mensuales | Sí | No | | Descuento por pago anticipado | Sí | No | | Las tres en una suscripción | Sí | No | | Elegir quién paga los intereses de las cuotas | Sí | No — la empresa siempre los asume | | Máximo de cuotas | 21 | 36 | | Mostrar el neto antes del pago | Sí | No | Dejar un campo en blanco no es lo mismo que poner cero: en blanco, el cobro hereda el valor predeterminado configurado en el panel de la pasarela; con cero, lo sobrescribe a ninguna multa. Casos de uso - Servicio recurrente con demoras frecuentes: multa del 2% + 1% de interés mensual en la suscripción. Cada cobro que genere la recurrencia hereda la política. - Producto de ticket alto: 12x con los paga el cliente, para recibir el importe completo. - Incentivo a pagar antes: 5% de descuento hasta 3 días antes del vencimiento. - Multa en dinero: R$ 10,00 fijos en lugar de un porcentaje, en cobros de importes muy distintos. Consejos, límites y buenas prácticas - Una multa o descuento de importe fijo nunca puede superar el propio cobro. - Un porcentaje nunca pasa de 100. - Si eliges Los paga el cliente sin tasa mensual y sin la tabla de comisiones de la pasarela disponible, el cobro se rechaza con un mensaje que pide la tasa — en lugar de cobrarle a tu empresa en silencio. - Al editar un cobro pendiente, las condiciones también viajan a la pasarela. Vaciar todos los campos elimina la política del cobro. - La simulación es una estimación hasta que aparece la etiqueta de confirmación. Cuando la pasarela no informa el neto (Mercado Pago), la pantalla lo dice — nunca mostramos un número estimado ahí. Solución de problemas "No se pudo calcular la simulación en este momento." Una indisponibilidad momentánea de la pasarela. Usa Intentar de nuevo; el cobro se puede crear igualmente. "Esta pasarela no informa el importe neto antes del pago." Es lo esperado en Mercado Pago. Lo que paga el cliente sigue siendo correcto; el neto solo se conoce después de la liquidación. "No pudimos leer la tabla de comisiones de esta cuenta en la pasarela ahora mismo." La lectura falló: una credencial rechazada, una caída o una respuesta inesperada de la pasarela. Usa Leer las comisiones de nuevo ahí mismo: no se guarda nada cuando la lectura falla, así que el botón consulta la pasarela de verdad. Guardar la conexión de nuevo también fuerza una nueva lectura. No aparecen las opciones de multa e intereses. La conexión es Mercado Pago, que no ofrece esos campos. No aparece el campo de cuotas. Las cuotas existen solo en cobros únicos con tarjeta de crédito. Ver también - Descuentos y ajuste de importe - Crear un cobro y enviarlo en la conversación - Suscripciones y planes - Conectar una pasarela

Agendamiento pago

Visión general El agendamiento pago conecta la Agenda con el módulo de Pagos: el cliente solo confirma una reserva después de pagar. Cuando alguien agenda un tipo de evento marcado como pago, la plataforma crea un cobro automáticamente (un PIX, por ejemplo), retiene el horario mientras el pago está pendiente y confirma la reserva sola cuando la pasarela avisa que se pagó. Es ideal para consultas, sesiones y servicios en los que quieres asegurar el compromiso del cliente con un pago anticipado — reduciendo ausencias y no-shows. Requisitos previos - Módulos Agenda y Pagos habilitados. - Una pasarela conectada y válida. - Un tipo de evento (en la Agenda) configurado para cobrar — con valor y modo de pago. Paso a paso 1. En la Agenda, abre el tipo de evento que debe exigir pago. 2. Define el modo de pago del tipo de evento (por ejemplo, un pago único para liberar la reserva). 3. Ingresa el valor de la reserva y el método (PIX, boleto o tarjeta, según la pasarela). 4. Guarda el tipo de evento. 5. Cuando un cliente agende ese tipo de evento, la plataforma crea el cobro y deja la reserva esperando pago. 6. El cliente paga; la pasarela notifica y la reserva pasa a confirmada automáticamente. 7. Sigue tanto el cobro (en Pagos) como la reserva (en la Agenda). Configuración y opciones - Modo de pago por tipo de evento: definido en la Agenda (por ejemplo, pago anticipado obligatorio). - Reserva esperando pago: el horario queda reservado/retenido hasta la confirmación; las reservas no pagadas pueden expirar según la regla configurada. - Confirmación automática: la reserva pasa a confirmada al recibir el evento de pago de la pasarela — sin acción manual. - Método de cobro: PIX, boleto o tarjeta, según la pasarela conectada. Casos de uso - Un consultorio que exige pago por adelantado de las consultas. - Un profesional que cobra una seña para reservar un horario. - Servicios de alta demanda donde el pago anticipado asegura el compromiso. Consejos, límites y buenas prácticas - Usa PIX para liberar la reserva más rápido (confirmación casi inmediata). - Deja claro en la descripción del tipo de evento que el horario solo se confirma tras el pago. - Define un plazo razonable para la reserva pendiente, evitando retener horarios demasiado tiempo. - La confirmación depende del webhook de la pasarela; mantenlo configurado correctamente. Solución de problemas - La reserva no se confirma tras el pago: verifica el webhook de la pasarela (consulta Reembolsos, webhooks e informes). - No aparece la opción de cobrar en el tipo de evento: confirma que los módulos Agenda y Pagos estén habilitados y que haya una pasarela conectada. - El horario se liberó sin pago: revisa el modo de pago del tipo de evento (debe exigir pago anticipado). Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes

Importar historial de la pasarela con seguridad

Visión general La importación de historial trae a Conversa Labs cobros, vínculos de clientes y suscripciones que ya existen en la pasarela. Los cobros crean eventos financieros, Pedidos e informes; las suscripciones aparecen en Pagos > Suscripciones; y un cliente importado solo crea un vínculo técnico con un contacto que ya existe en la cuenta. El proceso está gobernado: una vista previa no guarda cobros, vínculos ni suscripciones; solo persiste la ejecución auditada y la captura usada para revisar la selección. Una importación real incluye únicamente los registros que selecciones. La plataforma nunca crea contactos ni empresas silenciosamente: un cobro sin coincidencia exacta queda bloqueado hasta que elijas un contacto existente o propongas uno nuevo, que solo se crea tras la confirmación final. Cuando el cobro y la suscripción tienen el mismo identificador de suscripción de la pasarela, también se vinculan entre sí aunque los importes en un orden u otro. Los cobros históricos no envían mensajes al cliente, conversiones publicitarias, comisiones ni webhooks de salida. Requisitos previos - Debes ser administrador de la cuenta. - La conexión de Asaas o Mercado Pago debe estar activa y con credenciales verificadas. - Para cobros de Mercado Pago, elige una fecha inicial dentro de los últimos 12 meses. La búsqueda completa de ese recurso sigue esa ventana móvil. - Para clientes de Mercado Pago, informa el correo electrónico del cliente. Su API documentada no ofrece un barrido total de clientes. - Revisa la marca de agua de importación antes de permitir la adopción automática de cobros desconocidos por webhook. Paso a paso 1. Ve a Configuración > Pagos > Conexiones y elige Importar historial en la conexión necesaria. También puedes abrir la acción desde el estado vacío de Cobros. 2. En Recurso para importar, elige Cobros, Vínculos de clientes o Suscripciones. Las protecciones de entrada y la adopción automática se aplican solo a los cobros. 3. Para cobros, configura la marca de agua y mantén la adopción automática desactivada salvo que tu operación tenga una regla clara. “Solo desde la marca de agua” exige una marca válida. 4. Indica el período y el límite de registros. Para un cliente de Mercado Pago, informa también el correo. Elige Generar vista previa. 5. Revisa la lista detallada. Cada cobro muestra los datos del cliente proporcionados por la pasarela, el contacto encontrado y la señal exacta usada para asociarlo. Busca por identificador, referencia o cliente; combina filtros; cambia el orden y recorre las páginas sin perder selecciones realizadas en otras páginas. 6. En un cobro marcado como Cliente pendiente, elige un contacto existente o propón uno nuevo con nombre y al menos un identificador (correo, teléfono o documento). La propuesta no crea nada durante la vista previa. Las coincidencias automáticas usan solo cliente de pasarela, correo, teléfono normalizado o documento exactos; un nombre parecido nunca basta. 7. Usa Seleccionar importables de esta página, Seleccionar todos los importables de estos filtros (cuando la vista previa supera una página) o marca cada fila. La selección global abarca todas las páginas del recorte actual, pero solo alcanza registros importables con cliente resuelto: una fila ignorada, ya sincronizada o pendiente nunca se marca. Cambiar un filtro limpia la selección intencionalmente; cambiar de página la conserva. La conexión, la ejecución, los filtros y el orden quedan en la URL, por lo que volver, avanzar o reabrir el enlace restaura la misma vista solo cuando la conexión pertenece a la cuenta actual. 8. Elige Importar seleccionados, revisa la cantidad exacta y las resoluciones de cliente en la confirmación y confirma. Una selección vacía nunca significa “importar todo”. Los contactos propuestos se crean dentro de la importación confirmada; si una validación falla, el cobro correspondiente no entra sin contacto. 9. Sigue el resultado y el historial de la conexión. Los registros con fallos muestran su identificador y motivo; el éxito nunca incluye una fila que falló. Configuración y opciones Marca de agua y adopción automática La marca de agua limita la entrada de historial. La adopción automática de cobros recibidos por webhooks está desactivada de forma predeterminada. Si habilitas la adopción desde la marca de agua, la plataforma falla de forma segura cuando falta o es inválida. Lista de la vista previa La vista previa es una captura segura de la misma ejecución que importaría los datos, sin guardar cobros, vínculos ni suscripciones. La lista usa paginación y totales del servidor; el contador no se calcula solo con la página visible. En pantallas pequeñas, los filtros y el orden se abren en un panel propio y cada fila se convierte en una tarjeta legible. Los chips muestran los filtros activos. Limpiar filtros está disponible cuando una combinación no encuentra resultados. Si se alcanza el límite solicitado, la vista previa informa que fue truncada: genera otra ventana en lugar de asumir que se leyó todo el historial. Registros ignorados En una vista previa, usa el icono de bloqueo junto a un registro para ignorarlo permanentemente e indica el motivo. La decisión se separa por cobro, cliente o suscripción, incluso si la pasarela reutiliza un identificador. En Registros ignorados permanentemente, usa Permitir nuevamente para deshacerla. Vínculos con contactos y empresas La plataforma busca primero coincidencias exactas por cliente de pasarela, correo, teléfono normalizado, documento y CNPJ. Para un cobro sin contacto, debes elegir manualmente un contacto de la cuenta o proponer uno nuevo antes de seleccionarlo. La creación se aplaza hasta la confirmación y un vínculo manual nunca se sustituye silenciosamente. Una suscripción sin contacto sigue visible para una conciliación posterior; un cliente del directorio sin contacto se omite porque no hay propietario local seguro para el vínculo. Los cobros y las suscripciones se conectan solo por el identificador exacto informado por la pasarela, nunca por importe, fecha o nombre. Casos de uso - Recuperar cobros, Pedidos y suscripciones después de conectar una pasarela que ya tenía ventas. - Importar primero los vínculos de clientes de Asaas y después las suscripciones para aumentar la asociación exacta por identificador de la pasarela. - Reconstruir informes internos sin notificar a los clientes sobre transacciones antiguas. - Excluir permanentemente un cobro que pertenece a otra operación o que no es una venta. - Importar primero un período pequeño, validar la vista previa y continuar en ventanas menores. Consejos, límites y buenas prácticas - Empieza con una ventana corta y un límite bajo; amplía solo después de revisar la vista previa. - Cada vista previa/importación y cada selección explícita aceptan como máximo 5.000 registros. - Una importación confirmada debe usar exactamente el mismo tipo de recurso, período, límite y correo de la vista previa completada. Si cambia cualquier parámetro, genera una nueva vista previa; esto se aplica a cobros, clientes y suscripciones. - La selección es obligatoria. La plataforma nunca interpreta una selección vacía como “importar todo”. - La selección se conserva al paginar y Seleccionar todos abarca todas las páginas de los filtros actuales, pero se limpia al cambiar la búsqueda o los filtros para evitar importar por error una fila que ya no está visible. - Los cobros sin contacto resuelto no pueden seleccionarse. Resuelve cada uno manualmente; la API también bloquea intentos de omitir la vista previa. - La lista de registros ignorados se carga completa mediante páginas internas; más de 100 exclusiones nunca desaparecen silenciosamente. - Los clientes no usan filtros por fecha y solo pueden vincular un contacto existente. La búsqueda de clientes de Mercado Pago siempre se dirige por correo. - Los totales se muestran por moneda; no sumes monedas distintas como un único importe. - La reversión elimina solo registros locales creados por esa ejecución. Nunca cambia la pasarela. - Para revertir, abre una ejecución elegible en el historial, escribe undo y confirma. Si un movimiento posterior de un cobro, vínculo de cliente, suscripción, Pedido o evento cambió los datos, se rechaza toda la reversión para conservar la auditoría. La reversión elimina solo registros y vínculos creados por la ejecución; conserva contactos y organizaciones, incluido un contacto propuesto y confirmado manualmente. - Las ejecuciones antiguas realizadas antes del registro de reversión pueden no ser elegibles. Conserva su historial y usa la operación financiera normal para las correcciones. Solución de problemas Mercado Pago pide una fecha inicial Introduce una fecha dentro de la ventana de historial admitida por Mercado Pago. Una fecha anterior puede generar una vista incompleta y la plataforma la rechaza. No puedo importar sin seleccionar registros Es esperado. Genera una vista previa, selecciona los registros deseados y ejecuta la importación seleccionada. Un cobro no se puede seleccionar porque el cliente está pendiente Abre la resolución de cliente en esa fila. Elige un contacto existente o propón uno nuevo con nombre y correo, teléfono o documento. Guarda la decisión, selecciona el cobro y confirma la importación. El contacto propuesto no existe hasta esa confirmación. Mercado Pago pide el correo del cliente Es esperado. La búsqueda documentada de clientes de Mercado Pago exige correo y no permite una importación general de la agenda. Informa el correo del cliente existente que deseas vincular o importa suscripciones, que intentan asociar los datos de pagador entregados por la pasarela. Un cobro aparece como ignorado Abre Cobros ignorados permanentemente en la misma pantalla, revisa el motivo y usa Permitir nuevamente si puede considerarse otra vez. La reversión fue rechazada Hubo un movimiento posterior o el registro no fue creado por la ejecución elegida. No se eliminó ningún dato. Revisa la fila del historial y los eventos del cobro y usa la operación financiera normal adecuada. Ver también - Conectar una pasarela de pagos - Gestionar cobros - Reembolsos, webhooks e informes

Reembolsos, webhooks e informes

Visión general Este artículo cubre lo que ocurre después de enviar el cobro: cómo devolver dinero (reembolso), cómo el webhook mantiene los estados sincronizados sin que hagas nada y qué informes muestran la salud financiera de la operación. El webhook es el canal por el que la pasarela avisa a la plataforma de cada cambio (pagado, vencido, reembolsado, cancelado). Por eso es la fuente de verdad: la plataforma actualiza el estado del cobro a partir del webhook, no de la pantalla de "éxito" del checkout. Requisitos previos - Módulo Pagos habilitado y una pasarela conectada con el webhook configurado. - Permiso para emitir reembolsos. - Para los informes, tener cobros/suscripciones registrados en el período. Paso a paso Reembolsar un cobro 1. Abre el cobro que deseas reembolsar (ya pagado). 2. Elige reembolsar. 3. Selecciona total (devuelve el valor entero) o parcial (ingresa el valor a devolver). 4. Confirma. La plataforma solicita el reembolso a la pasarela. 5. Observa el estado cambiar a reembolsado (o parcialmente reembolsado) cuando la pasarela confirme. Verificar el webhook 1. En la configuración de la conexión de la pasarela, revisa la URL del webhook y el secreto de verificación. 2. Asegúrate de que la URL esté registrada en el panel de la pasarela. 3. Haz una prueba y observa el estado actualizarse automáticamente. Leer los informes 1. Abre los informes de Pagos. 2. Filtra por período. 3. Analiza los indicadores (facturación, ticket medio, MRR, churn) y los cortes por estado, pasarela y moneda. Configuración y opciones - Reembolso total vs. parcial: ambos admitidos por las pasarelas actuales. - Webhook: autenticado por cada pasarela (token en el encabezado en Asaas; firma en Mercado Pago); las notificaciones repetidas se manejan de forma segura (sin duplicar efectos). - Indicadores de los informes: | Indicador | Qué muestra | |---|---| | Facturación | Total recibido en el período | | Ticket medio | Valor medio por cobro pagado | | Descuentos otorgados | Suma de los descuentos aplicados | | Por estado | Distribución entre pagado, pendiente, vencido, etc. | | Por pasarela | Cuánto ingresó por Asaas / Mercado Pago | | Por moneda | Cortes cuando hay más de una moneda | | MRR | Ingreso recurrente mensual de las suscripciones activas | | Churn | Suscripciones canceladas en el período | Casos de uso - Devolver un valor a un cliente que desistió (reembolso total). - Revertir parte de un cobro (reembolso parcial). - Seguir el crecimiento del ingreso recurrente con el MRR. - Identificar la pérdida de suscriptores con el churn. Consejos, límites y buenas prácticas - Confía siempre en el webhook para el estado; la pantalla del checkout puede renderizar antes de la confirmación. - El reembolso lo procesa la pasarela — el plazo para que el dinero llegue al cliente sigue las reglas del proveedor/medio de pago. - Sigue MRR y churn juntos para tener la foto real de la recurrencia. - Mantén la URL del webhook accesible y el secreto de verificación correcto; sin eso, los estados no se actualizan. Solución de problemas - El estado nunca cambia a pagado: el webhook no está llegando o fue rechazado (firma/token incorrectos) — vuelve a configurar el webhook en la conexión. - El reembolso no concluye: confirma que el cobro estaba pagado y que la pasarela admite el tipo de reembolso solicitado. - Informe vacío: verifica el filtro de período y si hay cobros en el rango. - El MRR parece incorrecto: confirma los ciclos de las suscripciones; el MRR normaliza cada una al equivalente mensual. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Descuentos y ajuste de valor

Configurar los mensajes de pago

Visión general Los pagos envían al cliente dos mensajes: el cobro y la confirmación de pago. Aquí personalizas el cuerpo de cada uno por idioma, sin IA. Lo que no personalices sigue usando el mensaje incluido de Conversa Labs. Además del cuerpo, editas las etiquetas auxiliares del cobro (leyendas, textos de botón, las líneas de importe y vencimiento y las instrucciones para copiar el código) y configuras, por tipo de mensaje y por idioma, la plantilla aprobada de WhatsApp que se usa cuando la ventana de 24 h está cerrada. Requisitos previos - Pagos habilitado en la cuenta y permiso de administrador. - Para configurar el envío fuera de la ventana: una bandeja de WhatsApp Cloud con plantillas aprobadas por Meta. Paso a paso 1. Abre Configuración → Pagos → Mensajes. 2. Elige el idioma en el selector superior. Se abre en el idioma de la cuenta y lista todos los idiomas habilitados en la instalación (hasta 40), indicando cuántos ya tienen texto tuyo ("N de M idiomas con contenido"). 3. Escribe los cuerpos de cobro y confirmación en Markdown. Vacío = mensaje incluido del idioma (etiqueta Predeterminado). 4. Usa las variables ({x}) para insertar datos del contacto, la cuenta y el propio cobro. El selector ofrece solo las variables que realmente se resuelven en ese mensaje. 5. Abre el bloque Etiquetas auxiliares para ajustar las 12 etiquetas del cobro. 6. El bloque Fuera de la ventana de 24 h (WhatsApp Cloud) aparece abierto, justo debajo de cada tipo de mensaje. Elige la plantilla aprobada de ese tipo en ese idioma, mapea los parámetros {{1}}, {{2}}… y completa el botón de enlace, si lo hay. Si aún no existe una plantilla, usa Crear a partir de mi texto para generarla desde el cuerpo que escribiste. 7. Revisa la vista previa por canal, usa Enviar prueba para validarlo en una conversación real y haz clic en Guardar mensajes — también después de crear una plantilla, porque crear la plantilla no guarda la configuración. Restaurar predeterminado elimina la personalización en el servidor, no solo en la pantalla. Configuración y opciones Idiomas y respaldo El idioma es un selector con todos los idiomas habilitados en la instalación. Al enviar, Conversa Labs busca el texto en este orden: idioma del contacto → mismo idioma base (pt_BR ↔ pt) → idioma de la cuenta → mensaje predeterminado incluido. Etiquetas auxiliares Son 12 etiquetas: leyendas, textos de botón, las líneas de importe y vencimiento y las instrucciones para copiar el código. Están en un bloque plegable y siguen las mismas reglas de idioma y de restauración que el cuerpo. Fuera de la ventana de 24 h (WhatsApp Cloud) El bloque aparece abierto e integrado justo debajo de cada tipo de mensaje — no es una sección que tengas que expandir. La plantilla es por tipo de mensaje y por idioma — cobro y confirmación tienen la suya, en lugar de una única plantilla para todo el módulo. Ahí tienes: - Elegir la plantilla aprobada del catálogo. - Sincronizar desde Meta y Crear a partir de mi texto están siempre visibles. Cuando la acción no está disponible, el botón aparece deshabilitado con el motivo escrito al lado: la bandeja no es WhatsApp Cloud, la cuenta no tiene el WhatsApp Inbox Suite, o tu perfil no gestiona bandejas de entrada. - Sincronizar desde Meta actualiza la lista de plantillas aprobadas. - Crear a partir de mi texto genera la plantilla desde el texto de ese tipo en ese idioma, enviándola a Meta como plantilla UTILITY, convirtiendo cada {{ variable }} en {{1}}, {{2}}… y dejando el mapeo listo. Sin texto del que generar, el botón queda deshabilitado y la pantalla pide escribir el texto primero. - Tras el envío, la plantilla todavía no está aprobada: aparece en el selector marcada como esperando aprobación y solo empieza a entregar cuando Meta la aprueba y tú sincronizas. Enviar de nuevo con el mismo nombre reemplaza el borrador pendiente, en lugar de fallar. - Crear la plantilla no guarda la configuración — haz clic en Guardar mensajes para almacenar el mapeo. - El mapeo de los parámetros {{n}} y el campo del botón de enlace. - Entrega: elige de qué bandeja de WhatsApp se consulta el catálogo de plantillas aprobadas. El envío sigue saliendo por la bandeja de la propia conversación. Las plantillas cuyo encabezado exige medios o una variable no se listan aquí — este envío no puede completar ese encabezado — y la pantalla indica cuántas quedaron fuera. Siguen disponibles desde la pestaña Plantillas de la propia bandeja, con enlace directo desde esta pantalla. Notas: WhatsApp Web (WazMeow) no tiene ventana de 24 h (el bloque ni aparece); 360dialog puede seleccionar una plantilla, pero no crearla; Meta empareja nombre + idioma + aprobada, así que una plantilla en el idioma equivocado se señala en pantalla y sería rechazada al enviar. Vista previa y envío de prueba La vista previa se renderiza en el servidor, por canal, y muestra solo los canales que la cuenta realmente tiene. También exhibe la plantilla resuelta para fuera de la ventana, con los valores que cargará cada parámetro. Enviar prueba manda el mensaje a la conversación elegida respetando la ventana de 24 h: con la ventana cerrada y sin plantilla configurada, la prueba se omite con el motivo escrito en pantalla. Variables de pago Además de contacto, cuenta, conversación, bandeja, agente, CRM y organización — que ahora se renderizan de verdad —, estos mensajes ofrecen los datos del propio cobro: | Variable | Se sustituye por | |---|---| | {{ payment.amount }} | Importe del cobro | | {{ payment.currency }} | Moneda | | {{ payment.description }} | Descripción del cobro | | {{ payment.status }} | Estado actual | | {{ payment.due_date }} | Fecha de vencimiento | | {{ payment.billing_type }} | Forma de cobro (PIX, boleto, tarjeta…) | | {{ payment.pay_url }} | Enlace de pago | | {{ payment.pix_payload }} | PIX copiar y pegar | | {{ payment.boleto_url }} | Enlace del boleto | | {{ payment.boleto_line }} | Línea digitable del boleto | | {{ payment.gateway }} | Pasarela usada | Consejos, límites y buenas prácticas - Markdown por canal: los adjuntos se descartan en LINE/TikTok/X; el HTML sin procesar desaparece en el correo/widget; *negrita* en WhatsApp aparece como un par de asteriscos. - Configura la plantilla fuera de la ventana en el mismo idioma del cuerpo — son pares, no una configuración única. - Ofrece siempre una vía de pago en el texto: {{ payment.pay_url }}, {{ payment.pix_payload }} o {{ payment.boleto_line }}, según la forma de cobro. - Después de "Crear a partir de mi texto", la plantilla queda esperando aprobación en Meta — usa Sincronizar desde Meta para ver cuándo se aprueba y empieza a entregar. Solución de problemas - Salió como el predeterminado: el tipo estaba vacío (etiqueta Predeterminado) en ese idioma, o el idioma del contacto no tiene texto y el respaldo llegó al predeterminado incluido. - Fuera de la ventana no se envió: confirma la plantilla aprobada de ese tipo en ese idioma. - La plantilla aparece señalada: está en un idioma distinto del mensaje — cámbiala por una aprobada en el idioma correcto. - "Crear a partir de mi texto" está deshabilitado: el motivo aparece escrito al lado del botón — la bandeja no es WhatsApp Cloud (en 360dialog eliges una plantilla ya aprobada), la cuenta no tiene el WhatsApp Inbox Suite, tu perfil no gestiona bandejas de entrada, o no hay texto en ese tipo e idioma para generar la plantilla. - Creé la plantilla, pero no aparece / no se usa: justo tras el envío queda esperando aprobación — solo entrega cuando Meta la aprueba y usas Sincronizar desde Meta. Y confirma que hiciste clic en Guardar mensajes: crear la plantilla no guarda la configuración. - No encuentro una plantilla en la lista: las plantillas con encabezado de medios o con variable en el encabezado no se listan aquí; úsalas desde la pestaña Plantillas de la propia bandeja. - El envío de prueba se omitió: la conversación estaba fuera de la ventana de 24 h y el mensaje no tenía plantilla configurada — la pantalla informa el motivo. Ver también - Conectar pasarelas de pago (Asaas / Mercado Pago) - WhatsApp Inbox Suite: plantillas, flows y llamadas

Gestionar y conciliar cobros

Visión general El área de Cobros es donde haces seguimiento y administras todo lo que se ha cobrado. Tiene una lista paginada con búsqueda (búsqueda, período de creación, estado, gateway/conexión, ordenación y un interruptor para mostrar los archivados), acciones por fila en cada cobro (ver, editar, corregir cliente y vínculos, enviar a la conversación, reembolsar, marcar como pagado, cancelar, archivar, restaurar, eliminar) y una barra flotante de acciones en lote que aparece cuando seleccionas varios cobros a la vez. El objetivo es la conciliación: mantener el estado de cada cobro coherente con la realidad — reflejando lo que el gateway confirmó y también los pagos recibidos por fuera de la plataforma. Requisitos previos - El módulo Pagos habilitado y al menos un gateway conectado (consulta Conectar gateway). - Cobros ya creados (consulta Crear un cobro y enviarlo en la conversación). - Para eliminar definitivamente y para las acciones en lote financieras se necesita permiso de administrador. Paso a paso 1. Filtrar y abrir un cobro 1. Abre Pagos → Cobros. 2. Busca por descripción, id del gateway/referencia externa, nombre/correo del cliente o nombre de la conexión. Combina la búsqueda con estado, conexión y el período de creación en la zona horaria de la cuenta. 3. Ordena por creación, vencimiento, importe, estado o descripción; activa archivados para ver la papelera. Cada control activo aparece como una etiqueta removible y la URL conserva página, filtros y ordenación para volver o compartir la misma vista. 4. Haz clic en el cobro para abrir sus detalles. La acción principal respeta el artefacto disponible: página alojada, boleto o PIX para copiar y pegar; un cobro manual sigue siendo auditable aunque no tenga enlace. 5. Usa Exportar CSV para descargar todo el recorte filtrado, no solo la página visible. Si hay cobros seleccionados, el archivo contiene únicamente esa selección. En pantallas pequeñas, los controles pasan al panel Filtros y cada cobro se convierte en una tarjeta legible. 2. Ver la línea de tiempo de estado (auditoría) 1. En los detalles del cobro, abre la pestaña de línea de tiempo. 2. Cada evento (creado, pagado, reembolsado, cancelado, actualizado) se registra de forma inmutable, con el agente responsable, la hora y la justificación introducida — es el historial financiero auditable del cobro. 3. Corregir cliente y vínculos sin editar los hechos financieros 1. Desde la fila o los detalles, usa Corregir el cliente y los vínculos de la venta cuando falte el contacto o sea incorrecto, incluso en un cobro pagado cuyos campos financieros ya no se pueden editar. 2. Elige un contacto existente o propón uno nuevo con nombre y al menos correo, teléfono o documento. Revisa también el pedido, la recuperación, la organización, el negocio y la conversación alcanzados. 3. Genera la vista previa y comprueba conflictos, historial y cualquier impacto en vendedor/afiliado. Los cambios de crédito o comisión exigen confirmación explícita. La aplicación es transaccional y auditada. 4. Esta acción nunca cambia importe, estado, liquidación, vencimiento ni ID de pasarela. Para esos hechos, usa la operación financiera correspondiente o corrige el origen. 4. Marcar como pagado manualmente (y deshacer) 1. Para un pago recibido por fuera (efectivo, PIX directo a la cuenta), usa Marcar como pagado. 2. Introduce la justificación (obligatoria) — queda guardada en el evento de auditoría. 3. El cobro pasa a pagado. Disponible solo para cobros que siguen abiertos (pendiente, en espera de pago o vencido) y en gateways que admiten la liquidación manual. 4. Para revertirlo, usa Deshacer liquidación manual — solo funciona en un cobro que tú mismo liquidaste manualmente; vuelve a pendiente/vencido. 5. Cancelar (abierto) vs reembolsar (pagado) 1. Usa Cancelar cobro mientras el cobro siga abierto (sin pagar): el cliente ya no podrá pagarlo. 2. Usa Reembolsar cuando el cobro ya esté pagado: elige total (devuelve todo) o parcial (introduce el importe). Puedes reembolsar parcialmente más de una vez, hasta el total. 3. En ambos casos puedes registrar un motivo, que queda en la auditoría. 6. Reenviar en la conversación 1. Usa Enviar a la conversación e indica la conversación de destino. 2. La tarjeta de pago vuelve a aparecer para el cliente en la propia ventana de la conversación. 7. Archivar → restaurar → eliminar definitivamente 1. Archivar quita el cobro de la lista predeterminada sin borrarlo (va a la papelera de archivados). 2. Restaurar devuelve el cobro archivado a la lista activa. 3. Eliminar definitivamente lo borra del todo — solo se permite en cobros archivados y no liquidados; los cobros pagados/reembolsados se conservan para auditoría y nunca pueden borrarse. 8. Acciones en lote 1. Selecciona varios cobros; aparece la barra flotante con el recuento. 2. En la lista activa (admin): marcar como pagado, cancelar y reembolsar (solo total), además de archivar. 3. En la lista de archivados: restaurar y eliminar definitivamente (admin). 4. Todas las acciones en lote son best-effort: el resultado indica cuántos se procesaron y lista los ids que fallaron. Solo los fallos permanecen seleccionados para revisar o reintentar; ningún elemento solicitado desaparece silenciosamente del resultado. Configuración y opciones - Acción por fila vs en lote: la misma operación existe individualmente en cada cobro y en lote sobre la selección. - Permisos: eliminar definitivamente y las acciones financieras en lote (marcar como pagado, reembolsar, cancelar) y la eliminación en lote están restringidas a administradores. - Reembolso en lote = solo total: el reembolso parcial existe únicamente como acción por fila. - Eliminar exige archivar antes: la eliminación permanente es siempre una acción deliberada en dos pasos (archivar y solo entonces eliminar). - Exportación: respeta búsqueda, período, filtros y selección actual; los textos se protegen para que la hoja de cálculo no los interprete como fórmulas. - Editar vs corregir vínculos: editar sigue sujeto al estado y a las reglas de la pasarela. Corregir vínculos es una operación separada que actúa solo en asociaciones, incluso para cobros liquidados. Casos de uso - Conciliar un PIX pagado por fuera: marca el cobro como pagado con la justificación, manteniendo el historial coherente. - Limpiar cobros de prueba: archívalos en lote y, después, elimina definitivamente los archivados. - Reembolsar en masa: selecciona los cobros pagados y reembólsalos en lote (total). Consejos, límites y buenas prácticas - Cancelar solo vale para cobros abiertos; para un cobro pagado, el camino es el reembolso. - El reembolso depende del gateway — el tipo (total/parcial) y el plazo de devolución siguen las reglas del proveedor y del medio de pago. - El webhook sigue siendo la fuente de la verdad: la liquidación manual es para lo que se pagó por fuera; los pagos del propio gateway llegan y actualizan el estado solos. - Deshacer liquidación manual solo funciona sobre lo que tú liquidaste manualmente — no es la vía para revertir un pago real del gateway (para eso, usa el reembolso). - Si el importe es correcto pero el cliente, pedido o evento de recuperación está mal, usa Corregir cliente y vínculos; no canceles ni reembolses solo para arreglar una asociación. Solución de problemas - "No puedo eliminar": el cobro debe estar archivado primero; y los cobros pagados/ reembolsados nunca se eliminan (se conservan para auditoría). Archívalo en lugar de intentar borrarlo. - "Deshacer no disponible": una liquidación manual solo puede deshacerse por la misma vía — solo un cobro que tú marcaste como pagado manualmente (en un gateway compatible) puede revertirse. - "Marcar como pagado no disponible": el cobro no está abierto, o el gateway no admite la liquidación manual. - "Editar no está disponible en un cobro pagado": los hechos liquidados son inmutables. Para cambiar solo cliente, organización, negocio o conversación, usa Corregir el cliente y los vínculos de la venta. - Una acción en lote omitió cobros: es el comportamiento esperado — los no elegibles (estado incompatible o un gateway sin la función), ids ausentes y elementos fuera de la vista permitida aparecen como no procesados y permanecen seleccionados para revisión. - La lista no cargó: usa Intentar de nuevo; si continúa, revisa la conexión con el servidor. Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Reembolsos, webhooks e informes - Conectar gateway: Asaas y Mercado Pago

Ofertas: order bump, upsell y downsell

Visión general Una oferta es un precio reutilizable que registras una vez y reaprovechas en varias ventas. Hay tres tipos: - Order bump: aparece en el checkout como un complemento rápido y, al aceptarse, entra como una línea extra en el cobro que se está creando. - Upsell: oferta de un clic tras la compra, normalmente un artículo de mayor valor, que genera un nuevo cobro para el contacto. - Downsell: también de un clic tras la compra, usada como alternativa más barata cuando el cliente rechaza el upsell — igualmente genera un nuevo cobro. En todos los casos la oferta guarda nombre, importe, moneda y método; solo la vinculas a una venta o a un contacto en el momento adecuado. Requisitos previos - Una pasarela conectada y válida (consulta Conectar pasarela). - Opcional: un producto del Catálogo vinculado a la oferta (catalog_product_id), para reaprovechar el registro del producto. - Define en la oferta la conexión (pasarela) y el método (billing_type) que se usarán cuando se convierta en cobro — sobre todo para upsell y downsell. - Para aceptar una oferta (upsell/downsell), el contacto necesita datos mínimos (nombre y, idealmente, correo/teléfono) para el pagador en la pasarela. Cómo funciona - Order bump en el checkout: la oferta se convierte en una línea de cobro (nombre, importe y moneda quedan "fotografiados" en ese momento). Suma al total agregando una nueva línea — nunca altera el importe de un cobro ya existente. La línea solo guarda la referencia de la oferta en sus metadatos. - Upsell / downsell tras la compra: al aceptar la oferta para un contacto, la plataforma crea un nuevo cobro reaprovechando la conexión, el importe y los datos del pagador ya conocidos — sin reescribir nada. Ese cobro sigue el flujo normal (pasarela → webhook → tarjeta de pago en la conversación), igual que cualquier otro cobro. - La oferta nunca se modifica al aceptarse: es una plantilla; cada aceptación crea un cobro nuevo e independiente. - La aceptación poscompra solo funciona para una oferta activa y no archivada. Un order bump pertenece al checkout y esta acción lo rechaza. Repetir el mismo intento de red recupera el mismo cobro. Configuración y opciones Campos de una oferta: | Campo | Para qué sirve | |---|---| | Nombre | Identifica la oferta y se convierte en la descripción del cobro/línea. Obligatorio. | | Tipo (kind) | order_bump, upsell o downsell. | | Importe | Precio de la oferta (unidades mayores, p. ej. 49.90). Debe ser mayor que cero. | | Moneda | Código de 3 letras (p. ej. BRL). | | Método (billing_type) | PIX, boleto o tarjeta usado cuando la oferta se convierta en cobro. | | Conexión | La pasarela (conexión de pago) usada para cobrar. | | Producto del catálogo | Vínculo opcional a un producto del Catálogo. | | Descripción | Texto auxiliar de la oferta. | | Activa / inactiva | Las ofertas inactivas no se presentan. | Paso a paso 1. En el área de Pagos, abre Ofertas y crea una nueva oferta. 2. Indica el nombre, elige el tipo (order bump, upsell o downsell), el importe y la moneda. 3. Define el método y la conexión (pasarela) que se usarán al generar el cobro. 4. (Opcional) Vincula un producto del catálogo y escribe una descripción. 5. Guarda. La oferta está disponible mientras esté activa. 6. Para aplicar un order bump, usa la oferta en el checkout: si el cliente la acepta, se convierte en una línea extra del cobro. 7. Para aceptar un upsell/downsell, dispara la aceptación de la oferta para el contacto (opcionalmente ligado a una conversación): la plataforma genera un nuevo cobro y lo envía en la conversación. 8. Para retirar una oferta, archívala — desaparece de las ofertas disponibles, pero el precio se conserva (nunca borramos un precio que un embudo activo pueda referenciar). Casos de uso - Aumentar el ticket con un order bump en el checkout ("agrega la garantía extendida por $19,90"). - Ofrecer un upsell justo después de la compra ("lleva la versión Pro con un clic"). - Recuperar la venta con un downsell cuando el cliente rechaza el upsell más caro. - Reutilizar la misma oferta en varias conversaciones y checkouts, sin volver a crear el precio. Consejos, límites y buenas prácticas - El order bump no altera un cobro ya creado — solo agrega una línea al total en el momento del checkout. - Aceptar un upsell/downsell siempre crea un cobro nuevo e independiente; la oferta original permanece intacta. - Las ofertas se archivan, no se borran — así no se rompe ningún embudo o historial que dependa de ese precio. - Define conexión y método en la oferta de upsell/downsell: sin ellos, la aceptación no puede generar el cobro correctamente. - Los importes están en unidades mayores ($49,90 = 49.90); el total del checkout es la suma de las líneas — nunca dividas por 100. Solución de problemas - La oferta no aparece: comprueba que esté activa y no archivada (las ofertas inactivas o archivadas no se presentan). - La aceptación falló: verifica que el contacto tenga los datos mínimos y que la conexión (pasarela) de la oferta sea válida — la aceptación crea un cobro real y necesita esos datos. - El importe del order bump salió mal: recuerda que agrega una línea al total; no reemplaza ni reduce las demás líneas. - No puedo eliminar una oferta: las ofertas se archivan (reversible), no se eliminan — usa archivar. Ver también - Crear un cobro y enviarlo en la conversación - Conectar pasarela: Asaas y Mercado Pago - Catálogo nativo de productos y servicios