Problemas frecuentes al conectar una bandeja

Diagnosticar fallas de autenticación, recepción, envío, agentes y webhooks sin eliminar prematuramente la bandeja.

Requisitos previos

• Acceso a la configuración de la bandeja.
• Acceso a la cuenta externa o colaboración con quien la administra.

Permisos y disponibilidad

La interfaz utilizada para esta documentación fue observada con un usuario Administrador. Algunas opciones pueden no estar disponibles para agentes o roles personalizados.

Ruta de acceso

Ajustes > Entradas

Procedimiento

1. Identifica si el problema afecta recepción, envío, autenticación, asignación o visibilidad.
2. Revisa el estado de la bandeja y la última modificación.
3. Confirma credenciales y permisos externos.
4. Comprueba webhooks o callbacks.
5. Verifica agentes, asignación automática y disponibilidad.
6. Realiza una prueba controlada.
7. Registra fecha, canal, resultado y mensaje de error antes de escalar.

Campos y opciones

| Elemento | Descripción | |---|---| | Autenticación | Sesión, token o autorización externa. | | Webhook | Recepción de eventos del proveedor. | | Envío | Permisos, SMTP, plantillas o ventana de respuesta. | | Agentes | Acceso y distribución interna. |

Capturas de referencia

Resultado esperado

El problema queda delimitado y se dispone de evidencia suficiente para corregirlo o escalarlo sin perder información.

Consideraciones importantes

• No elimines una bandeja como primera medida.
• No regeneres credenciales sin coordinar el impacto.
• Conserva mensajes de error completos, pero elimina tokens y datos personales antes de compartirlos.

Solución de problemas

| Situación | Qué revisar | |---|---| | No llegan mensajes | Revisa webhook, cuenta o número seleccionado, estado externo y filtros del proveedor. | | No se pueden enviar respuestas | Revisa credenciales, ventana de respuesta, plantillas, SMTP o permisos. | | El canal se desconecta | Reautoriza o renueva credenciales según el proveedor. | | Solo algunos agentes ven la bandeja | Revisa colaboradores, equipos y roles. | | Se crean conversaciones duplicadas | Evalúa la opción de conversación única y la identificación del contacto. |

Artículos relacionados

• Guía para gestionar bandejas de entrada
• Requisitos y limitaciones por tipo de canal
• Configuraciones disponibles después de crear una bandeja
• Problemas frecuentes con WhatsApp Evolution, Uazapi y WAHA