Conversiones con valor registradas por el bot

Para qué sirve

Permite que el bot guarde el total de una cotización en un atributo de la conversación y, solo después de confirmar que quedó guardado, aplique la etiqueta que dispara un evento de Meta Conversions. Así el evento puede llevar el importe real, y el cierre sigue apareciendo en los informes que usan esa etiqueta.

La activación es opcional, por evento y por cuenta. No cambia automáticamente las instrucciones comerciales de tus agentes ni convierte una aceptación en un pago verificado.

Dónde se configura

En el panel, abrí Meta Conversions → Eventos, agregá o editá un evento y buscá Registrar conversiones con el bot. El botón ¿Cómo funciona? abre esta misma guía. Puede configurarlo quien ya tenga permiso para editar Meta Conversions de esa cuenta; las credenciales y el evento siguen siendo los de esa cuenta.

Antes de activar

Necesitás:

Meta Conversions habilitado, con credenciales y destino correctos.
Una etiqueta que corresponda a un único evento, estándar o personalizado. Por ejemplo, presupuesto_aceptado para InitiateCheckout o para un evento personalizado. Elegí Purchase únicamente si el criterio realmente representa una compra para tu negocio.
Un atributo personalizado numérico de conversación, creado en el CRM. En Nombre del atributo se usa su clave, por ejemplo valor_de_compra, y no su título visible «Valor de compra».
Una herramienta del bot que devuelva una cotización final ya calculada, con total y moneda en una respuesta JSON. Un listado de productos o precios unitarios no alcanza. El bot no calcula este monto libremente ni lo toma de un número escrito en sus instrucciones.
Permitir duplicados desactivado.

El configurador debe preparar la herramienta de cotización para que calcule cantidades, tramos de precios, descuentos, extras e impuestos que correspondan al negocio. Esta función toma ese total; no reemplaza un cotizador ni valida sus reglas comerciales.

Paso a paso

Editá el evento y elegí la etiqueta.
Activá Capturar valor monetario, elegí Atributo de Chatwoot, indicá la clave del atributo de conversación y seleccioná la moneda.
Activá Registrar conversiones con el bot.
En Herramienta de cotización, escribí el nombre exacto de la herramienta ya configurada en esa cuenta. Debe estar disponible para el agente que cotiza.
Indicá el Campo del total en la respuesta y el Campo de la moneda en la respuesta. Con una respuesta {"total":12500.50,"currency":"ARS"}, usá total y currency. Con {"presupuesto":{"total":12500.50,"moneda":"ARS"}}, usá presupuesto.total y presupuesto.moneda. Se admiten claves separadas por puntos e índices de listas, por ejemplo presupuestos.0.total.
Cargá un Monto máximo por conversión positivo. Usá números decimales con punto, sin símbolo monetario ni separadores de miles. Tanto el total como el tope admiten hasta dos decimales.
En Cuándo registrar la conversión, describí una condición concreta: por ejemplo, «El cliente acepta explícitamente el presupuesto final, sin pedir cambios». Diferenciá interés, aceptación, pedido y pago. Una aceptación no demuestra que el cliente pagó.
Guardá el evento y luego guardá la configuración de Meta Conversions.
Revisá las instrucciones del agente: cuándo cotizar, cuándo registrar y cuándo derivar a una persona deben ser compatibles con ese criterio. La herramienta no reescribe las instrucciones.

Qué hace durante una conversación

Cuando se ejecuta la herramienta de cotización configurada, la plataforma guarda su total y moneda para esa cuenta y esa conversación. Solo acepta una respuesta estructurada válida, un total mayor a cero, hasta el tope configurado y en la misma moneda del evento.

El bot recibe la herramienta registrar_conversion. Primero consulta la cotización disponible y el criterio. Cuando corresponde registrar, selecciona la referencia de esa cotización y aporta una cita del último mensaje del cliente como evidencia; no puede pasar un importe.

La plataforma verifica la cotización y la identidad de la cuenta, guarda el monto, vuelve a leerlo para confirmar y recién entonces aplica la etiqueta. El envío posterior a Meta usa el circuito habitual de etiquetas, historial y avisos de errores. «Etiqueta aplicada» no significa que Meta ya recibió el evento.

Reglas y límites

Una conversión por conversación y tipo de evento. Comparte el control de duplicados con las etiquetas manuales y los pagos detectados. Una segunda compra en la misma conversación no genera otro evento del mismo tipo con esta función.
Se conserva la última cotización de cada etiqueta. Una consulta posterior que devuelve un error, un resultado inválido u otra cotización invalida la referencia anterior. Una cotización vence a las 24 horas. Cambiar la configuración también invalida las cotizaciones previas.
No toma montos de otras conversaciones, del contacto, de un catálogo sin total, de mensajes libres del modelo ni de cotizaciones históricas no registradas por la herramienta.
No interpreta «15k», «150 mil», símbolos de moneda ni formatos locales en el resultado de la herramienta: el cotizador debe devolver 15000 o 15000.50 y un código como ARS.
El orden está garantizado, pero los dos sistemas no comparten una transacción: si se guardó el monto y falló la etiqueta, el monto puede quedar guardado. El bot recibe un estado incierto y el equipo debe revisar el CRM antes de continuar.
Si existe un registro pendiente con otra cotización, se bloquea para revisión humana. No se reemplaza silenciosamente el monto.
En Demo y evaluaciones no se modifica el CRM ni se envían eventos a Meta. Un registro de Demo no verifica la recepción real en Meta.
Esta versión registra directamente cuando se cumple el criterio. No incluye una bandeja de propuestas ni un botón de aprobación por asesor.

Preguntas frecuentes

¿Aparece en Ciclo de Venta? Sí, cuando se usa una etiqueta Purchase que ese informe reconoce como cierre. El valor sale del mismo atributo. Un evento de presupuesto o InitiateCheckout no se presenta como venta cerrada por el solo hecho de enviarlo a Meta.

¿Funciona con transferencias o efectivo? Puede registrar el evento comercial configurado sin Mercado Pago. No verifica una transferencia ni un cobro en efectivo: para registrar un pago real necesitás un criterio y un proceso de validación acordes.

¿Activa esto en todas las cuentas? No. Está apagado hasta configurarlo por evento. El configurador debe adaptar el cotizador y las instrucciones de cada negocio.

¿Corrige eventos antiguos de valor 1? No. Los eventos ya enviados no se corrigen cargando el atributo después ni quitando y volviendo a poner la etiqueta.

Errores y soluciones

No hay cotización / cotización vencida o reemplazada: ejecutá nuevamente la herramienta de cotización y consultá la nueva referencia. No copies el monto a mano en los argumentos del bot.
Moneda distinta o monto superior al tope: revisá el resultado del cotizador y la configuración. No cambies la moneda para hacer pasar una cotización que está expresada en otra.
Atributo no encontrado: verificá que sea numérico, de conversación y que configuraste su clave exacta.
No se confirmó el monto: no se aplicó la etiqueta. Revisá permisos y disponibilidad del CRM.
Etiqueta sin confirmar / registro incierto: revisá el monto y las etiquetas de la conversación y luego el historial de Meta antes de reintentar. No registres otra venta como reemplazo.
Meta no recibió el evento: usá el historial y los avisos de Meta Conversions para revisar destino, credenciales y la respuesta recibida. Que el bot haya aplicado la etiqueta no confirma la entrega a Meta.