Stiamo disattivando l'API On-Premises. Consulta il nostro documento Disattivazione API On-Premises per i dettagli e per scoprire come eseguire la migrazione alla nostra API Cloud di nuova generazione.
Messaggi di errore e di stato
Questo documento fornisce ulteriori informazioni sui seguenti tipi di messaggio di errore e di stato:
Per la risoluzione dei problemi relativi all'iscrizione incorporata, consulta Errori del flusso di iscrizione incorporata.
Codici di errore client dell'API di WhatsApp Business
| Codice di errore | Descrizione |
|---|---|
| Impossibile scaricare il contenuto multimediale dal mittente. |
| Impossibile inviare il messaggio perché si sono verificati uno o più errori relativi al metodo di pagamento.
Controlla la configurazione del pagamento in WhatsApp Manager e riprova. |
| Impossibile inviare il messaggio perché era in sospeso da troppo tempo (ovvero, >1 giorno). Questa situazione potrebbe verificarsi se il client dell'API di WhatsApp Business è inattivo per più di un giorno e successivamente viene riavviato. Invia di nuovo il messaggio. |
| Impossibile inviare il messaggio durante la durata Time To Live (TTL). |
|
|
| Impossibile inviare il messaggio perché si è verificato un errore relativo al certificato. Scarica un nuovo certificato da WhatsApp Manager e registrati nuovamente. |
| Impossibile inviare il messaggio perché si è verificato un errore relativo al certificato. Scarica un nuovo certificato da WhatsApp Manager e registrati nuovamente. |
| Si verifica quando si invia un messaggio e il certificato del client aziendale non è stato firmato correttamente utilizzando le chiavi di identità del client. Questo errore indica probabilmente che il client è stato registrato di nuovo usando nuove chiavi di identità, ma che la procedura di creazione del certificato non è stata terminata. |
| Impossibile inviare il messaggio perché sono trascorse più di 24 ore dall'ultima risposta del cliente a questo numero. Usa un modello di messaggio per rispondere. |
| Impossibile inviare il messaggio perché esistono limitazioni al numero di messaggi che possono essere inviati da questo numero di telefono. Questo errore può essere dovuto a un numero eccessivo di messaggi precedenti bloccati o contrassegnati come spam. Verifica lo stato della qualità in WhatsApp Manager. Per maggiori informazioni, consulta la documentazione sui rate limiting basati sulla qualità. |
| Impossibile inviare un messaggio perché il numero di telefono di questo utente fa parte di un esperimento. Salta l'invio di messaggi a questo utente. |
| Impossibile inviare il messaggio poiché l'utente con questo numero di telefono è potenzialmente cambiato. |
| Impossibile inviare il messaggio a causa di un errore sconosciuto. Riprova più tardi. |
| I messaggi con documenti contenenti didascalie non sono al momento supportati. |
| |
| La lunghezza del messaggio supera i 4096 caratteri. |
| Tipi di destinatari validi:
|
| Possibile conflitto UUID per la richiesta di caricamento dei contenuti multimediali o contenuti multimediali associati a quello specifico UUID già esistenti. |
|
|
| File o risorsa non trovati |
| Il destinatario non è presente nella lista di elementi consentiti |
| Manca un parametro obbligatorio. Se stai tentando di inviare un messaggio con lista, potresti non aver incluso la parte Se stai tentando di inviare un messaggio con uno o più prodotti, potresti non aver incluso |
| Il valore immesso per un parametro è del tipo sbagliato o altro problema. Se stai tentando di inviare un messaggio con lista, controlla se l'ID di ogni riga è unico. Se stai tentando di inviare un messaggio con un prodotto, è possibile che tu abbia inviato il Se stai tentando di inviare un messaggio per più prodotti, controlla che il |
| Contiene un parametro non richiesto. |
| |
| |
|
|
| Il rate limiting lato client è stato raggiunto. |
| Se il sistema è sovraccarico, viene restituito questo errore per consentire al sistema di recuperare la piena funzionalità. |
| Questo errore viene generato quando una richiesta solo master, come la configurazione o la richiesta di impostazioni, l'importazione, l'esportazione, la richiesta di codice, la registrazione ecc., viene inviata a un nodo che non è un master primario. Questo potrebbe accadere quando il client dell'API di WhatsApp Business non è configurato correttamente o quando vengono generati errori interni. Tentare un nuovo invio della richiesta dovrebbe risolvere questo errore. In caso contrario, contatta l'assistenza. |
| Questo errore viene generato quando le richieste vengono inviate a un nodo Coreapp che non è il proprietario della shard né è sottoposto alla procedura per diventarlo. Potresti vedere questo errore quando eseguiamo il failover di una shard nella configurazione multiconnect. Nella maggior parte dei casi, tentare un nuovo invio della richiesta dovrebbe risolvere questo errore. In caso contrario, contatta l'assistenza. |
| Questo errore viene generato quando invii un messaggio a te stesso. |
| Questo errore viene generato se non hai configurato il formato dei webhook dell'API REST. |
| |
| Devi modificare la password. |
| La richiesta non è valida. |
| Impossibile consegnare il messaggio. Consulta "Perché la mia percentuale di consegna non è del 100%?" FAQ. |
| Hai inviato un messaggio a un utente di WhatsApp che è potenzialmente cambiato e ti è stata inviata una notifica di sistema |
| Il tuo account è stato bloccato per l'invio di messaggi a causa di una violazione delle normative relative all'integrità. Per informazioni, consulta Applicazione della Normativa della piattaforma WhatsApp Business. |
| Il numero di parametri fornito non corrisponde al numero di parametri previsto. |
| Lo stato del modello non è attivo oppure il modello non esiste per una determinata lingua. |
| Il destinatario non è riuscito a scaricare il modello. |
| Non esistono modelli per una determinata lingua. |
| Parametro troppo lungo. |
| Testo tradotto troppo lungo. |
| Criteri sugli spazi bianchi violati. |
| Criteri sui caratteri del formato violati. |
| Il formato del contenuto multimediale utilizzato non è supportato. |
| Manca un componente obbligatorio nel modello. |
| L'URL nel componente button non è valido. |
| Il numero di telefono nel componente button non è valido. |
| Il formato del parametro non corrisponde a quello nel modello creato. |
| I pulsanti non sono supportati dal destinatario. |
| Questo errore si verifica quando non è stato ancora scaricato un pacchetto della lingua dei messaggi del modello. |
| La richiesta del messaggio contiene un numero di sezioni inferiore al numero minimo o superiore al massimo. Per maggiori informazioni, consulta l'oggetto Devi disporre di almeno 1 oggetto |
| È presente un numero non valido di righe. Per i messaggi con lista, deve essere presente almeno un oggetto |
| I criteri sui caratteri del formato sono stati violati. |
| L'oggetto section non dispone di prodotti o il numero totale di prodotti ha superato il numero massimo consentito. |
| L'ID del catalogo che hai fornito non esiste o non appartiene al tuo account WhatsApp Business. |
| L'ID del catalogo che hai fornito non è collegato al numero di telefono che stai utilizzando per inviare il messaggio. |
| Alcuni prodotti forniti nella tua richiesta non sono stati trovati nel catalogo. |
| Nessun prodotto è stato trovato nel catalogo che hai fornito. |
| Disponibile solo per le aziende in India. Questo errore viene restituito quando un'azienda invia un messaggio con un prodotto con informazioni mancanti e incomplete sulla conformità dell'e-commerce. |
| Disponibile solo per le aziende in India. Questo errore viene restituito quando un'azienda invia un messaggio per più prodotti con informazioni mancanti e incomplete sulla conformità dell'e-commerce. |
| Disponibile solo per le aziende in India. Questo errore viene restituito quando un'azienda invia un messaggio per più prodotti di cui alcuni non validi e altri con informazioni sulla conformità mancanti. |
| Restituito quando la struttura dell'oggetto |
| Disponibile solo per le aziende in India. Questo errore viene restituito quando un'azienda non ha fornito informazioni sulla conformità. Fai riferimento all'endpoint Business Compliance. |
| Lo stato del modello è |
| Lo stato del modello è |
| Lo stato del modello è |
| Il flusso con l'ID specificato non esiste o non appartiene al tuo account WhatsApp Business (WABA), oppure non è valido. |
| Il flusso è in stato di blocco. Questo errore può essere restituito anche se il flusso utilizza un endpoint e la configurazione richiesta non è completa, ad esempio se la chiave pubblica non è stata caricata o è diventata non valida. Consulta Implementazione dell'endpoint per i flussi. |
| Il flusso è in stato di throttling e nell'ultima ora sono già stati inviati 10 messaggi che usano questo flusso. |
Per i codici di errore del Gestore delle vendite specifici per le aziende indiane, consulta il Centro assistenza per le aziende.
Codici di stato HTTP
Sono codici di stato HTTP che potrebbero essere utilizzati dal client dell'API di WhatsApp Business.
| Codice HTTP | Descrizione |
|---|---|
| Azione eseguita correttamente |
| Azione eseguita correttamente (OK) |
| Creato correttamente (per richieste POST) |
| Trovato |
| Errori del client |
| Richiesta non valida |
| Non autorizzato |
| Non consentito |
| Non trovato |
| Metodo non consentito |
| Precondizione non valida |
| Il messaggio è soggetto a rate limiting |
| Troppe richieste |
| Errori del server |
| Errore interno del server |
| Timeout |