Saltar al contenido principal

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é pasaCuándo se cierra la conversación
Nadie escribe durante un rato1 hora después del último mensaje. Cada mensaje nuevo reinicia la espera.
El agente termina el chatUnos 5 minutos después de la despedida del agente.
Enviaste una plantilla y el contacto nunca responde1 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.

Probar tu agente

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​

  1. 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.
  2. Se agrega una tarjeta de sesión al final de la conversación en Mensajes (consulta La tarjeta de sesión).
  3. 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.
  4. 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.

ParteQué muestra
NombreEl 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úmeroEl número de WhatsApp del contacto.
EtiquetaUna 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:

ParteQué muestra
Sesión finalizadaLa hora en que se cerró la conversación.
Cerrada por inactividadNadie escribió durante la espera, o una plantilla no tuvo respuesta.
Cerrada por el agenteEl agente terminó el chat.
Cerrada manualmenteAlguien envió fonema.endSession.
N mensajesMensajes de la sesión, del contacto y del agente.
Sin respuestaEl contacto nunca escribió en esta sesión.
Exitosa / No exitosaEl resultado según los criterios de éxito del agente. No aparece si el agente no tiene.
Falló el webhookEl agente tiene un webhook de fin de llamada y Fonema no pudo entregarlo.
ResumenEl resumen de la conversación.
Datos extraídosHaz 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​

  1. Haz clic en el ícono de descarga junto al buscador.
  2. Elige una fecha de inicio y una de fin (los dos días se incluyen).
  3. 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, .txt o .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.

  1. Abre el agente y haz clic en Editar Agente.
  2. Abre la pestaña Medios.
  3. Desactiva Recibir imágenes y PDF por WhatsApp.
  4. 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​

ProblemaQué revisar
Mensajes no aparece en el menú lateralTu empresa necesita una cuenta de WhatsApp Business conectada. Consulta WhatsApp Business.
Un contacto aparece con -- como nombreEl contacto no tiene name, nombre ni nombreCliente en sus datos, por ejemplo porque escribió primero.
Una conversación todavía no se cierraSe 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 anteriorAgrega {{sessionSummaries}} al prompt del agente.
El ajuste de imágenes no aparece en la pestaña MediosAsigna un número de WhatsApp al agente en Teléfonos → Asignar agentes a teléfonos.

¿Necesitas ayuda? Contáctanos.