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 — e é a mensagem que encerra o feedback.

Como responder a um feedback

A resposta é uma única ação: enviar a mensagem neste endpoint. Ao recebê-la, o feedback passa de open para closed e a análise de compliance retoma a avaliação.

Não há submit a refazer: a análise permaneceu em in_compliance_analysis durante todo o ciclo do feedback. 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

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.

Enviar mensagem encerra o feedback

Um feedback open passa a closed assim que a sua mensagem é registrada. Envie tudo o que precisa dizer em uma única mensagem — um feedback já encerrado não aceita novas mensagens, e não há endpoint para reabri-lo. Se a QI Tech precisar de mais alguma coisa, ela abre um novo feedback, com um novo feedback_key.

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 closed.

Webhook

O encerramento dispara um investor_registry.feedback_status_change com status: closed:

Webhook Body — feedback encerrado

{
    "webhook_type": "investor_registry.feedback_status_change",
    "webhook_datetime": "2026-07-31T22:12:03Z",
    "data": {
        "investor_analysis_key": "UUID",
        "feedback_key": "UUID",
        "status": "closed",
        "origin_type": "investor_analysis",
        "origin_key": "UUID"
    }
}

O detalhamento dos campos está em Webhooks de feedback.