POST Iniciar Entrevista Guiada por IA
Cria uma sessão do assistente de entrevista a partir dos sinais vitais e do motivo da consulta já salvos na pré-consulta, e vincula a sessão à pré-consulta. A IA gera o plano de perguntas (e, quando identifica uma especialidade pelo motivo, acrescenta perguntas específicas); a sessão já começa no estado ASKING_QUESTION.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Exige a permissão update_preconsultations.
Endpoint
POST https://api-dev.imagemais.com.br/api/pre-consultations/{id}/interview
Path Parameter
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da pré-consulta |
Sem corpo — os dados vêm da própria pré-consulta.
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/pre-consultations/29/interview' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
201 Sucesso
Retorna a sessão do assistente. vitals é a cópia dos dados da pré-consulta usada para montar a entrevista; agentType é a especialidade identificada pelo motivo (ou null).
{
"id": 20,
"userId": 1,
"accountId": 1,
"consultationId": null,
"preConsultationId": 29,
"triageId": null,
"state": "ASKING_QUESTION",
"livekitRoomName": null,
"clinicalSummary": null,
"createdAt": "2026-09-29T22:53:58.075Z",
"updatedAt": "2026-09-29T22:53:58.229Z",
"agentType": null,
"vitals": {
"height": "175",
"weight": "70",
"glucose": "90",
"heartRate": "72",
"patientId": 53,
"temperature": "36.5",
"bloodPressure": "120/80",
"consultationReason": "Dor de cabeça há 3 dias"
},
"patientId": 53
}
400 Sem motivo da consulta
Retornado quando a pré-consulta não tem consultationReason.
{
"message": "Pré-consulta precisa de um motivo de consulta para iniciar a entrevista",
"error": "Bad Request",
"statusCode": 400
}
404 Pré-consulta não encontrada
Retornado quando o id não existe, foi excluído ou pertence a outra conta.
{
"message": "Pré-consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}