PTENES

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_EMAIL_INVALID_BODYPayload de e-mail inválido.Invalid email payload.Payload de email inválido.
ERR_EMAIL_TOO_MANY_RECIPIENTSMuitos destinatários em um único envio (máximo 10).Too many recipients in a single send (max 10).Demasiados destinatarios en un solo envío (máximo 10).
ERR_NO_EMAIL_CREDITSSem créditos de e-mail.No email credits.Sin créditos de email.
ERR_NO_BOT_CREDITSSem créditos de bot.No bot credits.Sin créditos de bot.
ERR_PUBLIC_EMAIL_RATE_LIMITLimite de requisições de e-mail excedido.Email request limit exceeded.Límite de solicitudes de email excedido.
ERR_PUBLIC_AI_RATE_LIMITLimite de requisições de IA excedido.AI request limit exceeded.Límite de solicitudes de IA excedido.
ERR_EMAIL_SEND_FAILEDFalha ao enviar e-mail.Failed to send email.Error al enviar email.
ERR_EMAIL_SENDER_NOT_CONFIGUREDProjeto sem e-mail verificado para envio.Project has no verified sender email.Proyecto sin email verificado para envío.
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?