La API de mensajes incluye los atributos adicionales Mejora

28/05/2026

Al consultar mensajes mediante la API, cada mensaje ahora devuelve el campo additional_attributes con metadatos propios del mensaje. Esto permite que las integraciones accedan a información como el nombre y el avatar del remitente original cuando un mensaje proviene de una importación o de una integración externa. Es un cambio aditivo que no modifica ni elimina ningún campo existente de la respuesta.

Mejoras

Atributos adicionales en la respuesta de mensajes Mejora

Las respuestas de la API que incluyen mensajes ahora añaden el campo additional_attributes a cada mensaje. Este campo contiene metadatos del propio mensaje, como el nombre del remitente original (senderName) y la URL de su avatar (senderAvatarUrl), cuando el mensaje proviene de una importación o de una integración externa.

Antes, este campo no se incluía en la respuesta, por lo que las aplicaciones que consumen la API no podían acceder a esa información. Con este cambio, tus integraciones pueden leer y mostrar el nombre y el avatar correctos del remitente original.

Dónde se incluye el nuevo campo:

Operación	Endpoint
Listar mensajes de una conversación	GET /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages
Respuesta de un mensaje creado	POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Cada objeto de mensaje del arreglo payload incluye ahora la clave additional_attributes, que puede contener metadatos como los siguientes:

Campo	Descripción
senderName	Nombre del remitente original del mensaje.
senderAvatarUrl	URL del avatar del remitente original.

Si un mensaje no tiene atributos adicionales, el campo se devuelve vacío.

{
  "id": 101,
  "content": "Hola, me interesa el plan Enterprise",
  "message_type": 0,
  "additional_attributes": {
    "senderName": "Whitney Francis",
    "senderAvatarUrl": "https://ejemplo.com/avatares/whitney.png"
  }
}

Consejo

No necesitas hacer ninguna configuración. El campo additional_attributes está disponible automáticamente para todas las cuentas que consumen la API, y no afecta a los campos que ya recibías. Consulta la sección de para ver la estructura completa de la respuesta.

Dentro del panel, cuando un mensaje no tiene un remitente nativo pero trae el nombre del remitente original, Zelta Chat muestra ese nombre y avatar; si no hay ninguno disponible, se usa la etiqueta Bot por defecto.