Assistenza

Risoluzione dei problemi

Messaggio non consegnato

Un messaggio può risultare in stato inviato ma non consegnato nei seguenti scenari. Per molti di questi motivi, non divulgheremo la causa scatenante dell'errore per ragioni di privacy e normative.

  • Il cliente non si è connesso nella finestra di 30 giorni durante la quale conserviamo i messaggi per i clienti offline.
  • Il cliente ha bloccato il numero di telefono aziendale o un altro numero di telefono aziendale di proprietà dell'azienda.
  • Il cliente si trova in un Paese con restrizioni o sanzionato.

In alcuni scenari, l'API restituisce un codice di errore con un messaggio che descrive la natura dell'errore. Esempi di scenari:

  • Parametri di richiesta non validi
  • Errori di integrità
  • Il cliente non ha accettato le nostre nuove Condizioni d'uso e l'Informativa sulla privacy. Invia all'utente finale il link https://wa.me/tos/20210210 per accettare la nuova versione delle Condizioni d'uso.
  • Il cliente utilizza una versione precedente di WhatsApp. I clienti devono utilizzare la seguente versione o successiva:
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
    • Web: 2.2132.6
  • Il cliente fa parte di un gruppo esperimento.
  • Il messaggio non è stato consegnato per garantire un'esperienza utente di alta qualità. Consulta Limiti di messaggi per modelli di marketing per utente .

Possibili soluzioni

Usando un metodo di comunicazione diverso da WhatsApp, chiedi all'utente di WhatsApp di:

  • confermare di essere effettivamente in grado di inviare un messaggio ai tuoi numeri di telefono WhatsApp Business;
  • confermare che nessuno dei tuoi numeri di telefono WhatsApp Business sia presente nella sua lista di numeri bloccati (Impostazioni > Privacy > Bloccati o Contatti bloccati);
  • confermare di aver accettato le nostre Condizioni d'uso più recenti (Impostazioni > Aiuto, o Impostazioni > Informazioni sull'applicazione richiederà l'accettazione delle condizioni/normative più recenti se non è stato ancora fatto);
  • effettuare l'aggiornamento alla versione più recente del client di WhatsApp.

Limitazioni in base al Paese

Le aziende con sede a Cuba, in Iran, in Corea del Nord, in Siria e nelle tre regioni sanzionate dell'Ucraina (Crimea, Donetsk, Luhansk) non sono idonee all'utilizzo della piattaforma WhatsApp Business.

I messaggi degli utenti di WhatsApp Messenger (WhatsApp) e WhatsApp Business che si trovano a Cuba, in Iran, in Corea del Nord, in Siria e nelle tre regioni sanzionate dell'Ucraina (Crimea, Donetsk, Luhansk) non sono idonei a ricevere messaggi inviati attraverso la piattaforma WhatsApp Business.

A partire dal 15 maggio 2024, la Turchia non è più sottoposta a restrizioni della messaggistica aziendale dell'API Cloud. Le aziende che utilizzano l'API Cloud possono ora avviare conversazioni e ricevere messaggi dagli utenti di WhatsApp con numeri turchi.

Webhook

Stato di consegna del messaggio in conflitto

In rari casi, lo stesso messaggio potrebbe attivare contemporaneamente webhook di aggiornamento dello stato del messaggio con esito positivo e con esito negativo. Ad esempio, un messaggio potrebbe attivare webhook di messaggio con "status":"delivered" e un altro webhook con "status":"failed". Questo può succedere quando un cliente è connesso a WhatsApp su più dispositivi e il messaggio viene correttamente consegnato a un dispositivo ma non all'altro. Ogni messaggio che attiva un webhook di stato del messaggio "delivered" è stato consegnato almeno a uno dei dispositivi dell'utente.

Codice di errore 2 - Servizio API

Quando aggiorniamo l'API, potresti riscontrare fino a 5 minuti di inattività. Durante questo periodo, il servizio non è disponibile. Facciamo tutto il possibile perché questi aggiornamenti comportino un'interruzione minima dell'attività, ma potresti comunque riscontrare dei problemi

Come eseguire il debug

Ti suggeriamo di attendere 5 minuti e riprovare a effettuare la chiamata API.

Errori di autenticazione e autorizzazione

Questi errori vengono restituiti in caso di problema con il token d'accesso in uso per la chiamata API.

Come eseguire il debug

Puoi incollare direttamente il token d'accesso nel debugger dei token d'accesso. Successivamente, verifica di aver selezionato le autorizzazioni whatsapp_business_management e whatsapp_business_messaging.

Se il tuo token non ha accesso alle autorizzazioni, devi generarne uno nuovo. In fase di generazione del token, assicurati di selezionare:

  • l'app Meta che stai utilizzando per le chiamate API;
  • le seguenti autorizzazioni: whatsapp_business_management e whatsapp_business_messaging.

FAQ

FAQ generali

WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.

Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.

We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.

FAQ sull'implementazione tecnica

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.

As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.

Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.

FAQ sull'affidabilità

La disponibilità viene aggiornata una volta al giorno.

Potrebbero verificarsi situazioni in cui determinati errori dell'utente vengono conteggiati erroneamente in modo automatico all'interno del tempo di inattività. In queste situazioni, il tempo di inattività viene modificato in tempo di attività dopo un'analisi dettagliata entro una settimana.

Potrebbero esserci problemi che non incidono sulla nostra disponibilità globale. In questi casi, la pagina dello stato dell'API di WhatsApp Business riporterà uno stato indicante la possibile presenza di interruzioni che non incidono sulla disponibilità globale. Invia un ticket all' Assistenza diretta per indagare ulteriormente.

Esistono dei casi in cui i tempi di inattività della disponibilità non sono monitorati automaticamente:

  • Problemi di rete che determinano la mancata riuscita delle richieste prima che raggiungano il livello dell'API Graph (primo livello).
  • Problemi di rete che determinano il mancato raggiungimento dell'endpoint del webhook dell'azienda da parte dei webhook in uscita.

Qualsiasi problema che emerga prima dell'ingresso nel nostro sistema dopo questo momento sarà visibile come errore o mancata operazione eseguita correttamente. Inoltre, anche dopo problemi riscontrati in seguito al primo tentativo di emissione del webhook, si continuerà a riprovare l'invio, fino a quando non sarà consegnato correttamente all'endpoint del webhook.

Gli altri casi riportati nella dashboard della disponibilità dopo il rilevamento manuale sono (non errori di sistema):

  • Viene determinato se i problemi di autenticazione di Meta come i token di autorizzazione (librerie di sicurezza) sono relativi a richieste legittime che non riescono a eseguire l'autenticazione o l'autorizzazione.
  • Convalida che rifiuta le richieste legittime.

In entrambi i casi WhatsApp rileverà e terrà conto di questi problemi dopo il verificarsi del fatto, quasi in tempo reale.

Al momento non offriamo accordi sul livello di servizio dei prodotti disponibili in commercio per il tempo di attività e/o la latenza.

We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.