Errores globales
Error: "Sequence failed, Bot user unsubscribed"
Este error se activa cada vez que el bot intenta enviar una secuencia a un usuario del bot que se ha dado de baja del bot.
El usuario necesita volver a suscribirse para poder recibir las secuencias.
Una vez que el usuario del bot vuelva a estar suscrito, puedes usar la acción en basic action, subscribe to sequence para volver a suscribir al usuario, como se muestra en la captura de pantalla a continuación:
O ve a "bot users", selecciona los contactos y luego, en el menú desplegable "bulk action", selecciona "subscribe to sequence"
Error: "Data size is over 20000 characters"
Para el campo personalizado del usuario, el límite máximo de almacenamiento es de 20000 caracteres. Para resolver el problema, reduce la cantidad de caracteres que intentas guardar.
Si estás guardando el valor desde webhooks entrantes o nuestras acciones de integración internas, usa el preprocesamiento de datos para limitar el valor que deseas guardar.
Puedes encontrar el preprocesamiento de datos en la configuración del webhook entrante a continuación:
También puedes encontrar el preprocesamiento de datos en la solicitud externa, como se muestra en la captura de pantalla a continuación:
Ten en cuenta que es posible que necesites conocimientos de desarrollo para usar la función de preprocesamiento de datos mencionada arriba.
Error: "Operation timed out after 30001 milliseconds with 0 bytes received"
Este error normalmente se activa por una acción de integración de OpenAI. El tiempo de espera predeterminado para OpenAI de forma nativa es de 30 segundos, después de lo cual los servidores de OneChat agotan el tiempo de espera. Si el servidor agota el tiempo antes de recibir una respuesta de OpenAI, se registra este error.
Para reducir la probabilidad de que ocurra este error, reduce el historial del chat u optimiza los prompts y mensajes del sistema para que la solicitud tarde menos en ejecutarse. También puedes dividir un historial de chat más grande en fragmentos más pequeños y usar un sistema de detección de intención como solución alternativa. Para más información, consulta el video:
TODO_VIDEO[49c094b403]: reemplazar este video con un recurso oficial de OneChat.
OneChat también ofrece un add-on para aumentar los límites de tiempo de espera; el costo es de $20 por mes para aumentar 10 segundos adicionales. Puedes acumular este add-on. Puedes encontrar más información aquí:
Error: "Data Store Error: Connection is not verified"
Este error normalmente ocurre cuando intentas integrar tu base de datos con OneChat. La conexión se establece, pero OneChat no puede verificarla. En la mayoría de los casos, la razón es que las credenciales son incorrectas. También hay casos en los que la IP no está en la lista blanca y, por lo tanto, la conexión no puede establecerse.
Ingresa las credenciales correctas y la conexión será verificada. Si estás integrando MongoDB, puedes usar el siguiente video como referencia:
TODO_VIDEO[e320b5a3ea]: reemplazar este video con un recurso oficial de OneChat.
Error: "Notification Content must not be empty"
Este error se activa cada vez que intentas enviar una notificación y el cuerpo/contenido de la notificación está vacío.
Para resolverlo, asegúrate de que el cuerpo de la notificación no esté en blanco. Si el cuerpo consiste en un campo personalizado, revisa el usuario del bot para confirmar que ese campo personalizado se haya completado correctamente.
Error: "Broadcast failed, Bot user unsubscribed"
Este error se debe a que el usuario se dio de baja de tu bot al momento de enviar el broadcast.
Si no quieres ver este error, puedes agregar condiciones en tu flujo de broadcast para enviar el broadcast solo a los usuarios suscritos a tu bot.
También puedes optar por eliminar a los usuarios dados de baja para conservar solo a los usuarios comprometidos en tu chatbot.
Puedes crear los triggers en la automatización: User Unsubscribed from Bot, y activar un flujo con la acción "delete user" dentro.
Nuestra plataforma también tiene una función de limpieza automática; puedes encontrar la configuración en "Settings" -> General -> Bot Users Auto Cleanup (solo el propietario puede ver esta configuración).
También puedes consultar el video tutorial aquí:
TODO_VIDEO[1b4f224a43]: reemplazar este video con un recurso oficial de OneChat.
Error: "Open AI not connected"
Este error se activa cuando intentas usar una acción de OpenAI, pero el workspace aún no está integrado con OpenAI.
Para integrar OpenAI, haz clic en "Integration" desde el panel de tu workspace, busca OpenAI en la pestaña Artificial Intelligence e ingresa tu OpenAI API Key.
Haz clic en Save y asegúrate de que la conexión diga "Verified"
Nota: El Organization ID es opcional; puedes dejarlo vacío.
Puedes consultar el siguiente video para obtener más orientación:
TODO_VIDEO[5f7c3a6507]: reemplazar este video con un recurso oficial de OneChat.
Error: "SpreadSheet is not selected"
Este error se activa cuando intentas usar una acción de Google Sheets y no se ha seleccionado la hoja de cálculo.
También puede haber varias otras razones. Esto puede ocurrir si instalaste una plantilla y la hoja de Google no fue copiada a tu propia cuenta.
Esto también puede ocurrir si tu workspace aún no tiene integrada Google Sheets y, por lo tanto, la instalación de la plantilla no pudo instalar una copia de la hoja de Google utilizada en tu cuenta.
Asegúrate de conectar tu cuenta de Google en Integration -> Data/File Storage, y también de seleccionar la hoja de cálculo correcta en la acción de Google sheet.
Error: "Pro feature only"
Este error se activa cuando intentas usar una acción que solo está disponible para usuarios con el plan Pro. Para poder usar estas acciones, tendrás que actualizar tu workspace del plan gratuito al plan business o partner.
Error: "Request timeout"
Este error se activa cuando estás usando la acción External Request y la llamada a la API externa no devuelve una respuesta dentro de 15 segundos.
Los servidores de OneChat agotan el tiempo de espera después de 15 segundos. La solución es asegurarte de que la llamada a la API se complete dentro de 15 segundos. Si deseas aumentar este límite, puedes hacerlo comprando un add-on aquí:
Nota: Puedes manejar este error dentro de tu flujo usando el código de respuesta "0"
Si no puedes optimizar el tiempo de espera, puedes optar por comprar el add-on de timeout. Puedes aumentar los límites de tiempo de espera en 10 segundos por $20 cada uno.
Puedes hacer pruebas con Postman para verificar cuánto tarda tu servidor en generar una respuesta; si puedes usar un servidor/IP de Australia para probar, sería más preciso. Puedes comprar la ampliación del timeout aquí:
https://buy.stripe.com/9AQbJR2qveTC4N2fZf
Ten en cuenta que son $20 por mes por cada 10 segundos adicionales. El add-on es a nivel de bot. Por ejemplo, si deseas aumentar el límite en 30 segundos, cambia la cantidad a 3 en el enlace de pago anterior y costará $60 por mes.
Error: "Message not sent because not subscribed"
Este error se activa cada vez que el bot intenta enviar un mensaje a un usuario del bot que ya no está suscrito al bot.
Puedes usar la acción "opt-in" en Flow Builder, actions → basic actions. También puedes volver a suscribir a los usuarios del bot usando la acción "Subscribe to bot" → basic actions.
Error: "Over 100 sequences subscribed in last 24 hours"
La plataforma tiene un límite de tasa de máximo 100 suscripciones a secuencias. Si te has suscrito a la secuencia más de 100 veces, recibirás este error.
Necesitarás optimizar tu acción "subscribe to sequence" en tu flujo.
Esto normalmente sucede cuando el usuario está probando flujos o hay un loop infinito en algún punto del diseño del flujo. Normalmente, el límite es suficiente para las automatizaciones del chatbot. Debes revisar la lógica de tu flujo para corregir el problema.
Error: "Google Sheet is not connected"
Este error se activa cuando intentas usar una acción de Google Sheets y no está integrada con tu workspace.
Para integrar Google Sheets, sigue el siguiente video:
TODO_VIDEO[044b875a83]: reemplazar este video con un recurso oficial de OneChat.
Asegúrate de otorgar todos los permisos solicitados cuando conectes tu cuenta de Google Sheets.
Error: "Bot users in workspace is over limit"
Este error significa que has alcanzado los límites de tu plan para usuarios. Por lo tanto, las automatizaciones no continuarán.
Necesitarás eliminar usuarios del bot manualmente o configurar reglas de eliminación automática en el Channel, luego ir a settings, después a "General", y luego configurar "bot user limits" y "Bot users auto cleanup".
Ten en cuenta que la configuración de límites y limpieza de usuarios del bot solo está disponible para el propietario del workspace. Consulta el siguiente video:
TODO_VIDEO[a3956c270c]: reemplazar este video con un recurso oficial de OneChat.
También puedes actualizar a un plan superior que tenga límites más altos de usuarios del bot.
Error: "The rate limit has exceeded, Please retry again after some time"
Este error normalmente se activa cuando se está enviando un broadcast o tienes un tráfico en vivo muy alto en conversaciones y se alcanzan 100 errores por 5 minutos para tu bot.
El broadcast se pausará temporalmente.
OneChat seguirá contando los mensajes de error cada 5 minutos. Si tienes menos errores que nuestros límites, tu broadcast o tu bot se reanudarán.
Para resolver este error, debes asegurarte de optimizar tu flujo para manejar los errores.
Puedes abrir tu bot e ir a "Tools" -> Error logs, y luego, si haces clic en "Node" en tus registros de errores, te redirigirá a los flujos, donde podrás revisar y optimizar tu flujo.
Nota: Si estás usando la función de límites de tasa, este error también se registrará si excedes esos límites.
Error: "Over max execution time limit of 40 seconds"
Este error se activa cada vez que no hay interacción del usuario durante 40 segundos.
De forma predeterminada, OneChat ofrece un tiempo máximo de ejecución de 40 segundos. Entonces, si se activa un question node (que cuenta como interacción del usuario), a partir de ese punto OneChat avanzará con la lógica de tu flujo por un máximo de 40 segundos. Necesitarás tener otra interacción del usuario (question block) dentro de esos 40 segundos; de lo contrario, verás este error.
Algunos ejemplos de acciones de interacción del usuario:
- Question node - hacer preguntas
- Clic en botones o respuestas rápidas
- El usuario responde a tu bot
Ten en cuenta que, si estás usando una acción External Request o una acción de OpenAI, el tiempo de respuesta del tercero también se considera dentro de los límites de timeout.
La solución es agregar más interacción del usuario en el flujo de tu chatbot. Cada interacción del usuario restablecerá el tiempo máximo de ejecución.
Además, puedes optar por comprar el add-on de timeout máximo de ejecución. Puedes aumentar el límite en 10 segundos por $20/mes cada uno.
Por ejemplo, si deseas aumentar el límite en 30 segundos, cambia la cantidad a 3 y costará $60/mes.
Puedes comprar la ampliación del timeout aquí:
https://buy.stripe.com/9AQbJR2qveTC4N2fZf
Ten en cuenta que el add-on es a nivel de bot. Contacta al soporte de OneChat una vez realizado el pago; por favor, especifica claramente el ID del workspace y el nombre del bot en tu correo.
Error: "Over 30 steps without interaction step"
En los diseños de flujo de OneChat, cada nodo se considera un paso.
No importa cuántas acciones estés usando en ese nodo, pero entre una interacción del usuario y la siguiente no puedes tener más de 30 pasos. Esto incluirá los flujos en segundo plano o paralelos que se activen.
Algunos ejemplos de acciones de interacción del usuario:
- Question node - hacer preguntas
- Clic en botones o respuestas rápidas
- El usuario responde a tu bot
Para resolver este error, intenta optimizar la lógica de tu flujo (por ejemplo, dividir automatizaciones grandes en flujos pequeños) y evita loops infinitos.
Error: "Card title is empty"
Si estás usando "card element" en el bloque de envío de mensaje, debes asegurarte de que el título de la tarjeta tenga un valor.
Si estás usando una variable de campo personalizado del usuario en el título de la tarjeta, debes asegurarte de que la variable tenga valor. Puedes verificarlo revisando el resumen del usuario del bot y seleccionando el usuario del bot para el que se activó el error. Asegúrate de que el campo personalizado usado para el título de la tarjeta tenga algún valor. Si no es así, significa que hay un problema en los pasos anteriores a este nodo y deberás solucionarlo en algún punto.
De lo contrario, verás el error. Si estás usando un campo personalizado del usuario en el título de la tarjeta, puedes usar una verificación de condición antes de enviar la tarjeta y notificar al administrador si ocurre un problema como este.
Error: "Purchased add-on, delete the bot, What to do next?"
Así es como funciona nuestra facturación. Imagina que compraste un add-on de bot extra, que cuesta $10 por mes. La factura se genera de inmediato.
Y lo has estado usando durante 15 días, por ejemplo, y luego decides que ya no necesitas este bot y lo eliminas.
Entonces, lo que sucede es:
- Como usaste 15 días para este bot, el costo sería $15/30 = $0.5 por día, así que por 15 días serían $7.5
- Entonces, una vez que eliminas el bot, esos $7.5 se reembolsarán a tu cuenta de Stripe. Ten en cuenta que será a tu cuenta de Stripe, no a la tarjeta con la que pagaste.
Entonces, si todavía estás usando el servicio de OneChat, estos créditos se usarán para cubrir tu pago mensual. Supongamos que tu próximo pago mensual es de $15 por mes.
Como todavía tienes $7.5 de crédito con nosotros, solo te cobraremos la diferencia. Es decir, te cobraremos $7.5 para el pago de este mes.
Además, si decides agregar otro miembro, lo cual costará $10 por mes, solo te cobraremos $2.5 por este add-on.
Así que el crédito disponible se usará para cubrir el costo de tu add-on o de tu suscripción mensual.
Lamentablemente, no podrás ver el crédito en el panel de OneChat.
Si deseas que reembolsemos a tu tarjeta, también podemos hacerlo. Ten en cuenta que se cobrará una comisión de transacción del 10% por el reembolso.
Error: "Over 100 smart delay used in last 24 hour"
Se puede activar un máximo de 100 acciones de smart delay por cada usuario del bot. Inspecciona y modifica el nodo que causa el problema para evitar un loop infinito que active acciones de smart delay, asegurando el cumplimiento del límite de 100 acciones por usuario del bot dentro de 24 horas.
Posibles causas:
El error ocurre cuando el usuario del bot ha recibido el máximo permitido de 100 acciones de smart delay dentro de 24 horas, potencialmente debido a un loop infinito activado dentro de tu flujo.
Posibles soluciones:
Para abordar este problema, inspecciona el nodo específico en tu flujo que está causando el error y asegúrate de no haber configurado una automatización con loop infinito.
Modifica la lógica de la automatización para evitar la activación continua de acciones de smart delay y asegurar que no se supere el límite de 100 acciones. Esto implica ajustar el flujo para evitar loops repetitivos o infinitos que puedan llevar a exceder el límite de acciones de smart delay.
Estos errores se observan principalmente en canales como WhatsApp, donde la función de escritura no está presente. Actualizamos nuestro bloque de escritura para que se convierta automáticamente en una espera si el canal en cuestión no admite escritura. De esta forma, ya no tienes que usar smart delay y podría resolverse el problema.
Error: "Upload failed. You have reached the limit of storage size(1GB). Connect to your S3 storage to continue upload"
Permitimos 1 GB de almacenamiento gratuito para archivos subidos. Si necesitas almacenamiento adicional, puedes crear una cuenta gratuita de cloudinary o S3 para almacenarlos.
TODO_VIDEO[15dc2d7043]: reemplazar este video con un recurso oficial de OneChat.
También puedes administrar tu biblioteca de medios y contenido entrando al panel de tu workspace y haciendo clic en la pestaña My Contents.
Error: "PostgreSQL Integration - Table isn't synced"
Antes que nada, solo se admiten tablas con clave primaria id autoincremental.
Además, una vez que la tabla se sincroniza con OneChat, no eliminamos la tabla sincronizada aunque se elimine en tu base de datos PostgreSQL.
Esto se debe a que aún podrías usarla en tu acción de datastore del chatbot. Puedes eliminar manualmente la tabla desde el lado de OneChat.
Ten en cuenta que, una vez que la tabla se elimine del lado de OneChat, incluso si vuelves a sincronizar la misma tabla con OneChat, el ID del datastore aún podría cambiar.
Error: "Please contact support(#10102)"
El mensaje de error "Please contact support(#10102)" ocurre exclusivamente para partners de OneChat cuando intentan comprar un plan, debido a que no hay crédito de partner suficiente para cubrir el costo del plan.
Posible motivo del error:
La aparición de este error está vinculada a la insuficiencia del crédito de partner disponible en el momento en que tu cliente intenta comprar un plan.
Como partner de OneChat, cuando el saldo de crédito es insuficiente, aparece este error, impidiendo el proceso de compra del plan.
Posible solución del error:
Para resolver este problema, la acción sugerida es recargar el crédito de partner.
Al recargar el crédito de partner, habrá fondos suficientes para cubrir el costo del workspace. Esta acción facilitará un proceso de compra sin inconvenientes para tus clientes, permitiéndoles actualizar y comprar el plan deseado sin encontrarse con este error.
Error: "Please contact support(#10105)"
El mensaje de error "Please contact support(#10105)" ocurre exclusivamente para partners de OneChat cuando intentan comprar un plan, debido a que no hay un Stripe Price vinculado a =Internal Billing=.
Posible motivo del error:
La aparición de este error está relacionada con la configuración de Stripe billing del plan en el momento en que tu cliente intenta comprar un plan.
Para aceptar la facturación de Stripe, el partner necesita vincular el Stripe price a =Internal Billing=.
Posible solución del error:
Para resolver este problema, la acción sugerida es revisar la pestaña Stripe Billing en Partner Settings → Plan and Features → Plan → Stripe Billing.
Error: "This team has too many team members for the selected plan"
El error "This team has too many team members for the selected plan" ocurre al intentar actualizar el plan e indica que hay un exceso de bots o miembros en el plan actual.
La solución consiste en eliminar bots o miembros sobrantes para ajustarse a los límites del plan actual antes de actualizar.
Posible motivo del error:
Es probable que el error surja debido a la limitación del plan actual en cuanto al número de miembros del equipo o bots, superando la cantidad permitida para la actualización deseada. Para resolver esto, es necesario eliminar miembros o bots adicionales para ajustarse a las restricciones del plan seleccionado.
Posible solución:
Para resolver el problema, antes de actualizar el plan, asegúrate de que la cantidad de miembros del equipo o bots respete los límites establecidos por el plan deseado.
Esto implica eliminar miembros excedentes a través de la configuración del workspace y eliminar bots sobrantes navegando a "All bots", seleccionando el bot específico que deseas eliminar y eligiendo la opción de eliminación del menú desplegable.
Una vez que se hayan eliminado los miembros o bots sobrantes, procede con la actualización del plan y, posteriormente, vuelve a agregar los miembros o bots necesarios según corresponda.
O puedes actualizar a un plan superior que tenga más límites que tu plan actual.
Error: "Inbound webhook request limits"
De forma predeterminada, el límite del webhook entrante es de 500 solicitudes dentro de 24 horas; si se envían más solicitudes a la URL del webhook entrante, serán ignoradas.
Si deseas verificar los límites del webhook entrante, simplemente usa una External Request para activar la URL del webhook entrante y revisa el encabezado de la respuesta; allí encontrarás los límites y cuántas solicitudes quedan.
Consulta los siguientes videos para más detalles:
TODO_VIDEO[ec1870588f]: reemplazar este video con un recurso oficial de OneChat.
Aumentar los límites del webhook entrante
Si el usuario necesita capacidad adicional de inbound webhook, puede comprarla según la siguiente información:
| Límite | Precio | Solicitudes por mes |
|---|---:|---:|
| 500/día | Incluido | 15K solicitudes/mes |
| 1000/día | $20 por mes | 30K solicitudes/mes |
| 2000/día | $40 por mes | 60K solicitudes/mes |
| 3000/día | $60 por mes | 90K solicitudes/mes |
| 4000/día | $80 por mes | 120K solicitudes/mes |
| 5000/día | $100 por mes | 150K solicitudes/mes |
| 10000/día | $200 por mes | 300K solicitudes/mes |
Enlace de pago:
https://buy.stripe.com/00g9BJ6GLcLugvKbIV
Puedes seleccionar cuántos add-ons deseas comprar, y cada unidad significa 1000 solicitudes por día, con un costo de $20 por mes.
El límite de inbound webhook está diseñado a nivel de bot, no a nivel de workspace. Deberás proporcionar el flowNS o el workspaceID y el nombre del bot.
Cuando se haya realizado el pago, envía al soporte el nombre del bot y el ID del workspace o el correo electrónico. Procesaremos tu solicitud dentro de 1 día hábil.
Error: "Import contact show strange character - For example Hebrew language"
Puedes enfrentarte a este problema si estás importando contactos a la sección de usuarios del bot y el valor aparece con caracteres especiales. Esto suele suceder con idiomas RTL, como hebreo o árabe. Se debe a que el sistema de codificación no es totalmente compatible con idiomas RTL.
Primero tendrás que convertir los archivos de importación a codificación UTF-8.
La solución es la siguiente:
1. Abre un archivo de Excel donde tengas la información (.xls, .xlsx)
2. En Excel, elige "CSV (Comma Delimited) (*.csv)" como tipo de archivo y guárdalo con ese formato.
3. En NOTEPAD, abre el archivo .csv guardado.
4. Luego elige -> Save As... y, en la parte inferior del cuadro "save as", hay un selector etiquetado como "Encoding". Selecciona UTF-8 (NO uses ANSI o perderás todos los acentos, etc.). Después de seleccionar UTF-8, elige cualquier tipo en "Save as type" y luego guarda el archivo con un nombre ligeramente distinto al original.
Nota importante: el título no puede guardarse en hebreo, ya que esto generará un error al importar. Así que guarda el título en formato inglés.
Error: "Comment reply error. We've limited the number of times you can post, comment, or do anything else to prevent spam. You can try again later"
Este problema ocurre si tienes mucho tráfico de comentarios en una publicación de tu página de Facebook y el chatbot está respondiendo activamente a cada comentario. Para evitar que Meta marque tu página, se implementó un límite de tasa para prevenirlo.
Para resolver este problema, puedes hacer una de las siguientes dos opciones:
OPCIÓN 1:
- Si respondes directamente con respuestas estáticas desde el trigger de palabra clave de comentario, puedes usar nuestra solución integrada para retrasar las respuestas del chatbot con intervalos aleatorios.
A la derecha tendrás la opción de configurar un retraso aleatorio. Recomendamos que, cuanto mayor sea el tráfico, mayor sea el intervalo aleatorio de respuesta. Tienes opciones desde varios minutos hasta una hora.
OPCIÓN 2:
- Si usas un flujo para responder al comentario del usuario, considera configurar un nodo split con varias secuencias conectadas.
Así podría verse un flujo
Comienzas el flujo con un nodo split y luego conectas cada variante a su propio nodo de acción con un add to sequence diferente.
Cada secuencia apuntará básicamente al mismo flujo exacto donde tienes configurada la acción de respuesta al comentario, pero en la propia secuencia puedes determinar cuánto tiempo esperar antes de que se active el flujo.
De esta manera tienes más flexibilidad y evitas publicar instantáneamente.