Mensajes

En esta sección se detallan los distintos tipos de mensajes que pueden enviarse y recibirse dentro de una atención, así como los estados que muestran su progreso durante la comunicación con el cliente.

Los mensajes son el medio principal de interacción entre el agente y el cliente, y pueden variar según su tipo, contenido y propósito.

Tipos de mensajes enviados

Los agentes pueden enviar los siguientes tipos de mensajes desde la barra de mensajes:

Mensajes de texto

Permiten mantener una comunicación escrita directa con el cliente.
Pueden incluir texto libre, emojis y enlaces, brindando una comunicación rápida y personalizada.

Mensajes multimedia

Permiten compartir archivos adjuntos como imágenes, videos, documentos o notas de voz.
Este tipo de mensajes es útil para enviar información visual o archivos complementarios durante la atención.

Mensajes de voz

Consisten en grabaciones enviadas directamente desde el micrófono del dispositivo.
Son ideales para responder de forma rápida o transmitir información con un tono de voz más personal.

Mensajes recibidos

Los mensajes que envía el cliente se muestran en el chat con un formato visual diferenciado.
Pueden incluir texto, archivos, notas de voz, ubicaciones, contactos o stickers compatibles con la plataforma.

Los agentes pueden visualizar y descargar estos elementos directamente desde la conversación, siempre respetando las políticas de seguridad y confidencialidad de la información.

Mensajes de texto

Comunicación escrita que puede incluir emojis, enlaces o fragmentos de texto formateado (como negritas o cursivas).

Mensajes multimedia

Incluyen imágenes, documentos, videos o notas de voz enviadas por el cliente.
Pueden descargarse o visualizarse dentro de la misma ventana de atención.

Mensajes de voz

Mensajes grabados directamente desde el micrófono del cliente.
El agente puede reproducirlos sin necesidad de descargarlos.

Mensaje de contacto

El cliente puede compartir la información de un contacto de su agenda.
Estos mensajes muestran el nombre y número del contacto, permitiendo su identificación o registro si es necesario.

Mensaje de ubicación

Permite al cliente compartir su ubicación actual o una dirección específica.
El mensaje incluye un enlace directo a la ubicación en Google Maps.

Mensaje de sticker

Los stickers son imágenes ilustradas o animadas que el cliente puede enviar como parte de la conversación.
Se muestran directamente en el chat, igual que las imágenes estáticas.

Estados del mensaje

Cada mensaje enviado pasa por distintos estados que reflejan su progreso dentro del sistema y su entrega al cliente.
Estos estados se muestran mediante íconos junto a cada mensaje, lo que permite identificar fácilmente su situación actual:

Estado	Ícono	Descripción
Enviando		El mensaje está siendo procesado por la plataforma y aún no ha salido del sistema.
Enviado		El mensaje salió correctamente del agente, pero todavía no ha llegado al dispositivo del cliente.
Entregado		El mensaje fue recibido en el dispositivo del cliente, pero aún no ha sido leído.
Visto		El cliente abrió y leyó el último mensaje enviado por el agente.
Fallido		El mensaje no pudo ser entregado por un error en la plataforma o en los servicios de Meta.

Mensajes plantilla

Los mensajes plantilla son mensajes aprobados por Meta que permiten iniciar o reanudar conversaciones fuera de la ventana de atención de 24 horas.
Cada plantilla tiene un formato predefinido y, en algunos casos, incluye campos variables que deben completarse antes de enviarla.

Estos mensajes solo pueden ser enviados por los agentes, nunca por los clientes.
Por lo tanto, no se recibirán mensajes plantilla, únicamente se podrán enviar desde la barra de mensajes cuando la conversación se encuentre fuera del tiempo permitido de respuesta.

Para más información sobre su uso, consulte la sección Mensajes plantilla.

Mensajes rápidos

Los mensajes rápidos son respuestas predefinidas creadas por los agentes para agilizar la comunicación con los clientes.
Estos mensajes pueden incluir texto, imágenes o archivos adjuntos, pero por el momento no admiten notas de voz.

Su uso permite responder de forma más eficiente y mantener una comunicación coherente con las políticas del servicio.
Una vez enviados, los mensajes rápidos se muestran en la conversación como un mensaje normal, sin distinción visual o funcional frente a otros tipos de mensaje.

Para más información sobre su uso, consulte la sección Mensajes rápidos.

---

Recomendaciones

• Verifique siempre el estado del mensaje para confirmar que la comunicación se haya completado correctamente.
• Si un mensaje muestra error de envío, revise su conexión o reintente el envío.
• En caso de atención expirada, solo se podrá enviar un mensaje plantilla hasta que el cliente responda o se reabra la conversación.

Errores comunes de la API de Meta

A continuación, se muestra una lista de errores comunes que pueden ocurrir al trabajar con la API de WhatsApp Business, junto con sus descripciones.

Código	Error	Descripción
131047	El contacto no puede recibir mensajes	WhatsApp no permite enviar mensajes a este número en este momento. Esto puede deberse a una restricción aplicada por Meta, a que el usuario bloqueó la conversación o a que el número no esté disponible.
131026	Mensaje no entregable	El mensaje no pudo ser entregado al contacto. Esto puede ocurrir cuando el tipo de mensaje no es permitido o el contacto tiene restricciones para recibir mensajes.
131051	Fuera de la ventana de 24 horas	El contacto no ha interactuado recientemente. Solo es posible enviar mensajes usando una plantilla aprobada por WhatsApp.
132000	Plantilla no encontrada	La plantilla utilizada no existe, fue eliminada o no está disponible en el idioma seleccionado.
132001	Plantilla no aprobada	La plantilla aún no está aprobada por WhatsApp o fue rechazada. No es posible enviar mensajes con esta plantilla.
132005	Variables de plantilla incorrectas	La cantidad o el formato de las variables enviadas no coincide con la plantilla. Verifica que todas las variables requeridas estén presentes y correctamente formateadas.
131048	Límite o restricción por calidad	WhatsApp ha limitado temporalmente el envío de mensajes debido a volumen alto, reportes de spam o baja calificación de calidad.
131009	Cuenta restringida temporalmente	La cuenta de WhatsApp tiene una restricción temporal aplicada por Meta. No es posible enviar mensajes hasta que la restricción sea levantada.
190	Error de autenticación	El token de acceso no es válido o ha expirado. Es necesario renovar las credenciales para continuar enviando mensajes.
100	Solicitud inválida	La solicitud contiene parámetros inválidos o mal formados. Verifica la información enviada antes de volver a intentar.
131053	Error al procesar el archivo	El archivo enviado no pudo ser procesado. Verifica que el formato y tamaño sean compatibles con WhatsApp.
131052	No se pudo descargar el archivo	WhatsApp no pudo acceder al archivo proporcionado. Asegúrate de que la URL sea pública y accesible.
130472	El contacto no puede recibir mensajes	El número del contacto tiene una restricción aplicada por WhatsApp como parte de un experimento de Meta. El mensaje no pudo ser entregado. El envío será posible cuando el contacto inicie la conversación.
131000	Error temporal al enviar el mensaje	No fue posible enviar el mensaje debido a un error interno de WhatsApp. Inténtalo nuevamente en unos minutos. Si el problema persiste, es necesario escalar el caso a soporte.
131042	Problema de facturación de WhatsApp	No se pudo enviar el mensaje debido a un problema con la configuración de facturación de la cuenta de WhatsApp Business. Es necesario revisar el método de pago, la línea de crédito y el estado de la cuenta.