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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
consultationId | number | ✅ | 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
}