Il webhook history
history contiene il trasferimento una tantum delle conversazioni esistenti di un numero Coexistence verso l'API. Arriva dopo l'onboarding, se è stata accettata la condivisione della cronologia, ed è l'unico segnale che un'integrazione riceve per sapere che il trasferimento è avvenuto.
La finestra dopo l'onboarding entro cui deve iniziare la sincronizzazione.
L'errore restituito quando la sincronizzazione è già stata usata.
L'errore restituito quando viene tentata fuori da quella finestra.
Cosa consegna
La cronologia uno a uno dei messaggi già presenti nell'app WhatsApp Business, trasferita affinché il software non inizi alla cieca su una linea utilizzata dall'azienda da anni.
Non vengono trasferite le conversazioni di gruppo, escluse interamente dall'API su un numero Coexistence, né gli strumenti dell'app: etichette, risposte rapide, messaggi di benvenuto e di assenza non hanno un equivalente nell'API e restano sul dispositivo.
Questo campo esiste solo sui numeri Coexistence. Un numero sottoposto all'onboarding nel modo ordinario non ha una cronologia precedente dell'app da trasferire, quindi non c'è nulla da consegnare.
Perché viene inviato una sola volta
Perché il trasferimento fa parte dell'onboarding, non di una funzionalità continuativa.
Durante Embedded Signup, al titolare dell'azienda viene chiesto se vuole condividere le conversazioni esistenti. Rispondere sì consente l'esecuzione della sincronizzazione e non esiste alcuna impostazione per riattivarla in seguito, né un endpoint che la ripeta. Un secondo tentativo restituisce 2593107, non un limite di frequenza temporaneo.
Esiste anche una scadenza. La sincronizzazione deve iniziare entro 24 ore dall'onboarding; un tentativo successivo restituisce 2593108. Se manca una delle due condizioni, occorre disconnettere il numero e ripetere l'intero flusso.
Cosa deve farne un gestore
Trattalo come un batch che arriva una sola volta e può essere grande, non come ulteriore traffico sul percorso dei messaggi.
- Conferma rapidamente e processa in modo asincrono, come qualsiasi altra consegna.
- Deduplica usando message id: la cronologia e i messaggi in tempo reale possono sovrapporsi durante l'onboarding.
- Aspettati che non arrivi. Un numero il cui titolare ha rifiutato la cronologia non invia nulla qui e l'integrazione deve funzionare comunque.
- Non bloccare l'onboarding in attesa. La connessione è utilizzabile prima del completamento del trasferimento.
Errori comuni
- Creare un'integrazione che richieda la presenza della cronologia. Molti numeri si connettono senza.
- Riprovare la sincronizzazione dopo 2593107. È un evento una tantum, quindi il tentativo restituisce lo stesso errore.
- Rimandare la scelta sulla cronologia all'inizio del lavoro d'integrazione, di solito dopo la chiusura della finestra di 24 ore.
EasyCoexistence registra l'onboarding e la scelta sulla cronologia nella timeline della connessione, così sapere se e quando un numero è stato sincronizzato è un fatto datato, non qualcosa da ricostruire in seguito.
Domande frequenti
Quanta cronologia arriva?
Una finestra di conversazioni uno a uno recenti, definita da Meta e non dal provider.
Le chat di gruppo vengono trasferite?
No. I gruppi sono esclusi interamente dall'API su un numero Coexistence.
Posso richiederla di nuovo in seguito?
No. Viene eseguita una volta per onboarding; ripeterla richiede di disconnettere e riconnettere il numero.
Cosa succede se il titolare rifiuta la cronologia?
Su questo campo non arriva nulla e l'API vede solo i messaggi dal momento in cui il numero si è connesso.
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