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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
undoy 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.