GET /api/action/mapaprop-chat-ai-v1/history/{questionId}

BETA

Devuelve el historial completo de una conversación: los datos de contacto del visitante, el mensaje inicial y todos los mensajes agregados al hilo, ordenados cronológicamente.

Información del recurso
Autenticación	Requerida (Token de API, Bearer)
Scope	`mapaprop-chat-ai`
HTTP Method	GET
Response	JSON
Version	1

URL del recurso

https://mapaprop.app/api/action/mapaprop-chat-ai-v1/history/{questionId}

Parámetros

Key	Type	Required	Descripción
questionId	int	sí	ID de la conversación. Se envía como parte de la URL (path param), no como query string ni body.

Código de ejemplo

GET /api/action/mapaprop-chat-ai-v1/history/481203 HTTP/1.1
Host: mapaprop.app
Authorization: Bearer {access_token}

Respuesta

Objeto	Campo	Tipo	Requerido	Descripción
Response	questionId	int	sí	El ID de la conversación consultada.
	leadName	string	sí	Nombre del visitante.
	leadEmail	string	no	Email del visitante.
	leadPhone	string	no	Teléfono del visitante.
	sessionId	string	no	Identificador de sesión asociado a la conversación.
	createdAt	string	sí	Fecha/hora de creación de la conversación.
	messageCount	int	sí	Cantidad total de mensajes (mensaje inicial + hilo).
	messages	array de objetos	sí	Los mensajes de la conversación, en orden cronológico. Ver estructura abajo.
	metadata	object o string	no	Metadata adicional guardada en la conversación (por ejemplo `propertiesReferenced`, `customerSearch`). Si el dato guardado no es un JSON válido, se devuelve como string tal cual.

Estructura de cada elemento de `messages`

Campo	Tipo	Descripción
id	int	`0` para el mensaje inicial de la conversación; `1, 2, 3...` para los mensajes del hilo, en orden.
from	string	Nombre del remitente.
message	string	El contenido del mensaje.
direction	int	`1` = entrante/visitante, `2` = saliente/asesor o sistema, `3` = IA.
timestamp	string	Fecha/hora del mensaje.

Errores

Error	Causa
`QUESTION_NOT_FOUND`	El `questionId` enviado no existe o no pertenece a este cliente.

Errores de validación (se corta la request)

Error	Causa
`REQUIRED_INPUT` — "questionId is required"	El path param `questionId` no es un número válido.

Ejemplo de respuesta

{
    "questionId": 481203,
    "leadName": "Juan Pérez",
    "leadEmail": "juan@example.com",
    "leadPhone": "+54 9 11 5555-5555",
    "sessionId": "b6d1c6b0-2f2a-4e2e-9a4a-8e0a2a2f2a11",
    "createdAt": "2026-08-01 14:32:10",
    "messageCount": 3,
    "messages": [
        {
            "id": 0,
            "from": "Juan Pérez",
            "message": "Nueva conversacion de Chat AI",
            "direction": 1,
            "timestamp": "2026-08-01 14:32:10"
        },
        {
            "id": 1,
            "from": "AI Assistant",
            "message": "Hola Juan! Soy el asistente virtual de la inmobiliaria. ¿En qué puedo ayudarte?",
            "direction": 3,
            "timestamp": "2026-08-01 14:32:10"
        },
        {
            "id": 2,
            "from": "Juan Pérez",
            "message": "¿Tenés departamentos de 2 ambientes en Palermo?",
            "direction": 1,
            "timestamp": "2026-08-01 14:33:02"
        }
    ]
}