Skip to main content

POST Abrir Entrevista por Voz

Abre a entrevista por voz da triagem. Cria a sala LiveKit (gravando quando houver consentimento) e devolve token, sala e a pergunta de abertura, que é fixa. Idempotente: com entrevista em andamento devolve a mesma.

Só com token de usuário

Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: com x-api-key a resposta é 401 "Esta ação exige um usuário autenticado".

Permissão necessária

Exige a permissão update_triages.


Endpoint​

POST https://api-dev.imagemais.com.br/api/triages/{id}/interview/start

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID da triagem

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
recordingConsentboolean✅—O paciente autorizou a gravação do áudio. Sem autorização a entrevista acontece sem gravar.

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/interview/start' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"recordingConsent": true
}'

Respostas​

201 Sucesso​

{
"interviewId": 14,
"status": "IN_PROGRESS",
"roomName": "triage-20",
"token": "••••••••",
"recordingState": "DISABLED",
"currentTurn": {
"id": 135,
"interviewId": 14,
"position": 1,
"question": "Texto de exemplo.",
"source": "AI",
"answer": null,
"answeredAt": null,
"createdAt": "2026-09-30T18:52:55.081Z"
},
"turns": [
{
"id": 135,
"interviewId": 14,
"position": 1,
"question": "Texto de exemplo.",
"source": "AI",
"answer": null,
"answeredAt": null,
"createdAt": "2026-09-30T18:52:55.081Z"
}
]
}

400 Requisição inválida​

Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:

{
"message": [
"recordingConsent must be a boolean value"
],
"error": "Bad Request",
"statusCode": 400
}

Outras mensagens possíveis:

  • Validation failed (numeric string is expected)
  • Triagem precisa de um motivo para iniciar a entrevista
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

401 Não autorizado​

{
"message": "Esta ação exige um usuário autenticado",
"error": "Unauthorized",
"statusCode": 401
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

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

409 Conflito​

Mensagens possíveis:

  • Esta triagem já teve a entrevista encerrada
  • A entrevista só pode ser retomada enquanto a triagem está em coleta
  • A entrevista só pode ser iniciada enquanto a triagem está em coleta
{
"message": "Esta triagem já teve a entrevista encerrada",
"error": "Conflict",
"statusCode": 409
}