> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# registrar_feedback

> Envia ao time da Pipo um feedback sobre uma resposta ou sobre o MCPipo

Envia ao time da Pipo um feedback seu sobre uma resposta do assistente ou sobre o MCPipo em geral. Use para relatar um problema, sugerir uma melhoria ou fazer um elogio.

> [!WARNING]
>
> **Esta é a única ferramenta do MCPipo que grava algo.** Ela guarda o texto do seu feedback para o time da Pipo. Ela **não** altera membros, benefícios, movimentações nem nenhum outro dado da sua operação.

> [!WARNING]
>
> **Não coloque no feedback dados pessoais, dados de saúde, senhas ou tokens.** O texto fica guardado e é lido pelo time da Pipo. A ferramenta recusa textos que parecem tokens ou chaves de acesso, mas não remove dados pessoais.

## Parâmetros

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `mensagem` | Sim | Texto do feedback, de 1 a 2 000 caracteres. Em alguns assistentes, se a mensagem faltar, aparece um formulário para você escrever. |
| `alvo` | Não | Sobre o que é o feedback: `resposta` ou `mcpipo`. Padrão `mcpipo`. |
| `categoria` | Não | `problema`, `sugestao`, `elogio` ou `outro`. Padrão `outro`. |
| `avaliacao` | Não | `positivo` ou `negativo`. Use só se você mesmo der a avaliação. |
| `ferramenta` | Não | Nome da ferramenta a que o feedback se refere, por exemplo `listar_membros_empresa`. Até 100 caracteres. |
| `cnpj` | Não | CNPJ da empresa relacionada, só com os 14 dígitos, sem pontuação. A Pipo confere se a sua conta acessa essa empresa. |
| `id_envio` | Não | UUID para reenviar o mesmo feedback sem duplicar. Veja abaixo. |

> [!NOTE]
>
> **O que é guardado:** só o feedback que você envia e os campos da tabela acima, junto com a versão do MCPipo e a data. A conversa e a resposta completa do assistente **não** são copiadas. As avaliações de "gostei" e "não gostei" do próprio assistente **não** chegam à Pipo: para avaliar, envie o feedback por esta ferramenta.

## Confirmação e reenvio

Quando o feedback é guardado, a resposta traz `registrado: true`, o ID do feedback (`feedback_id`) e a data de registro (`registrado_em`). A ferramenta só confirma depois de guardar. Se ela não conseguir confirmar, a resposta diz isso.

Cada envio cria um feedback novo. Para tentar de novo sem duplicar, envie o mesmo texto com o mesmo `id_envio`: a Pipo devolve a confirmação do primeiro envio. Isso só funciona com o mesmo login; depois que o login é renovado, o reenvio conta como um feedback novo. Um `id_envio` já usado com outro texto é recusado.

Se você cancelar o formulário, nada é guardado. Não é possível consultar nem apagar um feedback pelo MCPipo.

## Exemplos de perguntas

* "Envie este feedback para a Pipo: a lista de membros demorou muito"
* "Quero sugerir uma melhoria no MCPipo"
* "Registra que essa resposta sobre sinistralidade veio errada"


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.