Lede: Quando Zoho CRM restituisce il codice di errore crm.bm.msg.failed.undefined per i messaggi in uscita di WhatsApp, la piattaforma accetta i messaggi in entrata ma non riesce a consegnare i messaggi in uscita dal CRM, producendo uno stato di fallimento generico che ha iniziato ad apparire per alcuni clienti il 14 ottobre. Questo impedisce l'invio di notifiche e messaggi WhatsApp attivati dal CRM, mentre la chat in entrata continua ad arrivare [1].
Cosa significa — spiegazione concreta legata alla superficie API di Zoho
L'errore crm.bm.msg.failed.undefined è un fallimento generico della consegna in uscita proveniente dallo strato di bridge/connettore WhatsApp del CRM (il componente che chiama l'API di WhatsApp Business per conto del CRM). Indica che il CRM ha tentato un invio in uscita ma il canale downstream non ha restituito alcun codice di errore mappato, quindi il CRM ha registrato uno stato generico "failed.undefined" invece di un errore API specifico. I clienti segnalano che i messaggi in entrata continuano ad arrivare, il che dimostra che l'integrazione WhatsApp e il percorso webhook in entrata rimangono integri mentre il percorso di invio in uscita fallisce a livello del gateway CRM-WhatsApp o dopo di esso [1].
Cause comuni
- Una modifica o un'interruzione nel provider dell'API di WhatsApp Business o nel bridge del CRM che mappa gli errori del provider in stati del CRM, producendo fallimenti indefiniti quando la risposta del provider cambia [1].
- Errata configurazione del canale WhatsApp nel CRM dopo un aggiornamento di credenziali, numero di telefono o modello, in modo che gli invii in uscita vengano rifiutati ma i webhook in entrata funzionino ancora.
- Approvazione del modello o mancata corrispondenza del testo del modello per i messaggi in uscita: WhatsApp rifiuta l'invio ma restituisce una risposta non mappata che il CRM registra come indefinita.
- Blocchi regionali o a livello di account (verifica aziendale, numero di telefono sospeso o applicazione delle policy) che bloccano l'invio in uscita ma consentono ancora la consegna o le ricevute in entrata.
Come risolvere
- Controlla lo stato di Zoho e gli avvisi della community: cerca incidenti attivi o modifiche recenti nell'integrazione WhatsApp di Zoho CRM (i report della community sono iniziati il 14 ottobre) [1]. Se c'è un incidente attivo, attendi che Zoho lo risolva.
- In Zoho CRM, apri Configurazione > Canali > Messaggistica > WhatsApp e verifica lo stato del connettore, il collegamento dell'account, il numero di telefono e l'ora dell'ultima sincronizzazione. Ri-autentica l'account del provider WhatsApp se i token sono scaduti.
- Verifica lo stato del provider WhatsApp Business: accedi alla tua console Meta/provider di terze parti e conferma che il numero sia attivo, i modelli siano approvati e l'account sia verificato. Invia nuovamente un semplice modello approvato dalla console del provider per isolare il CRM rispetto al provider.
- Riproduci con payload minimo: invia un modello approvato di testo semplice dal CRM a un numero di test e acquisisci i log del CRM e i log del provider. Annota i timestamp e gli eventuali codici di errore del provider da condividere con il supporto.
- Se l'invio in uscita fallisce ma la console del provider ha successo, apri un ticket con il Supporto Zoho con request-id/timestamp, numeri di destinatari di esempio e log della risposta del provider. Includi "crm.bm.msg.failed.undefined" e la prova del successo in entrata.
Quando escalare
Escala al Supporto Zoho quando hai log che mostrano l'arrivo di messaggi in entrata, ma ogni tentativo di invio in uscita restituisce crm.bm.msg.failed.undefined e i log del provider non mostrano un chiaro motivo di rifiuto. Includi timestamp, request ID e screenshot della console del provider in modo che il supporto possa tracciare il gateway CRM-provider.
[1]: Report della community che descrive il funzionamento in entrata mentre l'invio in uscita fallisce con crm.bm.msg.failed.undefined dal 14 ottobre.