Registros de errores - Tabla de categorías de códigos de error

Descripción general

A cada error se le asigna un código de error entero de 4 dígitos almacenado en la base de datos. El código codifica tanto la categoría principal como el tipo específico de error:

Formato: MMEE

MM = Código de categoría principal (10-28, 99)

EE = Error específico dentro de la categoría (01-12, 99 = genérico)

Ejemplos:

1001 = Límite de tasa de la plataforma › Límite de cantidad de usuarios del bot en el espacio de trabajo

1101 = Límite de tasa del proveedor de IA › Se excedió tokens por minuto (TPM)

1901 = Falla en la entrega de mensajes › Bloqueo de interacción del ecosistema de WhatsApp

2301 = Tiempo de espera de conexión con el proveedor de IA › Tiempo de espera SSL hacia el endpoint de IA

Tabla de referencia de categorías

| Código

| Etiqueta | Descripción | Mensajes de error de ejemplo |

| 10

| Límite de tasa de la plataforma | Límites de tasa aplicados por la propia plataforma de chatbot: topes de usuarios del bot por espacio de trabajo, limitación por smart delay o límites de respuesta a comentarios. | - Se excedió el límite de tasa. Vuelve a intentarlo después de un tiempo.

• Los usuarios del bot en el espacio de trabajo superan el límite
• Se usaron más de 50 smart delay en las últimas 24 horas.
• Error de respuesta a comentario: límite aplicado por prevención de spam de la comunidad |

| 11

| Límite de tasa del proveedor de IA | Límites de tokens por minuto (TPM) o solicitudes por minuto (RPM) devueltos por OpenAI, XAI u otros proveedores de API de IA. | - Error de OpenAi: Se alcanzó el límite de tasa para gpt-4o en tokens por minuto (TPM): Límite 30000, Usado 30000

• Error de OpenAi: Se alcanzó el límite de tasa para gpt-4o-mini en solicitudes por minuto (RPM)
• Error de XAi: Se agotó algún recurso |

| 12

| Facturación y cuota | Agotamiento de cuota de facturación, créditos insuficientes o acceso a funciones que requieren un plan de suscripción superior. | - Error de OpenAi: Excediste tu cuota actual, revisa tu plan y los detalles de facturación.

• Esta solicitud excede tu cuota. Te quedan 14 créditos.
• Solo función Pro
• Alcanzaste tu límite mensual. |

| 13

| Autenticación y API Key | API Key inválidas, faltantes o no verificadas, y credenciales de autenticación para proveedores de IA o servicios externos. | - Error de OpenAi: Se proporcionó una API key incorrecta: sk-proj-****.

• El proveedor de IA no está verificado. openai
• {"detail":{"status":"invalid_api_key","message":"Invalid API key"}} |

| 14

| Integración no conectada | Un servicio externo integrado (OpenAI, Meta, Shopify, etc.) no se ha vinculado o configurado en la cuenta de la plataforma. | - Open AI no conectado

• Meta Conversions API no conectada
• La cuenta de Shopify no está conectada |

| 15

| Autorización y permisos | Errores de permisos del bot o del usuario: el bot fue bloqueado por el usuario, la cuenta del usuario está desactivada o el bot no tiene permiso para iniciar conversaciones. | - Prohibido: el bot fue bloqueado por el usuario

• Prohibido: el usuario está desactivado
• Prohibido: el bot no puede iniciar una conversación con un usuario |

| 16

| Restricción de cuenta y negocio | Cuenta de WhatsApp Business bloqueada por Meta, o problemas de pago/elegibilidad del negocio que impiden el envío de mensajes. | - Error de WhatsApp: [{"code":131031,"title":"Business Account locked","error_data":{"details":"Business account has been locked."}}]

• Error de WhatsApp: [{"code":131042,"title":"Business eligibility payment issue","error_data":{"details":"Message failed to send due to payment method errors."}}] |

| 17

| Suscripción y estado del usuario | Exclusiones del usuario, cancelaciones de suscripción, estado pausado del bot, conversaciones inválidas o cerradas, o chat no encontrado. | - Falló la difusión, usuario del bot desuscrito

• Mensaje no enviado porque no está suscrito
• Mensaje no enviado porque el bot está pausado
• La conversación es inválida
• Solicitud incorrecta: chat no encontrado |

| 18

| Ventana de mensajería y política | Mensajes enviados fuera de la ventana permitida de mensajería (regla de 24 horas para WhatsApp / Messenger), restricciones de frecuencia por spam o respuestas a una actividad ya respondida. | - Error de WhatsApp: [{"code":131047,"title":"Re-engagement message","error_data":{"details":"More than 24 hours have passed since the customer last replied."}}]

• Error de Meta: 2018278 (#10) Este mensaje se envió fuera de la ventana permitida.
• Mensaje no enviado porque está fuera de las 24 horas
• Error de WhatsApp: [{"code":131048,"title":"Spam Rate limit hit"}]
• Error de Meta: (#10900) La actividad ya fue respondida |

| 19

| Falla en la entrega de mensajes | Mensajes que no pudieron entregarse al destinatario debido a restricciones del ecosistema, indisponibilidad del destinatario, participación en experimentos A/B o una interrupción temporal del servicio. | - Error de WhatsApp: [{"code":131049,"title":"This message was not delivered to maintain healthy ecosystem engagement."}]

• Error de WhatsApp: [{"code":131026,"title":"Message undeliverable"}]
• Error de Meta: 1545041 (#551) Esta persona no está disponible en este momento.
• Error de WhatsApp: [{"code":130472,"title":"User's number is part of an experiment"}]
• Error de Meta: 1545133 Servicio temporalmente no disponible |

| 20

| Error de plantilla de WhatsApp | Errores relacionados con plantillas de mensajes de WhatsApp: plantillas faltantes, desajustes en cantidad o formato de parámetros, plantillas pausadas por calidad o texto que excede los límites. | - (#132001) El nombre de la plantilla no existe en la traducción

• (#132000) La cantidad de parámetros no coincide con la cantidad esperada de parámetros
• (#132012) El formato del parámetro no coincide con el formato de la plantilla creada
• (#132015) La plantilla no está disponible temporalmente; está pausada por baja calidad.
• (#132005) El texto traducido es demasiado largo
• (#132018) Debe estar presente uno entre media ID o link
• Plantilla de mensaje de WhatsApp no encontrada |

| 21

| Error de medios y archivos | Errores al subir, descargar o validar archivos multimedia: tipo MIME incorrecto, archivo demasiado grande, URL inaccesible, formato de imagen inválido o falla en la transcripción de audio. | - Error de WhatsApp: [{"code":131053,"title":"Media upload error","error_data":{"details":"Unsupported Image mime type text/html."}}]

• Error de WhatsApp: [{"code":131053,"title":"Media upload error","error_data":{"details":"Image file has size 6097199 bytes but must be atmost 5242880 bytes"}}]
• Error de WhatsApp: [{"code":131053,"title":"Media upload error","error_data":{"details":"Downloading media from weblink failed with http code 404"}}]
• Error de OpenAi: Tiempo de espera al descargar https://media.example.com/image.jpg
• Error al transcribir audio.
• Foto no encontrada
• El título de la tarjeta está vacío |

| 22

| Tiempo de espera de conexión y red | Tiempos de espera a nivel de red o fallas de conexión hacia las API de la plataforma, Meta Graph API, Telegram u otros endpoints que no sean de IA. | - error cURL 28: La operación excedió el tiempo de espera después de 15003 milisegundos para https://graph.facebook.com/...

• error cURL 28: Tiempo de espera de conexión SSL para la red de distribución de contenido de Shopify ...
• error cURL 7: No se pudo conectar a Bots: An introduction for developers puerto 443
• error de conexión
• tiempo de espera de la solicitud
• Error de función Js: timeout |

| 23

| Tiempo de espera de conexión con el proveedor de IA | Tiempos de espera a nivel de red o fallas de conexión específicamente hacia los endpoints de API de OpenAI o XAI, separados de los tiempos de espera generales de red para alertas más claras. | - Error de OpenAi: error cURL 28: La operación excedió el tiempo de espera después de 30002 milisegundos para https://api.openai.com/v1/chat/completions

• Error de OpenAi: error cURL 28: Tiempo de espera de conexión SSL para https://api.openai.com/v1/responses
• Error de OpenAi: error cURL 7: No se pudo conectar a api.openai.com puerto 443
• Error de XAi: error cURL 28: La operación excedió el tiempo de espera después de 30002 milisegundos para https://api.x.ai/v1/chat/completions
• Error de OpenAi: Tiempo de espera al descargar https://media.example.com/image.jpg |

| 24

| Flujo y control de ejecución | Errores en la lógica del flujo del bot: tiempo total de ejecución excedido, demasiados pasos sin interacción del usuario, límites de bucle de nodos excedidos o detección de bucles infinitos de llamadas a funciones. | - Se excedió el tiempo máximo de ejecución de 40 segundos.

• Más de 30 pasos sin un paso de interacción.
• Se excedió el límite de ejecuciones para este nodo.
• llamada repetida a función: confirmar_pedido_en_dropi
• Se excedió el límite máximo de puntos de paso de 80. |

| 25

| Error de datos y payload | Errores en el payload de solicitud o mensaje: datos que exceden los límites de tamaño, texto de mensaje vacío, entidades HTML malformadas, versión de API inválida o parámetros requeridos faltantes. | - El tamaño de los datos supera 20000 caracteres para ai_messages, AI Agent Messages

• Solicitud incorrecta: el texto del mensaje está vacío
• Solicitud incorrecta: no se pueden analizar las entidades: etiqueta de cierre sin correspondencia en el desplazamiento de byte 152
• versión inválida en json payload
• acción inválida
• (#131008) Falta un parámetro requerido: falta el valor de texto para un parámetro de tipo text |

| 26

| Error de formato de mensaje de IA | Errores estructurales en el arreglo messages enviado a OpenAI: URL de imágenes colocadas en roles que no son user, o mensajes de assistant con tool_calls sin las respuestas de tool correspondientes. | - Error de OpenAi: 'messages[5]' inválido. Las URL de imagen solo están permitidas para mensajes con el rol 'user', pero este mensaje con el rol 'assistant' contiene una URL de imagen.

• Error de OpenAi: Un mensaje de assistant con 'tool_calls' debe ir seguido por mensajes tool que respondan a cada 'tool_call_id'. Los siguientes tool_call_ids no tuvieron mensajes de respuesta: call_XPe1ktCU |

| 27

| Error de integración de terceros | Errores devueltos por integraciones de terceros como UazAPI (puerta de enlace BSP de WhatsApp) o Shopify, que no coinciden con una categoría de error más específica. | - Error de UazApi: 1

• falló obtener la URL del archivo desde el ID del mensaje. AC6966BC8BF44303C32B54CA329512CC error cURL 28: La operación excedió el tiempo de espera
• error cURL 28: Se agotó el tiempo de conexión para https://store.myshopify.com/admin/api/2023-10/orders/... |

| 28

| Error interno de la plataforma | Errores internos inesperados de la plataforma de chatbot, la API de Meta o proveedores de IA que no encajan en una categoría más específica. | - Error de OpenAi: El servidor tuvo un error mientras procesaba tu solicitud. ¡Lo sentimos!

• (#135000) Error genérico de usuario
• Error de Meta: 2018012 (#-1) Error interno inesperado
• (#131000) Algo salió mal
• Error desconocido
• Error de Meta: (#10903) Este usuario no puede responder a esta actividad |

| 99

| Desconocido / Sin clasificar | La descripción del error no pudo asociarse con ninguna categoría conocida. Se recomienda revisar manualmente la descripción sin procesar. | - error de análisis

• Error de Meta:
• Tipo de mensagem não suportada (file) |

Notas

• EE = 99 indica que el error coincidió con la categoría principal, pero no con un subtipo específico; trátalo como una instancia genérica de esa categoría.

• El código principal 99 (código 9999) significa que el error no pudo asociarse con ninguna categoría y requiere revisión manual.

• Las descripciones de error pueden estar en varios idiomas (inglés, español, portugués, tailandés). La coincidencia de patrones reconoce el idioma para errores multilingües de alta frecuencia.

jsonwide1800