Cuando Zoho CRM devuelve el código de error crm.bm.msg.failed.undefined para mensajes salientes de WhatsApp, la plataforma acepta mensajes entrantes pero no logra entregar los mensajes salientes desde CRM, produciendo un estado de fallo genérico que comenzó a aparecer para algunos clientes el 14 de octubre. Esto detiene el envío de notificaciones y mensajes de WhatsApp activados por CRM, mientras que el chat entrante aún llega [1].
Qué significa — explicación concreta ligada a la superficie de la API de Zoho
El error crm.bm.msg.failed.undefined es un fallo genérico de entrega saliente proveniente de la capa de puente/conector de WhatsApp de CRM (el componente que llama a la API de WhatsApp Business en nombre de CRM). Indica que CRM intentó un envío saliente pero el canal descendente no devolvió ningún código de error mapeado, por lo que CRM registró un estado genérico "failed.undefined" en lugar de un error de API específico. Los clientes informan que los mensajes entrantes aún llegan, lo que demuestra que la integración de WhatsApp y la ruta del webhook entrante permanecen saludables, mientras que la ruta de envío saliente falla en o después de la puerta de enlace de CRM a WhatsApp [1].
Causas comunes
- Un cambio o interrupción en el proveedor de la API de WhatsApp Business o en el puente de CRM que mapea los errores del proveedor a estados de CRM, produciendo fallos indefinidos cuando la respuesta del proveedor cambia [1].
- Configuración incorrecta del canal de WhatsApp en CRM después de una actualización de credenciales, número de teléfono o plantilla, de modo que los envíos salientes son rechazados pero los ganchos entrantes aún funcionan.
- Aprobación de plantilla o discrepancia en el texto de la plantilla para mensajes salientes: WhatsApp rechaza el envío pero devuelve una respuesta no mapeada que CRM registra como indefinida.
- Bloqueos regionales o a nivel de cuenta (verificación comercial, número de teléfono suspendido o aplicación de políticas) que bloquean los envíos salientes pero aún permiten la entrega o recepción de mensajes entrantes.
Cómo solucionarlo
- Verificar el estado de Zoho y los avisos de la comunidad: busque incidentes activos o cambios recientes en la integración de WhatsApp de Zoho CRM (los informes de la comunidad comenzaron el 14 de octubre) [1]. Si hay un incidente activo, espere a que Zoho lo resuelva.
- En Zoho CRM, abra Configuración > Canales > Mensajería > WhatsApp y verifique el estado del conector, el enlace de la cuenta, el número de teléfono y la hora de la última sincronización. Reautentique la cuenta del proveedor de WhatsApp si los tokens han expirado.
- Verificar el estado del proveedor de WhatsApp Business: inicie sesión en su consola de Meta/proveedor externo y confirme que el número está activo, las plantillas están aprobadas y la cuenta está verificada. Vuelva a enviar una plantilla aprobada simple desde la consola del proveedor para aislar CRM vs. proveedor.
- Reproducir con carga mínima: envíe una plantilla aprobada de texto plano desde CRM a un número de prueba y capture los registros de CRM y los registros del proveedor. Anote las marcas de tiempo y cualquier código de error del proveedor para compartirlo con el soporte.
- Si los envíos salientes fallan pero la consola del proveedor tiene éxito, abra un ticket con el Soporte de Zoho con el
request-id/marcas de tiempo, números de destinatario de muestra y registros de respuesta del proveedor. Incluya "crm.bm.msg.failed.undefined" y evidencia de éxito de mensajes entrantes.
Cuándo escalar
Escale al Soporte de Zoho cuando tenga registros que muestren que los mensajes entrantes llegan, pero cada intento de envío saliente devuelve crm.bm.msg.failed.undefined y los registros del proveedor no muestran una razón clara de rechazo. Incluya marcas de tiempo, request-id y capturas de pantalla de la consola del proveedor para que el soporte pueda rastrear la puerta de enlace de CRM a proveedor.
[1]: Informe de la comunidad que describe el funcionamiento de los mensajes entrantes mientras que los salientes fallan con crm.bm.msg.failed.undefined desde el 14 de octubre.