Enviar Mensagem em Feedback

---

Introdução

Este recurso adiciona uma nova mensagem a um feedback existente. É por aqui que você responde a um pedido de esclarecimento feito pela QI Tech.

Como responder a um feedback

Ao receber a sua mensagem, o feedback passa de open para answered. Quem encerra o feedback (closed) é a QI Tech, depois de avaliar a resposta; se precisar de mais alguma coisa, ela pode abrir um novo feedback, com outro feedback_key.

Não há submit a refazer: o feedback não altera o status da análise. Veja Ciclo de vida da análise cadastral.

Request

ENDPOINT

/investor_registry/investor/{investor_key}/feedback/{feedback_key}/message

MÉTODO

PUT

STATUS

201

Request body

Request Body

{
    "message": "Confirmamos que o endereço declarado permanece válido; o titular reside no imóvel desde 2019.",
    "origin_type": "investor_analysis",
    "origin_key": "UUID"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
message	string	Conteúdo da mensagem	1 - 1000	Sim
origin_type	string	Enumerador de Origin Type. Apenas investor_analysis é aceito nesta rota	1 - 50	Sim
origin_key	string	Chave da entidade de origem (UUID)	36	Sim
document_b64	string	Anexo opcional, em base64	-	Não
file_extension	string	Extensão do anexo: jpeg, pdf ou zip. Obrigatório quando houver document_b64	-	Condicional

origin_type e origin_key devem coincidir com os do feedback

O par informado no corpo precisa ser exatamente o mesmo devolvido pelo feedback em Listar Feedbacks. Se não houver feedback com aquele feedback_key naquela origem, a chamada é recusada com IVR000085.

Response

O feedback atualizado é retornado no corpo da resposta, no mesmo formato de cada item de Listar Feedbacks, já com a nova mensagem incluída no array messages e com o status em answered.

Webhook

Responder não emite webhook. O investor_registry.feedback_status_change é emitido quando a QI Tech abre (status: open) ou encerra (status: closed) um feedback aberto por um analista — veja Webhooks de feedback.

Erros

Status	Código	Quando acontece
400	IVR000024	document_b64 não é base64 válido, ou foi enviado sem file_extension
400	IVR000075	origin_type fora do enumerador
404	IVR000085	Não há feedback com esse feedback_key na origem informada
404	IVR000011	origin_key não é uma análise cadastral deste investidor

Erros de autenticação, permissão e host: veja Erros da API.