Conversaciones de WhatsApp
Cuando un contacto escribe a uno de tus números de WhatsApp, o responde a una plantilla que enviaste, contesta el agente asignado a ese número. Fonema agrupa esos mensajes en sesiones: una sesión empieza con el primer mensaje y termina cuando la conversación se cierra. Esta página explica cuándo se cierra una conversación, qué pasa en ese momento y cómo leer tus conversaciones en Mensajes.
Antes de empezar
- Un número de WhatsApp conectado con un agente que lo atienda. Consulta WhatsApp Business para conectar el número y asignar el agente en Teléfonos → Asignar agentes a teléfonos.
- Opcional: criterios de éxito, un prompt de resumen de llamada y variables de salida en la pestaña Instrucciones del agente. Los mismos ajustes que usas para las llamadas sirven para evaluar cada conversación de WhatsApp cuando se cierra.
Cuándo se cierra una conversación
| Qué pasa | Cuándo se cierra la conversación |
|---|---|
| Nadie escribe durante un rato | 1 hora después del último mensaje. Cada mensaje nuevo reinicia la espera. |
| El agente termina el chat | Unos 5 minutos después de la despedida del agente. |
| Enviaste una plantilla y el contacto nunca responde | 1 hora después de enviar la plantilla. La conversación se cierra con Sin respuesta. |
La espera de 1 hora es la predeterminada. El editor de la Secuencia de llamadas y WhatsApp muestra la espera del agente que atiende el número (consulta Secuencia de llamadas y WhatsApp).
Cuando el agente termina el chat
Todo agente de WhatsApp puede cerrar la conversación por su cuenta. Lo hace cuando el contacto se despide, no está interesado, pide que no lo contacten o ya tiene lo que necesitaba. El agente se despide y la conversación se cierra unos 5 minutos después.
Esos 5 minutos sirven para un "gracias" o "adiós" tardío:
- Si el contacto solo agradece o se despide, el agente vuelve a terminar el chat y los 5 minutos empiezan de nuevo.
- Si el contacto trae un tema nuevo, el agente sigue la conversación y vuelve a aplicar la espera de 1 hora.
En Mensajes, la decisión del agente aparece como una tarjeta Herramienta: end_session encima de su despedida.
Para cerrar una conversación al instante mientras pruebas, envía fonema.endSession desde tu teléfono. El agente responde Done, la conversación se cierra de inmediato y su tarjeta dice Cerrada manualmente.
Cuando el contacto vuelve a escribir
Un mensaje después de que la conversación se cerró empieza una sesión nueva con el mismo contacto. Aparece en el mismo hilo de Mensajes, debajo de la tarjeta de la sesión anterior.
En una sesión nueva el agente no ve los mensajes anteriores. Para que recuerde conversaciones previas, agrega {{sessionSummaries}} al prompt del agente: Fonema lo llena con los resúmenes de las últimas 3 sesiones del contacto, cada uno con su fecha.
Qué pasa cuando se cierra una conversación
- Fonema evalúa la conversación. Escribe un resumen (con el prompt de resumen de llamada del agente), llena las variables de salida del agente y, si el agente tiene criterios de éxito, marca la conversación como Exitosa o No exitosa. Una conversación en la que el contacto nunca escribió no se evalúa: se marca Sin respuesta y cuenta como no exitosa.
- Se agrega una tarjeta de sesión al final de la conversación en Mensajes (consulta La tarjeta de sesión).
- La secuencia de llamadas y WhatsApp avanza, cuando la conversación forma parte de una. Una conversación no exitosa, o sin respuesta, lleva al siguiente paso de la secuencia; una exitosa la termina. Consulta Secuencia de llamadas y WhatsApp.
- Se llama a tu webhook, cuando el agente tiene un webhook de fin de llamada. Consulta Para desarrolladores.
La bandeja de Mensajes
Mensajes en el menú lateral muestra todas las conversaciones de WhatsApp de tu empresa. Aparece cuando tu empresa tiene una cuenta de WhatsApp Business conectada. La ven tanto administradores como operadores.
La lista de contactos
Cada fila es un contacto, con el que escribió más recientemente arriba. Se cargan más contactos al bajar.
| Parte | Qué muestra |
|---|---|
| Nombre | El nombre del contacto según los datos que enviaste con la llamada o la campaña: una variable name, nombre o nombreCliente, o un nombre y apellidos. Si no hay ninguno, muestra --. No se muestra el nombre que el contacto usa en WhatsApp. |
| Número | El número de WhatsApp del contacto. |
| Etiqueta | Una etiqueta que el agente puso al contacto, como Interesada, cuando tu agente está configurado para etiquetar contactos. Un contacto tiene una etiqueta a la vez: una nueva reemplaza a la anterior. |
Usa el buscador sobre la lista para encontrar un contacto por número de teléfono. Escribe cualquier parte del número. La búsqueda no revisa los nombres.
La lista no se actualiza sola. Recarga la página para ver contactos que escribieron después de abrirla.
Una conversación
Haz clic en un contacto para abrir la conversación.
- Los mensajes del contacto están a la izquierda, en blanco. Los del agente, incluidas las plantillas que enviaste, están a la derecha, en verde. Cada mensaje muestra su hora, y los mensajes se agrupan por día.
- Cuando el agente usó una de sus herramientas (por ejemplo para revisar un calendario o terminar el chat), aparece una tarjeta Herramienta con su nombre encima de la respuesta. Haz clic en la flecha para ver lo que envió el agente y la Respuesta que obtuvo.
- Los mensajes más nuevos están abajo. Sube para cargar los anteriores.
- Mientras la conversación está abierta, los mensajes nuevos aparecen solos cada pocos segundos.
- Las imágenes, documentos y notas de voz aparecen como texto: la descripción, el texto del documento o la transcripción que leyó el agente, no el archivo. Consulta Imágenes y PDF.
La tarjeta de sesión
Cada vez que una conversación se cierra, una tarjeta cierra esa sesión:
| Parte | Qué muestra |
|---|---|
| Sesión finalizada | La hora en que se cerró la conversación. |
| Cerrada por inactividad | Nadie escribió durante la espera, o una plantilla no tuvo respuesta. |
| Cerrada por el agente | El agente terminó el chat. |
| Cerrada manualmente | Alguien envió fonema.endSession. |
| N mensajes | Mensajes de la sesión, del contacto y del agente. |
| Sin respuesta | El contacto nunca escribió en esta sesión. |
| Exitosa / No exitosa | El resultado según los criterios de éxito del agente. No aparece si el agente no tiene. |
| Falló el webhook | El agente tiene un webhook de fin de llamada y Fonema no pudo entregarlo. |
| Resumen | El resumen de la conversación. |
| Datos extraídos | Haz clic para ver las variables de salida que capturó el agente, cada una con su valor. |
No puedes responder desde Mensajes
Mensajes es para leer. No hay un campo para escribir al contacto y no puedes tomar la conversación: el agente responde cada mensaje.
Los mensajes se conservan después de que la conversación se cierra, así que siempre ves el historial completo de cada contacto.
Descargar tus mensajes
- Haz clic en el ícono de descarga junto al buscador.
- Elige una fecha de inicio y una de fin (los dos días se incluyen).
- Haz clic en Descargar.
Obtienes un archivo de Excel con los mensajes de todas tus conversaciones de WhatsApp en esas fechas.
Imágenes y PDF
De forma predeterminada, el agente lee lo que los contactos envían por WhatsApp:
- Imágenes: el agente recibe una descripción de la imagen, incluido el texto que muestre.
- Documentos de hasta 20 MB en PDF, Word (
.docx,.doc),.odt,.rtf, Excel (.xlsx,.xls),.html,.txto.md: el agente lee el texto. Los documentos muy largos se recortan. - Notas de voz: el agente lee una transcripción.
- Videos, stickers, ubicaciones y otros archivos: el agente dice que no puede abrirlos y pide al contacto que escriba.
Desactivar imágenes y PDF
Por privacidad puedes evitar que el agente reciba imágenes y PDF, por ejemplo cuando los contactos podrían enviar fotos de identificaciones.
- Abre el agente y haz clic en Editar Agente.
- Abre la pestaña Medios.
- Desactiva Recibir imágenes y PDF por WhatsApp.
- Haz clic en Actualizar.
El ajuste solo aparece en agentes que atienden un número de WhatsApp.
Cuando está desactivado:
- Las imágenes (también cuando se envían como archivo) y los PDF no se descargan ni se procesan.
- El agente le dice al contacto que no puede recibirlos y le pide que escriba la información.
- En Mensajes ves una nota breve en lugar del archivo.
- Los demás documentos y las notas de voz siguen funcionando.
Para desarrolladores
Para recibir cada conversación de WhatsApp en tu propio sistema cuando se cierra, pega tu endpoint HTTPS en el campo webhook de fin de llamada del agente. Fonema envía ahí los mensajes, el resumen, las variables de salida y el resultado de éxito. Consulta Fin de Sesión de WhatsApp para ver el payload y cómo se entrega.
Solución de problemas
| Problema | Qué revisar |
|---|---|
| Mensajes no aparece en el menú lateral | Tu empresa necesita una cuenta de WhatsApp Business conectada. Consulta WhatsApp Business. |
Un contacto aparece con -- como nombre | El contacto no tiene name, nombre ni nombreCliente en sus datos, por ejemplo porque escribió primero. |
| Una conversación todavía no se cierra | Se cierra 1 hora después del último mensaje, o unos 5 minutos después de que el agente termina el chat. |
| El agente no recuerda un chat anterior | Agrega {{sessionSummaries}} al prompt del agente. |
| El ajuste de imágenes no aparece en la pestaña Medios | Asigna un número de WhatsApp al agente en Teléfonos → Asignar agentes a teléfonos. |
¿Necesitas ayuda? Contáctanos.