¿Los mensajes de WhatsApp no aparecen en las Líneas abiertas de Bitrix24? Sigue esta lista de verificación

Ayer pasamos una mañana entera con un mensaje que "no llegó". Sí había llegado — estaba en el widget del CRM, a plena vista. Simplemente nunca apareció en las Líneas abiertas de Bitrix24, y la razón resultó vergonzosamente simple una vez que la encontramos.

De esa mañana salió un runbook interno. Esta es la versión pública: siete causas reales por las que los mensajes de WhatsApp faltan en las Líneas abiertas, en el orden en que ahora las revisamos en producción.

Entiende esto primero: hay dos canales, no uno

La mayoría de las integraciones WhatsApp–Bitrix24 muestran los mensajes en dos lugares separados:

1. El widget del CRM — el panel de chat de WhatsApp incrustado en un lead o una negociación. Este lee del almacén de mensajes propio de la integración.
2. Las Líneas abiertas (Canales abiertos) — la cola de mensajería nativa de Bitrix24, con distribución entre operadores, creación automática de contactos en el CRM y la bandeja del Centro de contacto. Los mensajes solo llegan aquí si la integración los reenvía a través de un conector vinculado a una Línea abierta específica.

Estos canales fallan de forma independiente. Un mensaje puede estar entregado, almacenado y visible en el widget mientras las Líneas abiertas permanecen en silencio absoluto — que es exactamente el estado desconcertante que estuvimos depurando. Si tu widget muestra los mensajes, el lado WhatsApp de tu integración funciona; el problema vive en el paso de reenvío o en el vínculo con la Línea abierta. Eso acota la búsqueda enormemente.

La lista de verificación

1. ¿Hay realmente una Línea abierta vinculada a este número?

La causa #1, y la que nos atrapó a nosotros. Cada conexión de WhatsApp necesita un vínculo explícito con una Línea abierta — y dependiendo de cómo se creó la conexión, puede que ese vínculo nunca se haya establecido. La parte fea: algunas interfaces de administración muestran un nombre de línea de relleno aunque no haya nada vinculado, así que puede parecer conectado estando conectado a nada.

Compruébalo desde ambos extremos: la configuración de tu integración debería nombrar la Línea abierta exacta que alimenta cada número, y esa línea debe existir en Bitrix24 → Centro de contacto. Si no puedes decir qué línea alimenta un número, asume que ninguna.

2. ¿El conector está activo en esa línea?

Una línea puede existir y estar vinculada, pero el conector en ella puede estar inactivo — normalmente después de editar o recrear la línea. En el Centro de contacto, abre la línea y confirma que tu conector de WhatsApp aparece listado y habilitado. Las buenas integraciones lo reactivan automáticamente con el primer mensaje; las configuraciones más antiguas pueden necesitar un toggle manual.

3. ¿La Línea abierta fue eliminada o archivada?

Las líneas son "ordenadas" por administradores bienintencionados con más frecuencia de la que imaginas. Si la línea vinculada ya no existe, los mensajes no tienen dónde aterrizar — y la mayoría de las integraciones fallan en silencio en lugar de romperse a la vista. Vuelve a vincular a una línea viva.

4. ¿La suscripción al webhook sigue intacta?

Todo lo que pasa entre WhatsApp y Bitrix24 empieza con un webhook. En números de la API oficial (Cloud API), tu aplicación debe estar suscrita a la cuenta de WhatsApp Business — una suscripción que puede perderse tras cambios de token, eventos de revisión de la app o migraciones de número. Síntoma: no llega nada a ningún lado, widget incluido. Si los dos canales están muertos, mira aquí primero, no en Bitrix.

5. ¿El remitente está bloqueado? (La causa silenciosa)

Un contacto bloqueado en la WhatsApp Business API no produce ningún webhook. Sin error, sin línea de log — silencio. Si exactamente un cliente "dejó de escribir" mientras todos los demás fluyen con normalidad, revisa la lista de bloqueo antes de tocar cualquier configuración. Alguien de tu equipo pudo haberlo bloqueado hace meses. Escribimos aparte sobre las reglas de bloqueo y sus sorpresas.

6. ¿El mensaje está atrapado en una cola sin asignar?

A veces el mensaje sí está en las Líneas abiertas — solo que no donde estás mirando. Si la cola de la línea no tiene operadores disponibles, o enruta a un departamento que nadie revisa, las conversaciones se acumulan sin asignar. Abre la configuración de la cola de la línea y revisa quién se supone que recibe los diálogos nuevos, y si se saltan los operadores "desconectados".

7. En números de la API: ¿estás dentro de las reglas de mensajería?

Los números de la API oficial vienen con las reglas de conversación de Meta: los clientes siempre pueden escribirte, pero si tus mensajes salientes de repente fallan — o una automatización dejó de responder — revisa la ventana de atención al cliente de 24 horas y el estado de calidad de tus plantillas en WhatsApp Manager. Los problemas de entrada rara vez vienen de aquí; los de salida, casi siempre.

Cómo fue realmente nuestra sesión de depuración

Para los curiosos — la secuencia real de nuestro incidente: mensaje visible en el widget (así que la entrada funcionaba), nada en las Líneas abiertas (así que el reenvío no), una interfaz mostrando un nombre de línea que resultó ser de relleno (la causa #1 disfrazada), y un desvío por la lista de bloqueo (causa #5) provocado por una prueba de bloqueo anterior con el mismo número. Tiempo total: una mañana. Con esta lista: unos diez minutos.

De ahí salieron dos cambios. WASync ahora crea y vincula una Línea abierta automáticamente en el momento en que se conecta un número de la WhatsApp Business API — así la causa #1 no puede pasarle a las conexiones nuevas — y el conector se autoactiva con el primer mensaje, cubriendo la causa #2.

El triaje de cinco minutos

---

¿Configurando desde cero en lugar de depurando? Nuestra guía paso a paso para conectar WhatsApp a Bitrix24 cubre tanto la vía QR como la API oficial — con el cableado de la Línea abierta ya resuelto.