Skip to main content

GET Buscar ou Criar Conversa da Consulta

Retorna ou cria a conversa de uma consulta. Inicializa o chat: retorna conversationId e histórico de mensagens. Cria a conversa se a consulta ainda não tiver uma. conversationId vazio significa consulta legada não migrada — o chat fica indisponível nela até a migração rodar.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Sem permissão específica

Não exige @CheckPermissions — basta estar autenticado.

Cria a conversa se não existir

Na primeira chamada para a consulta, a conversa é criada. Chamadas seguintes retornam a mesma conversa.


Endpoint​

GET https://api-dev.imagemais.com.br/api/ai/consultation/{consultationId}/conversation

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
consultationIdnumber✅ID da consulta

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/ai/consultation/1/conversation' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"conversationId": "conv_6abd5ace4c048194bfc3f99ea22a92ca0169a57fda32c3bf",
"messages": []
}

400 Requisição inválida​

{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

404 Não encontrado​

{
"message": "Consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}