Identificador de conversación en la API de WhatsApp

El identificador de conversación (conversation ID) es un código alfanumérico único que la API de WhatsApp de Meta asigna a cada hilo de mensajes entre un negocio y un cliente. Funciona como el "DNI" de una conversación: permite a la plataforma saber qué mensajes pertenecen a un mismo intercambio, aplicar reglas de ventana de 24 horas y facturar correctamente. Si estás integrando WhatsApp Business API, entender este concepto te ahorra dolores de cabeza con el historial, las plantillas y los costos.

¿Por qué le importa a una PyME?

Para una PyME que usa WhatsApp para vender o atender clientes, el identificador de conversación no es un detalle técnico menor. Define cosas concretas: si un mensaje entra dentro de una conversación abierta o inicia una nueva, si podés responder libremente o si necesitás usar una plantilla aprobada, y cuánto te va a cobrar Meta por esa conversación. Entenderlo te ayuda a evitar sorpresas en la factura y a configurar bien tu herramienta de gestión, como Wando, que usa la API oficial de Meta.

¿Cómo se usa en la práctica?

En la práctica, cuando un cliente te escribe por primera vez o después de más de 24 horas de silencio, la API de WhatsApp abre una nueva conversación y le asigna un conversation ID. Ese ID viaja en los webhooks de cada mensaje entrante y en las respuestas de la API cuando enviás un mensaje. Las herramientas de gestión (como un CRM o un software de bandeja) lo usan para agrupar mensajes, mostrar el historial y calcular métricas. Si desarrollás tu propia integración, vas a recibir el campo 'conversation' en el payload del webhook, con su ID y el tipo de conversación (por ejemplo, 'customer_initiated' o 'business_initiated').

Ejemplo concreto y completo

Imaginá que tenés una tienda de ropa y un cliente te escribe el lunes a las 10:00: "¿Tienen la remera negra talle M?". La API de WhatsApp crea una conversación con un ID como 'wamid.ABC123...'. Ese ID queda asociado a todos los mensajes de ese hilo. Respondés a las 10:05, y a las 14:00 el cliente te pregunta por el envío. Todo eso es la misma conversación. Si el cliente no escribe nada hasta el miércoles a las 09:00, ese mensaje nuevo ya no pertenece a la conversación anterior: la API abre una conversación nueva, con un ID distinto, porque pasaron más de 24 horas. Para tu factura, eso son dos conversaciones (dos unidades facturables), aunque sea el mismo cliente.

Con qué se confunde y en qué se diferencia

El identificador de conversación se confunde a menudo con el ID de mensaje (message ID) y con el ID de WhatsApp del cliente (número de teléfono). El message ID identifica un mensaje puntual (cada mensaje tiene el suyo, que empieza con 'wamid.'). El ID de conversación agrupa varios mensajes en un hilo. El número de teléfono es el identificador del contacto, que puede tener muchas conversaciones a lo largo del tiempo. Otra confusión común es pensar que el conversation ID es un número secuencial o que lo elegís vos: es un identificador opaco, generado por Meta, que no tiene significado más que el de agrupar.

Errores comunes al manejarlo

• Asumir que una conversación dura para siempre: la ventana de 24 horas es clave; si no respondés a tiempo, perdés la conversación y la próxima respuesta tuya abre una nueva (y puede requerir plantilla).
• Usar el ID de conversación como clave primaria de un cliente: un cliente puede tener varias conversaciones; si usás el ID como identificador único, vas a duplicar contactos.
• Olvidar que el conversation ID cambia entre mensajes si pasa el tiempo: guardar el ID en una base de datos sin actualizarlo te puede llevar a responder fuera de contexto.
• No distinguir entre conversaciones iniciadas por el cliente y por el negocio: eso afecta el costo y las reglas de plantillas.

¿Qué pasa si no lo tenés en cuenta?

Si no tenés en cuenta el identificador de conversación, tu integración puede mezclar mensajes de distintos hilos, mostrar historiales incompletos, enviar respuestas fuera de la ventana de 24 horas (lo que Meta rechaza o te obliga a usar plantillas) y, al final del mes, recibir una factura de Meta con cargos que no entendés. Las herramientas que usan la API oficial, como Wando, se encargan de manejar estos IDs por vos, pero si desarrollás algo propio, es un requisito básico.

¿Cómo se relaciona con la API oficial de Meta?

La API de WhatsApp de Meta (WhatsApp Cloud API) usa el identificador de conversación para dos cosas principales: controlar la ventana de 24 horas y facturar. Cada mensaje entrante o saliente dentro de una misma conversación comparte el mismo ID. Cuando la conversación se cierra (por tiempo o porque se resuelve), el ID deja de ser útil para nuevos mensajes. Los webhooks que envía Meta incluyen el objeto 'conversation' con el ID y el tipo. Para saber los límites exactos y los precios de conversación de Meta (que varían por país), tenés que consultar la documentación oficial de Meta, porque cambian con frecuencia.

¿Cuándo NO aplica?

El identificador de conversación no aplica si usás WhatsApp normal (la app de celular) sin API, porque ahí no hay concepto de conversación facturable: es todo un chat. Tampoco aplica si usás una herramienta que no está conectada a la API oficial de Meta (por ejemplo, un bot que usa WhatsApp Web no oficial), porque no genera IDs de conversación. Y ojo: aunque uses la API, hay casos donde no hay ID de conversación, como cuando enviás un mensaje a un número que no te respondió nunca: la conversación existe igual, pero el ID puede no estar presente en el webhook hasta que el cliente responda.

Cómo configurarlo en Wando paso a paso

Configurar Wando para que maneje los identificadores de conversación por vos no requiere tocar nada técnico. Al crear tu cuenta, conectás tu número de WhatsApp a través de la API oficial de Meta. El proceso es guiado: escaneás un código QR o ingresás tu número, y Wando se encarga de la verificación.

En el panel, vas a la sección 'Configuración' y después a 'Conexión'. Ahí ves el estado de tu número: si está 'Conectado', la API ya está activa y Wando empieza a recibir los webhooks con los IDs de conversación. Si aparece 'Desconectado' o 'Requiere acción', tocá 'Reconectar' y repetí el paso del QR.

No hay ningún campo donde veas el conversation ID en la interfaz de Wando. No lo necesitás: la plataforma lo usa internamente para agrupar mensajes y facturar. Lo que sí podés configurar son las auto-respuestas por horario y las plantillas, que dependen de la ventana de 24 horas que define el ID.

Si querés verificar que todo quedó bien, mandale un mensaje a tu propio número desde otro teléfono. En la bandeja de Wando debería aparecer como una conversación nueva, con el historial completo. Si no aparece, revisá que el número esté conectado y que el webhook esté activo.

Cómo darte cuenta de que quedó bien y qué mirar primero si falla

Una integración bien configurada se nota en dos cosas: los mensajes entran y salen sin demora, y en tus estadísticas ves conversaciones separadas por cliente y por día. Si abrís un chat en Wando, el historial muestra todos los mensajes de esa conversación actual, no mezclados con los de días anteriores.

Cuando algo no funciona, el primer lugar para mirar es el estado de la conexión en 'Configuración > Conexión'. Si dice 'Conectado', el problema está en otro lado. Lo segundo es probar con un mensaje real: si entra pero no sale respuesta, revisá las auto-respuestas y las plantillas.

Un error común es que la respuesta salga como plantilla cuando no debería. Eso pasa si pasaron más de 24 horas desde el último mensaje del cliente y la conversación se cerró. Wando te avisa en la bandeja con un ícono, y te sugiere usar una plantilla aprobada para reabrir la conversación.

Si después de probar todo sigue fallando, fijate en la documentación de Meta para desarrolladores: los errores de webhook y de autenticación aparecen ahí. Pero en el 99% de los casos, el problema es que el número no está conectado o que la plantilla no está aprobada. Wando te muestra ambos estados en el panel.

Qué cambia según el tamaño del negocio

Para un negocio de una sola persona, el identificador de conversación es transparente: no lo ves, no lo tocás, y solo te afecta cuando llega la factura de Meta. Con Wando, una persona puede manejar la bandeja sin preocuparse por IDs, porque la plataforma agrupa todo automáticamente.

En un negocio de quince personas, el conversation ID se vuelve relevante para no pisarse entre agentes. Wando usa el ID para saber qué mensajes pertenecen a qué cliente, y así dos agentes no responden el mismo hilo a la vez. También permite asignar conversaciones a personas específicas, algo que un negocio chico no necesita.

El tamaño también cambia cómo se manejan las plantillas. Un negocio chico usa una o dos plantillas genéricas (saludo, confirmación). Uno grande necesita varias por campaña, y ahí el ID de conversación es clave para medir cuántas conversaciones abrió cada plantilla y cuánto costó.

La factura de Meta también escala distinto: un negocio de una persona puede tener 50 conversaciones al mes; uno de quince, miles. Wando muestra las estadísticas de conversaciones por día, para que sepas cuántas unidades facturables generaste y no te sorprenda el costo.

Qué está escrito en la documentación oficial de Meta y qué no

La documentación oficial de Meta define el conversation ID como un identificador único que agrupa mensajes dentro de una ventana de 24 horas. Está especificado que el ID aparece en los webhooks y que los precios se calculan por conversación, con tarifas que varían por país.

Lo que Meta no documenta es cómo usar ese ID en una interfaz de usuario. Ahí entra cada plataforma: Wando decide mostrarlo o no, cómo agrupar los chats y cómo manejar los casos límite. Tampoco especifica qué hacer cuando una conversación se cierra y el cliente vuelve a escribir: eso es criterio de la herramienta.

Meta tampoco fija los tiempos de aprobación de plantillas más allá de 'hasta 48 horas'. Si una plantilla tarda más, no es algo que la documentación prometa. Cada plataforma maneja eso a su manera, y Wando te avisa cuando una plantilla está aprobada.

Cuando leas la documentación de Meta, vas a ver términos como 'conversation category' y 'conversation pricing'. Eso es todo lo que necesitás para entender la factura. El resto, como la lógica de reapertura o el manejo de múltiples agentes, es responsabilidad de la herramienta que uses.

Preguntas de segundo orden que quedan después de entender el concepto

Una vez que entendés qué es el conversation ID, surgen preguntas más finas. Por ejemplo: ¿qué pasa si un cliente te escribe, no le respondés, y te vuelve a escribir a los tres días? Meta abre una conversación nueva, y el historial anterior queda en otra. Wando te muestra ambos en el mismo chat, pero los cuenta como dos conversaciones.

Otra pregunta es si podés forzar el cierre de una conversación. La respuesta es no: la ventana de 24 horas la controla Meta, no vos ni la herramienta. Lo que sí podés hacer es no responder y esperar a que se cierre, pero eso no te conviene para el servicio.

También está la duda de si el ID se reutiliza. No: cada conversación tiene un ID único, y no se repite. Si un cliente te escribe todos los días, vas a tener un ID distinto por día, aunque sea el mismo contacto.

Por último, ¿cómo afecta el ID a las estadísticas? Wando usa el ID para contar conversaciones únicas por día, no mensajes sueltos. Eso te da una métrica más real de cuánta gente te escribió, y te ayuda a planear cuánto vas a pagar en la factura de Meta.