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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da triagem |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
recordingConsent | boolean | ✅ | — | 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 encerradaA entrevista só pode ser retomada enquanto a triagem está em coletaA entrevista só pode ser iniciada enquanto a triagem está em coleta
{
"message": "Esta triagem já teve a entrevista encerrada",
"error": "Conflict",
"statusCode": 409
}