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

BETA

Retorna o histórico completo de uma conversa: os dados de contato do visitante, a mensagem inicial e todas as mensagens adicionadas ao fio, ordenadas cronologicamente.

Informação do recurso
Autenticação	Obrigatória (Token de API, Bearer)
Scope	`mapaprop-chat-ai`
HTTP Method	GET
Response	JSON
Version	1

URL do recurso

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

Parâmetros

Key	Type	Required	Descrição
questionId	int	sim	ID da conversa. É enviado como parte da URL (path param), não como query string nem body.

Código de exemplo

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

Resposta

Objeto	Campo	Tipo	Obrigatório	Descrição
Response	questionId	int	sim	O ID da conversa consultada.
	leadName	string	sim	Nome do visitante.
	leadEmail	string	não	Email do visitante.
	leadPhone	string	não	Telefone do visitante.
	sessionId	string	não	Identificador de sessão associado à conversa.
	createdAt	string	sim	Data/hora de criação da conversa.
	messageCount	int	sim	Quantidade total de mensagens (mensagem inicial + fio).
	messages	array de objetos	sim	As mensagens da conversa, em ordem cronológica. Ver estrutura abaixo.
	metadata	object ou string	não	Metadata adicional salva na conversa (por exemplo `propertiesReferenced`, `customerSearch`). Se o dado salvo não for um JSON válido, é retornado como string tal qual.

Estrutura de cada elemento de `messages`

Campo	Tipo	Descrição
id	int	`0` para a mensagem inicial da conversa; `1, 2, 3...` para as mensagens do fio, em ordem.
from	string	Nome do remetente.
message	string	O conteúdo da mensagem.
direction	int	`1` = entrante/visitante, `2` = saída/atendente ou sistema, `3` = IA.
timestamp	string	Data/hora da mensagem.

Erros

Erro	Causa
`QUESTION_NOT_FOUND`	O `questionId` enviado não existe ou não pertence a este cliente.

Erros de validação (a requisição é cortada)

Erro	Causa
`REQUIRED_INPUT` — "questionId is required"	O path param `questionId` não é um número válido.

Exemplo de resposta

{
    "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"
        }
    ]
}