Questo documento è un registro delle modifiche apportate alla piattaforma WhatsApp Business.
API Cloud
API Cloud, API On-Premises
API Cloud
biz_opaque_callback_data
da 256 a 512.API Business Management
cta_url_link_tracking_opted_out
sul nodo WhatsApp Message Template per abilitare/disabilitare il monitoraggio dei clic sul pulsante.UTILITY
.API Business Management
API Cloud
health_status
a vari nodi per controllare lo stato di integrità dei messaggi.biz_opaque_callback_data
ai messaggi liberi per includere stringhe arbitrarie nei webhook messaggi.API Business Management
API Business Management, API Cloud, API On-Premises
Flows
API Cloud
data_localization_region
sull'endpoint Numero di telefono WhatsApp Business > Registra per abilitare l'archiviazione locale.API Business Management, API Cloud, API On-Premises
code_expiration_minutes
(invece di un'impostazione predefinita di 10 minuti) per determinare se il modello di messaggio inviato deve visualizzare un pulsante per l'inserimento automatico o un pulsante per copiare il codice.code_expiration_minutes
del modello, se presente (o dopo 10 minuti, se non presente).API Cloud
limited_time_offer
.API Cloud
ctwa_clid
all'oggetto referral
nei webhook dei messaggi. Indica l'ID clic generato quando l'utente tocca un'inserzione che rimanda a WhatsApp per inviare il messaggio.API Cloud, API On-Premises
API Business Management
add_security_recommendation
e code_expiration_minutes
nel valore component
.200
se l'utente identificato dal token non dispone dell'accesso all'account WhatsApp Business appropriato.API Cloud
API Cloud, API On-Premises
API Cloud, API On-Premises
Strumenti
API Business Management
Iscrizione integrata
API Business Management
VERIFIED
di 28 giorni (dai 14 precedenti).API Cloud
Gestione aziendale
Strumenti
Gestione aziendale
2494100
dell'API Business Management che indica che un numero di telefono aziendale è temporaneamente in modalità di manutenzione.API Cloud
Strumenti
API Cloud
132015
invece di 132001
.132016
invece di 132001
.API On-Premises
2061
.2062
.API Business Management
API Cloud
API On-Premises
API Business Management
account_alerts
.AUTHENTICATION
, MARKETING
o UTILITY
.API Business Management
hsm_id
all'endpoint Account WhatsApp Business > Modelli di messaggi DELETE. Se incluso, elimina un singolo modello che corrisponde all'ID fornito (anziché eliminare tutti i modelli che corrispondono al nome fornito).API Cloud
last_onboarded_time
al nodo del numero di telefono di WhatsApp Business. Indica quando un utente ha creato un numero di telefono aziendale sul suo account WhatsApp Business completando il flusso di iscrizione integrata.API Cloud
Iscrizione integrata
API Business Management, API Cloud, API On-Premises
allow_category_change
all'endpoint POST WhatsApp Business Account > Message Templates.INCORRECT_CATEGORY
come nuovo valore reason
di rifiuto per i webhook sullo stato del modello.previous_category
ai modelli di messaggi WhatsApp.API Business Management
template_category_update
. Se hai attivato l'iscrizione per questo campo, ogni volta che la categoria di un modello cambia riceverai un webhook indicante la categoria precedente e quella nuova.API Cloud
API On-Premises
API Cloud, API On-Premises
API Business Management
API Cloud, API On-Premises
API Business Management, API Cloud
API Cloud
AUTHENTICATION
MARKETING
UTILITY
code
e details
."code":100
) aveva più titoli unici che indicavano la natura di un dato errore 100. Tutti gli errori codice 100 ora useranno come titolo Invalid parameter
. I vecchi titoli che descrivevano la natura di un dato errore codice 100 sono stati spostati nella proprietà details
. Questa modifica si riflette anche nei payload dei webhook che descrivono una risposta di errore con codice 100.Webhook API Cloud
errors
nei webhook attivati dagli errori relativi a richieste a partire dalla versione 16.0 includono ora le proprietà message
e error_data.details
; inoltre, i valori title
sono stati modificati per diversi codici di errore. Ora, gli oggetti errors
presentano la seguente struttura e includono questi dati:[ { "code": <CODE>, "title" : "<TITLE>", "message": "<MESSAGE>", "error_data": { "details": "<DETAILS>" } }, ... ]
title
è stato aggiornato per i seguenti codici di errore. I valori precedenti sono ora mostrati in error_data.details
.
130470
è ora Re-engagement message
130429
è ora Rate limit hit
131045
è ora Incorrect certificate
131031
è ora Business Account locked
131053
è ora Media upload error
131027
è ora Something went wrong
131042
è ora Business eligibility payment issue
131026
è ora Message Undeliverable
131000
è ora Something went wrong
message
è lo stesso della proprietà title
, che indica il titolo del codice di errore. Questa proprietà mappa alla proprietà message
nei payload delle risposte di errore dell'API.error_data.details
ora include i titoli dei codici di errore elencati in alto e descrive la causa all'origine di ogni errore. Questo valore mappa alla proprietà details
nei payload delle risposte di errore dell'API.Queste modifiche sono riflesse nelle seguenti proprietà errors
nei webhook correlati agli errori:
entry.changes.value.errors
entry.changes.value.messages.errors
entry.changes.value.statuses.errors
API Cloud
Le aziende non verificate possono ora avviare fino a 250 conversazioni in un periodo di 24 ore.
Si applica a tutte le versioni dell'API Cloud.
Aggiunto un nuovo campo phone_number_id
opzionale all'endpoint Media. Se includi questo parametro e un ID del numero di telefono aziendale, l'operazione sarà elaborata solo se l'ID del numero di telefono corrisponde all'ID del numero di telefono su cui è stato caricato il contenuto multimediale.
La memorizzazione nella cache di HTTP di contenuti multimediali dell'API Cloud è fuori dalla versione beta e disponibile per tutti.
Ora l'API Cloud tenta di reinviare notifiche webhook non riuscite per un massimo di 7 giorni (e non di 30 giorni). Consulta Errore di consegna webhook.
Si applica a tutte le versioni.
template_performance_metrics
. Invia notifiche settimanali su tutte le metriche relative alle prestazioni del modello, tra cui il numero dei messaggi inviati, il numero dei messaggi aperti e i motivi più comuni dei blocchi.Si applica a tutte le versioni.
Nuovo campo account_alerts
:
account_alerts
. Invia notifiche sugli avvisi dell'account business, dell'account WhatsApp Business e del numero di telefono aziendale.Nuovi valori del campo account_update
:
account_update.events
: ACCOUNT_DELETED
. Indica l'annullamento della registrazione di un numero di telefono o l'eliminazione da un account WhatsApp Business.message_template_status_update.events
: PENDING_DELETION
. Indica che un modello di messaggio è stato contrassegnato per l'eliminazione.Notifiche webhook di esempio inviate quando vengono attivati questi nuovi eventi:
ACCOUNT_DELETED
: account WhatsApp Business eliminatoPENDING_DELETION
: eliminazione del modello di messaggio in sospesoAggiunta dei seguenti campi del nodo dell'account WhatsApp Business:
country
(si applica a v15.0+
)ownership_type
(si applica a v15.0+
)business_verification_status
(si applica a tutte le versioni)Si applica alla versione 15.0 e successive.
Aggiunta delle seguenti opzioni di filtro all'endpoint degli account WhatsApp Business del cliente aziendale:
creation_time
dell'account WhatsApp Business utilizzando gli operatori GREATER_THAN
, LESS_THAN
o IN_RANGE
.ownership_type
dell'account WhatsApp Business utilizzando gli operatori EQUAL
o IN
.Aggiunta delle seguenti opzioni di filtro all'endpoint degli account WhatsApp Business di proprietà dell'azienda:
creation_time
dell'account WhatsApp Business utilizzando gli operatori GREATER_THAN
, LESS_THAN
o IN_RANGE
.ownership_type
dell'account WhatsApp Business utilizzando gli operatori EQUAL
o IN
.country
dell'account WhatsApp Business utilizzando gli operatori EQUAL
o IN
.Si applica alla versione 15.0 e successive.
Aggiunta dei seguenti campi del nodo del numero di telefono di WhatsApp Business:
is_official_business_account
messaging_limit_tier
Inoltre, puoi filtrare l'endpoint dei numeri di telefono dell'account WhatsApp Business in base al campo is_official_business_account
.
Adesso l'API Cloud supporta fino a un massimo di 500 (in precedenza 350) messaggi al secondo (mps) di testo e messaggi multimediali combinati, su richiesta. Per maggiori dettagli, consulta Throughput.
Se hai già 350 mps, questo valore verrà aumentato automaticamente a 500 mps. Se hai già richiesto 350 mps ma la procedura non è stata completata, riceverai 500 mps al termine.
Al momento stiamo eseguendo i test beta della memorizzazione nella cache di HTTP di contenuti multimediali dell'API Cloud. Se sei un partner di soluzioni, consulta Memorizzazione nella cache di HTTP per scoprire come utilizzare le intestazioni nelle risposte del server che ci indicano di memorizzare nella cache le tue risorse multimediali, per riutilizzarle con messaggi futuri.
L'API Cloud ora supporta le didascalie nei documenti inviati e ricevuti dai clienti. Consulta Oggetto Media nel riferimento Contenuto multimediale.
Ora gli account WhatsApp Business possono avere fino a 6000 modelli di messaggi se il Business Manager principale è stato verificato e almeno uno degli account WhatsApp Business del Business Manager principale ha un numero di telefono aziendale con un nome visualizzato approvato.
Come parte di questa modifica, le versioni tradotte dei modelli di messaggi ora sono conteggiate ai fini del raggiungimento del limite di modelli di un account WhatsApp Business.
Ora le attività in India possono utilizzare la carta di credito per pagare i messaggi inviati tramite la piattaforma. Consulta Aggiunta di una carta di credito all'account della piattaforma WhatsApp Business.
Ora puoi migrare un numero di telefono aziendale in e da account WhatsApp Business dell'API Cloud. Consulta Migrazione di un numero di telefono a un account WhatsApp Business diverso
Solo API Cloud.
Ora puoi usare diversi URL di callback per ciascuno dei tuoi account WhatsApp Business senza dover creare un'app unica per ogni account. Per maggiori dettagli, consulta Override dell'URL di callback.
Tutti gli endpoint dell'API Cloud ora supportano le chiamate della versione 15.
Solo API Cloud.
I parametri di testo (components.parameters.text
) per i modelli di messaggi che utilizzano solo un componente body (components.type:body
) ora possono arrivare a 32.768 caratteri. Consulta Oggetto Parameters.
Solo API Cloud.
Adesso l'API Cloud supporta fino a un massimo di 350 (in precedenza erano 250) messaggi al secondo (mps), composti da SMS e messaggi contenenti contenuto multimediale combinati, su richiesta. Per maggiori dettagli, consulta Throughput.
Se hai già 250 mps, questo valore verrà aumentato automaticamente a 350 mps. Se hai già richiesto 250 mps ma il processo non è stato completato, riceverai 350 mps al termine della procedura.
Ora sono supportate le reazioni. Consulta Invio di messaggi - Messaggi con reazione per scoprire come inviare e ricevere reazioni e Esempi di payload - Messaggi con reazione per esempi di notifica dei payload dei webhook.
Ora il campo about
sui profili delle attività è supportato. Per maggiori dettagli, consulta Profili dell'attività.
È ora disponibile la documentazione più recente per richiedere la migrazione da 80 messaggi al secondo a 250 messaggi al secondo di invio e ricezione combinati di SMS e messaggi contenenti contenuto multimediale. Consulta Throughput.
Adesso puoi includere adesivi animati nei messaggi in uscita avviati dall'azienda e ricevere webhook Message che descrivono quei messaggi come faresti se stessi inviando un adesivo non animato. Consulta la proprietà sticker
dell'oggetto Message e per i requisiti delle risorse degli adesivi animati.
Adesso puoi includere prodotti e servizi nei messaggi inviati ai clienti e questi ultimi possono aggiungerli ai carrelli senza dover lasciare la chat. Consulta la guida Vendita di prodotti e servizi per scoprire come inviare messaggi per uno o più prodotti ai clienti.
Adesso le aziende possono rispondere a qualsiasi messaggio in una conversazione. Le risposte includono una bolla contestuale che fa riferimento al messaggio a cui si è risposto. Consulta la guida Invio di messaggi per scoprire come rispondere a un messaggio.
Adesso l'API Cloud supporta fino a un massimo di 250 messaggi al secondo di invio e ricezione combinati (SMS e messaggi contenenti contenuto multimediale inclusi), su richiesta. Se sei un partner aziendale, puoi inviare un ticket all'Assistenza diretta per richiedere il throughput 250 MPS selezionando l'argomento "Cloud API Issues" (Problemi API Cloud), il tipo di richiesta "Request to migrate to 250 MPS throughput" (Richiesta di passare al throughput 250 MPS) e inserendo le informazioni necessarie.
v2.43
11 ottobre 2022v2.43
, apporteremo delle modifiche al comportamento dell'endpoint contacts
.
status
cambieranno. A prescindere dal fatto che l'utente disponga o meno di WhatsApp, verrà restituito lo status
valid
nella risposta e un wa_id.
. Non c'è alcuna garanzia che il wa_id restituito sia valido. Queste modifiche sono applicabili sia per le risposte dirette sia per le risposte webhook per le chiamate non bloccanti. contacts
restituisca status
e wa_id
. Inoltre, è possibile inviare un messaggio nella versione v2.39.1
o nelle versioni successive senza effettuare chiamate al nodo contacts
. Assicurati che il codice sia in grado di gestire un potenziale errore 1013
Utente non valido, generato quando viene effettuato un tentativo di inviare un modello di messaggio a un numero di telefono senza un account WhatsApp.
Per i messaggi diversi dai modelli di messaggio, inviare un messaggio a un numero di telefono senza account WhatsApp restituirà l'errore 470
.
v2.45
10 gennaio 2023A partire dalla versione v2.45
, il parametro opzionale cert
nel nodo shards
diventerà obbligatorio per tutte le richieste. Aggiorna la tua integrazione in modo che includa sempre un parametro cert
valido nelle chiamate al nodo shards
.
A partire dalla versione v2.41.2
, le aziende possono usare il nodo application
per filtrare gli stati di invio dei messaggi a cui non sono interessate tramite l'oggetto message
all'interno dell'oggetto webhooks
. Nella versione v2.45
, sent_status
diventerà obsoleto, quindi dovrai aggiornare la tua integrazione in modo che usi l'oggetto webhooks
nel nodo application
per tutti i controlli webhook.
A partire dalla versione v2.39.1
, recipient_id
è disponibile sia nell'oggetto statuses
che nell'oggetto message
. Nella versione v2.45
, recipient_id
verrà rimosso nell'oggetto statuses
, quindi dovrai aggiornare la tua integrazione in modo che usi recipient_id
nell'oggetto message
.
v2.41.3
)2.41.3
La versione v2.41.3
del nostro client dell'API Business include: aggiunta di un nuovo indice della tabella su message_receipt_log
che potrebbe rappresentare un vantaggio per i partner con esigenze di throughput elevato. Ad esempio, questo miglioramento consente ai partner di inviare più di 200 messaggi/secondo.
v2.41.2
)Nella versione v2.41.2, stiamo introducendo delle modifiche allo schema DB per migliorare le prestazioni del sistema. Come risultato, gli aggiornamenti dalle versioni v2.37.2 e v2.39.x per le configurazioni con database di grandi dimensioni che contengono milioni di messaggi e contatti richiederanno più tempo del solito.
Consigliamo generalmente di effettuare gli aggiornamenti nelle ore fuori picco e di aggiornare prima le configurazioni con throughput inferiore.
Per i database di grandi dimensioni:
Avvia la garbage collection dall'endpoint /services/message/gc prima dell'aggiornamento e assicurati che venga completata correttamente.
Usa lo strumento dbupgrade per aggiornare gli schemi dei DB prima di aggiornare la versione. Al termine, potrai aggiornare le versioni dell'API riducendo al minimo i tempi di inattività. Consigliamo vivamente di disattivare il client dell'API prima di usare lo strumento dbupgrade. Assicurati che lo strumento dbupgrade completi correttamente l'operazione (exit code 0) ed eviti o limiti le richieste API mentre l'aggiornamento è in corso.
Consigliamo di aumentare il timeout delle query sui server del database a un'ora fino al completamento corretto dell'aggiornamento.
Questa versione client contiene le seguenti funzioni e i seguenti aggiornamenti:
delivered
e read
per avere più controllo sulle notifiche webhook per i messaggi. È possibile farlo tramite l'endpoint settings/applications.namespace
è opzionale per l'oggetto templateA partire da oggi, l'API Cloud di WhatsApp Business è aperta a tutti gli sviluppatori che creano prodotti o servizi per sé stessi o le proprie organizzazioni. Per iniziare, consulta la nostra guida. Se desideri offrire l'accesso all'API ai tuoi clienti, iscriviti alla nostra lista di attesa.
I seguenti valori per il parametro category
per l'endpoint /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template
sono diventati obsoleti per la versione v14.0
e successive:
|
|
|
Sono stati aggiunti i seguenti valori:
TRANSACTIONAL
MARKETING
Questa versione del client include tutte le funzioni e le risoluzioni presenti nella versione v2.39.1
. Inoltre, in questa versione:
v2.39.2
.v2.39.3
.v2.39.4
, le aziende riceveranno delle notifiche quando ricevono un messaggio effimero, con una notifica webhook di tipo "ephemeral"
. Le aziende non potranno vedere il contenuto del messaggio.Quando abbiamo lanciato la versione v2.39.3
, il problema dei messaggi effimeri veniva gestito automaticamente da WhatsApp disabilitando questi messaggi nella conversazione in chat con il cliente. Nella versione v2.39.4
, tale condizione non si verifica e le aziende che ricevono messaggi effimeri devono chiedere ai clienti di disattivarli e di inviare nuovamente l'ultimo messaggio.
2.3.8
A partire da oggi, l'API Cloud include i seguenti aggiornamenti:
2.3.7
A partire da oggi, l'API Cloud è generalmente disponibile per tutti i partner di soluzioni esistenti e per i clienti diretti. Inoltre, saranno disponibili le seguenti funzioni per gli sviluppatori dell'API Cloud:
POST
a PHONE_NUMBER_ID/deregister
per rimuovere un numero di telefono dall'API di WhatsApp Business. Per informazioni, consulta Registrazione.referral
dei webhook dell'API Cloud è diverso dall'oggetto referral
dell'API On-Premises.Inoltre, l'analisi dell'app non sarà più richiesta per gli sviluppatori proprietari che utilizzano l'API Cloud. Tutti gli sviluppatori sono soggetti ai limiti di messaggi della piattaforma WhatsApp Business.
Questa versione include le stesse funzioni della versione v2.37.1
, ma ha una diversa data di scadenza. La versione v2.37.2
scade il 22 settembre 2022.
Alcuni sviluppatori Kubernetes potrebbero riscontrare CrashLoopBackOff
per il proprio contenitore webapp e il contenitore stesso potrebbe non essere avviato. Per risolvere il problema, aggiungi la riga seguente nel file YML
dell'implementazione Kubernetes nella configurazione webapp:
command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]
A partire da oggi, la versione v2.39.3
del nostro client dell'API Business è disponibile per gli sviluppatori. Il nuovo client include la risoluzione di due problemi e registri aggiuntivi per supportare il debugging. I due problemi risolti sono:
A partire da oggi, gli utenti della beta dell'API Cloud possono iniziare a inviare messaggi con lista e pulsanti Rispondi. Consulta la seguente documentazione per maggiori dettagli:
A partire da oggi, gli utenti della beta dell'API Cloud possono aggiungere una casella URL dell'anteprima agli SMS che includono un URL. Consulta la seguente documentazione per maggiori dettagli:
Abbiamo appena rilasciato la versione v2.39.2
dell'API On-Premises. Questa versione risolve un bug che impediva l'invio di videomessaggi in determinate circostanze.
A partire da oggi, gli utenti della beta dell'API Cloud possono iniziare a inviare e ricevere videomessaggi. La seguente documentazione fornisce maggiori informazioni:
A partire da oggi, WhatsApp è passato da un modello di prezzi basato sulle notifiche a uno basato sulle conversazioni. Le aziende pagano per singola conversazione, che comprende tutti i messaggi consegnati in una sessione di 24 ore. Per maggiori informazioni, consulta Prezzi basati sulle conversazioni.
A partire da oggi, gli utenti della beta dell'API Cloud possono iniziare a inviare e ricevere messaggi basati sulla posizione e contenenti contatti. Per maggiori informazioni, consulta la documentazione di seguito:
Adesso supportiamo un throughput di picco di 80 messaggi al secondo per ogni numero di telefono. In tale conteggio sono inclusi messaggi in entrata e in uscita, nonché SMS, modelli di messaggi e messaggi contenenti contenuto multimediale.
2.39.1
)La versione 2.39.1
del nostro client dell'API Business è disponibile per gli sviluppatori a partire da oggi. Il nuovo client include:
A partire dalla nuova versione del client dell'API, sarà possibile fornire il certificato del proprio telefono quando si configura multiconnect. Questo significa che, nelle chiamate all'endpoint /v1/account/shards, è possibile aggiungere il certificato con codifica Base64 al campo cert. Consulta Personalizzazione del client dell'API con Multiconnect per maggiori informazioni.
Abbiamo aggiunto graph.whatsapp.com
all'elenco di nomi host dei server di WhatsApp per cui il client API Business richiede la connettività. Per informazioni, consulta Configurazione ed esecuzione del debug della rete, Nomi host.
Nella versione v2.39
, abbiamo aggiunto il codice di errore 1031
. Riceverai questo errore se il tuo account viene bloccato per l'invio di messaggi a causa di una violazione delle normative relative all'integrità. Per informazioni, consulta Messaggi di errore e di stato e Applicazione delle normative.
hsm
è diventato obsoleto con la versione v2.39
. Al suo posto, usa il tipo template
.webhook_payload_conversation_pricingmodel_disabled
è diventata obsoleta.Non è possibile inviare alcuni videomessaggi in determinate circostanze.