Traducciones de Errores (PT / EN / ES)
Esta página centraliza traducciones de códigos de error usados en integraciones de Sendeasy.
Paridad con frontend
Usa el mismo modelo del frontend (backendErrors) para mantener consistencia entre:
- mensajes mostrados en el panel web
- mensajes mostrados en integraciones externas (portales, ERPs, apps propias)
Estrategia recomendada:
- Backend retorna
error(código estable). - Tu cliente traduce vía catálogo por idioma.
- Fallback al código de error cuando falte traducción.
Uso en integración
- Trata
errorcomo clave estable de máquina. - Muestra
messagecuando esté disponible. - Opcionalmente usa fallback a tu catálogo local.
Códigos comunes
| Código | Português | English | Español |
|---|---|---|---|
ERR_NO_PERMISSION | Você 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_EXPIRED | Sessão expirada. Por favor, faça login. | Session expired. Please log in. | Sesión expirada. Por favor, inicia sesión. |
ERR_API_TOKEN_NOT_PROVIDED | API token não informado. | API token was not provided. | No se proporcionó API token. |
ERR_API_TOKEN_INVALID | API token inválido. | Invalid API token. | API token inválido. |
ERR_API_TOKEN_INVALID_FORMAT | Formato de API token inválido. | Invalid API token format. | Formato de API token inválido. |
ERR_API_TOKEN_AUTHENTICATION_FAILED | Falha na autenticação do API token. | API token authentication failed. | Fallo en la autenticación del API token. |
ERR_SENDING_TEMPLATE | Erro ao enviar template. | Error sending template. | Error al enviar plantilla. |
ERR_SENDING_MESSAGE | Erro ao enviar mensagem. | Error sending message. | Error al enviar mensaje. |
ERR_SENDING_IMAGE | Erro ao enviar imagem. | Error sending image. | Error al enviar imagen. |
ERR_SENDING_VIDEO | Erro ao enviar vídeo. | Error sending video. | Error al enviar video. |
ERR_SENDING_AUDIO | Erro ao enviar áudio. | Error sending audio. | Error al enviar audio. |
ERR_SENDING_DOCUMENT | Erro ao enviar documento. | Error sending document. | Error al enviar documento. |
ERR_INVALID_WABA_RECIPIENT | Destinatário WABA inválido. | Invalid WABA recipient. | Destinatario WABA inválido. |
ERR_WAPP_NOT_CONNECTED | WhatsApp não está conectado. | WhatsApp is not connected. | WhatsApp no está conectado. |
ERR_WIDGET_TOKEN_INVALID | Token do widget inválido. | Invalid widget token. | Token del widget inválido. |
ERR_WIDGET_TOKEN_NOT_PROVIDED | Token do widget não informado. | Widget token was not provided. | No se proporcionó token del widget. |
ERR_TRY_AGAIN_LATER | Por favor, tente novamente mais tarde. | Please try again later. | Por favor, intenta de nuevo más tarde. |
FILE_TOO_LARGE | Arquivo 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. |
Ejemplo en cliente
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
}
Si tu producto es multilenguaje, versiona este catálogo junto al cliente para mantener una UX predecible entre releases.