Errore 131060: messaggio non supportato su un numero Coexistence
L'errore 131060 arriva in un webhook dei messaggi come messaggio di tipo unsupported con il titolo «Questo messaggio non è al momento disponibile.». Su un numero Coexistence Meta lo considera previsto: succede soprattutto quando qualcuno scrive all'azienda per la prima volta, spesso subito dopo aver toccato un annuncio Click-to-WhatsApp, e di solito si risolve in pochi secondi. Il messaggio resta leggibile nell'app WhatsApp Business.
easyCoexistence tiene i messaggi non supportati fuori dalle automazioni, così la tua AI non risponde mai a un messaggio che non può leggere, e inoltra comunque il payload originale di Meta al tuo sistema quando è impostato un Forward URL.
Il codice Meta per un messaggio in arrivo al momento non disponibile, con titolo «Questo messaggio non è al momento disponibile.»
Meta afferma che l'errore di solito si risolve in pochi secondi, dopo i quali WhatsApp consegna i messaggi normalmente.
Lo scenario principale indicato da Meta: un utente WhatsApp che scrive all'azienda per la prima volta, frequente subito dopo un tap su un annuncio Click-to-WhatsApp.
Un codice diverso nello stesso webhook: la Cloud API non supporta affatto quel tipo di messaggio.
Le automazioni di easyCoexistence non si attivano su un messaggio non supportato; il messaggio successivo leggibile di quella chat le avvia.
Cosa contiene il webhook 131060?
È un normale webhook dei messaggi il cui messaggio ha "type": "unsupported" e un array errors. L'errore riporta il codice 131060 e il titolo «Questo messaggio non è al momento disponibile.», con la stessa frase come messaggio. Un oggetto unsupported indica il tipo di contenuto che Meta non ha potuto inoltrare; l'elenco dei valori di Meta comprende image, interactive, reaction e poll_creation. Non c'è un corpo testuale né un id del media, quindi nulla nel payload dice cosa abbia scritto il cliente. Il numero del mittente, l'id del messaggio e il timestamp sono presenti come al solito.
{
"object": "whatsapp_business_account",
"entry": [{
"id": "<WABA_ID>",
"changes": [{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_NUMBER>",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
"messages": [{
"from": "5511999998888",
"id": "wamid.HBgN...",
"timestamp": "1762876800",
"type": "unsupported",
"errors": [{
"code": 131060,
"title": "This message is currently unavailable.",
"message": "This message is currently unavailable."
}],
"unsupported": { "type": "<UNSUPPORTED_TYPE>" }
}]
}
}]
}]
}Perché succede su un numero Coexistence?
La guida Coexistence di Meta dice che i partner «possono ricevere un webhook dei messaggi unsupported con codice di errore 131060» e che è previsto. Indica due scenari.
Il primo è un utente WhatsApp che scrive all'azienda per la prima volta, caso che Meta definisce particolarmente frequente quando qualcuno tocca un annuncio Click-to-WhatsApp e invia subito un messaggio. Il secondo è un utente WhatsApp su un dispositivo companion non supportato che invia un messaggio all'azienda o ne riceve uno.
Meta non spiega il meccanismo. Conta di più ciò che afferma: l'errore di solito si risolve in pochi secondi e, dopo, WhatsApp consegna i messaggi normalmente.
Cosa deve fare l'azienda quando ne arriva uno?
Leggerlo nell'app. L'indicazione di Meta alle piattaforme è di dire all'azienda di controllare il messaggio nell'app WhatsApp Business, perché l'app sul telefono lo ha anche quando la copia dell'API non era disponibile.
In pratica: aprire la chat sul telefono, leggere ciò che ha scritto il cliente e rispondere da lì, oppure attendere il messaggio successivo del cliente, che di norma arriva tramite l'API senza errore. Rispondere dal telefono segnala anche alle automazioni che una persona segue la chat. Per una campagna pubblicitaria, aspettati una piccola raffica di questi eventi all'inizio delle nuove conversazioni, non un guasto.
Come devono reagire il software e l'AI?
Trattalo come un evento noto, non come un errore. Conferma il webhook con un 200, come per qualsiasi consegna, così Meta non lo rispedisce. Registra l'id del messaggio e il mittente, così puoi collegarlo alla conversazione che segue. Non passare mai il messaggio vuoto a un'AI come se fosse testo: senza contenuto, qualsiasi risposta è una supposizione. E segnala l'allarme sulla frequenza degli eventi 131060, non sui singoli.
- Rispondi 200 rapidamente e deduplica sull'id del messaggio, come per ogni webhook.
- Salta le risposte AI e il riconoscimento per parole chiave per type unsupported.
- Mostra al team che un messaggio è in attesa nell'app sul telefono.
- Conta i 131060 separatamente dai veri guasti nelle dashboard.
Le automazioni girano su un messaggio unsupported?
Su easyCoexistence, no. Le automazioni leggono risposte testuali, dei pulsanti e delle liste, didascalie dei media e segnaposto come «[messaggio vocale]»; un messaggio di tipo unsupported non ha nessuno di questi, quindi nessuna automazione risponde e non compare alcuna esecuzione. Se è impostato un Forward URL, il tuo sistema riceve comunque il payload originale di Meta, errore incluso. In modalità diretta, Meta lo invia direttamente al tuo server.
Il messaggio leggibile successivo di quella persona avvia le automazioni come sempre. Poiché per quella chat non era ancora stato salvato nulla, un'automazione «Primo messaggio», come una risposta di benvenuto, risponde a quel messaggio successivo.
In cosa 131060 si distingue da 131051?
Entrambi arrivano come tipo unsupported nello stesso webhook dei messaggi, per questo nei log si confondono. Per la pianificazione significano cose opposte: uno è una breve pausa che si risolve da sola, l'altro è un limite permanente dell'API per quel contenuto. Per distinguerli nel tuo gestore leggi errors[0].code, non il tipo. La tabella riassume ciò che i riferimenti di Meta dicono su ciascun codice.
| 131060 | 131051 | |
|---|---|---|
| Title | This message is currently unavailable. | Message type unknown |
| Meaning | The message cannot be passed on right now | The Cloud API does not support that type |
| Typical cause | First contact on a Coexistence number, often after an ad tap | Content the API never delivers |
| How long | Usually clears within seconds | Permanent for that content |
| What to do | Read it in the WhatsApp Business app | Ask the customer for text, or read it in the app |
Errori comuni
- Far scattare avvisi su singoli eventi 131060. Meta li considera previsti sui numeri Coexistence; controlla la frequenza.
- Far rispondere un'AI al messaggio vuoto. Il payload non ha testo, quindi la risposta sarebbe inventata.
- Rispondere al webhook con uno stato di errore. Meta rispedisce i webhook falliti, quindi un solo messaggio non supportato diventa più consegne.
- Supporre che il messaggio sia perso. È nell'app WhatsApp Business; era indisponibile solo la copia dell'API.
Il numero resta nell'app sul telefono, dove si può leggere il messaggio originale. Da US$ 9 fino a US$ 0,75 per numero al mese, con il prezzo che scende man mano che aggiungi numeri, e 3 giorni di prova gratuita.
Domande frequenti
Posso recuperare il contenuto originale tramite l'API?
La guida di Meta per il 131060 è di controllare l'app WhatsApp Business. Il suo riferimento sui webhook non descrive un modo per recuperare il contenuto in seguito.
Il 131060 significa che il numero è rotto?
No. Se i messaggi di contatti abituali continuano ad arrivare come 131060 per ore, chiedi alla tua AI di eseguire get_number_health o di controllare la connessione, ma le raffiche al primo contatto sono previste.
Succede anche sui numeri che usano solo la Cloud API?
Meta descrive lo schema del primo contatto nella sua guida per i numeri collegati con l'app WhatsApp Business, che è ciò che è Coexistence. Il codice stesso è nel riferimento generale dei webhook di Meta, quindi gestiscilo allo stesso modo su qualsiasi numero.
Viene addebitato qualcosa?
È un messaggio in arrivo. Meta addebita all'azienda i messaggi che invia, per messaggio, per categoria e per paese, sul proprio WhatsApp Business Account.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il