> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Personalizar as mensagens de erro

# O que são as mensagens de erro?

Cada erro devolvido pelo Zru tem um código de erro associado (por exemplo `MC2P-02003` ou `MC2P-07003`). Por defeito, quando uma operação falha, o cliente vê uma mensagem genérica do Zru. Esta secção permite-lhe **substituir essa mensagem** por um texto próprio em vários idiomas, alinhado com a voz da sua marca.

# Como aceder às Mensagens de erro

- Vá a **Configuração** no menu lateral.
- Clique no mosaico **«Mensagens de erro»**.

# A lista de mensagens

A partir da lista pode procurar mensagens por código ou por texto. Para cada mensagem verá três colunas: **Código** (o código de erro que substitui), **Texto** (o início do texto personalizado) e **Idiomas** (as bandeiras dos idiomas em que está configurado).

# Como criar uma mensagem personalizada

- Clique em **«Nova mensagem»** no canto superior direito.
- Abre-se a janela **Adicionar**.
- Selecione o **Código de erro** que pretende substituir. Pode consultar a lista completa de códigos em [docs.zrupay.com/tools/errors](http://docs.zrupay.com/tools/errors).
- Escreva o texto personalizado nos idiomas de que precisar. Existe um campo para cada um dos **9 idiomas disponíveis**: Espanhol, Inglês, Português, Catalão, Alemão, Italiano, Francês, Galego e Basco.
- Clique em **«Criar»**.

# Casos de uso típicos

- Reformular mensagens técnicas em linguagem natural. Por exemplo, um erro de autenticação 3DS pode ser substituído por «Não conseguimos verificar o seu cartão. Por favor, tente com outro.»
- Incluir instruções para que o cliente contacte o seu suporte.
- Adaptar o tom ao público-alvo (B2B, B2C, setores regulados...).

# Ligação com as Estatísticas

A secção **Estatísticas** ▶︎ **Otimização** inclui o bloco **Erros por tipologia**, que mostra que códigos estão a ocorrer com mais frequência na sua conta e que percentagem representa cada um. Esses são os candidatos prioritários a personalizar aqui: se um código concentra a maioria dos seus erros, uma mensagem clara pode reduzir a fricção do cliente e melhorar a conversão.