Traduções de Erros (PT / EN / ES)

Esta página centraliza traduções de códigos de erro usados nas integrações da Sendeasy.

Paridade com frontend

Use o mesmo modelo do frontend (backendErrors) para manter consistência entre:

  • mensagens exibidas no painel web
  • mensagens exibidas em integrações externas (portais, ERPs, apps próprios)

Estratégia recomendada:

  1. Backend retorna error (código estável).
  2. Seu client traduz via catálogo por idioma.
  3. Fallback para o código se não houver tradução.

Como usar na integração

  1. Trate error como chave estável de máquina.
  2. Exiba message quando disponível.
  3. Se necessário, faça fallback pelo seu próprio catálogo local.

Códigos comuns

CódigoPortuguêsEnglishEspañol
ERR_NO_PERMISSIONVocê não tem permissão para acessar este recurso.You do not have permission to access this resource.No tienes permiso para acceder a este recurso.
ERR_SESSION_EXPIREDSessão expirada. Por favor, faça login.Session expired. Please log in.Sesión expirada. Por favor, inicia sesión.
ERR_API_TOKEN_NOT_PROVIDEDAPI token não informado.API token was not provided.No se proporcionó API token.
ERR_API_TOKEN_INVALIDAPI token inválido.Invalid API token.API token inválido.
ERR_API_TOKEN_INVALID_FORMATFormato de API token inválido.Invalid API token format.Formato de API token inválido.
ERR_API_TOKEN_AUTHENTICATION_FAILEDFalha na autenticação do API token.API token authentication failed.Fallo en la autenticación del API token.
ERR_SENDING_TEMPLATEErro ao enviar template.Error sending template.Error al enviar plantilla.
ERR_SENDING_MESSAGEErro ao enviar mensagem.Error sending message.Error al enviar mensaje.
ERR_SENDING_IMAGEErro ao enviar imagem.Error sending image.Error al enviar imagen.
ERR_SENDING_VIDEOErro ao enviar vídeo.Error sending video.Error al enviar video.
ERR_SENDING_AUDIOErro ao enviar áudio.Error sending audio.Error al enviar audio.
ERR_SENDING_DOCUMENTErro ao enviar documento.Error sending document.Error al enviar documento.
ERR_INVALID_WABA_RECIPIENTDestinatário WABA inválido.Invalid WABA recipient.Destinatario WABA inválido.
ERR_WAPP_NOT_CONNECTEDWhatsApp não está conectado.WhatsApp is not connected.WhatsApp no está conectado.
ERR_WIDGET_TOKEN_INVALIDToken do widget inválido.Invalid widget token.Token del widget inválido.
ERR_WIDGET_TOKEN_NOT_PROVIDEDToken do widget não informado.Widget token was not provided.No se proporcionó token del widget.
ERR_TRY_AGAIN_LATERPor favor, tente novamente mais tarde.Please try again later.Por favor, intenta de nuevo más tarde.
FILE_TOO_LARGEArquivo muito grande. O tamanho máximo é de 10MB.File too large. The maximum size is 10MB.Archivo demasiado grande. El tamaño máximo es de 10MB.

Exemplo de tratamento no client

const fallbackTranslations = {
  ERR_NO_PERMISSION: {
    pt: 'Você não tem permissão para acessar este recurso.',
    en: 'You do not have permission to access this resource.',
    es: 'No tienes permiso para acceder a este recurso.',
  },
}

function resolveErrorMessage(errorCode, locale, backendMessage) {
  return backendMessage || fallbackTranslations?.[errorCode]?.[locale] || errorCode
}

Se seu produto for multilíngue, mantenha esse catálogo versionado junto com seu cliente para garantir previsibilidade de UX.

Essa informação foi útil?