Kako uvesti povijest chatova i kontakata WhatsApp Business aplikacije putem API-ja
Broj WhatsApp Business aplikacije povezan putem Coexistencea može jednom, unutar 24 sata od onboardinga, poslati svoje postojeće kontakte i individualne chatove u trajanju do 180 dana, u oba smjera, na API. Kontakti stižu kao smb_app_state_sync webhookovi, a chatovi kao history webhookovi, u dijelovima poredanima prema metadata.chunk_order; metadata.progress jednak 100 označava dovršen uvoz. Poslovni korisnik u aplikaciji odlučuje hoće li podijeliti chatove.
easyCoexistence povezuje brojeve WhatsApp Business aplikacije vaših korisnika putem Coexistencea i od Mete traži njihove kontakte i povijest chatova čim je vaš webhook postavljen, pa povijest ide ravno na vaš endpoint bez ikakve pohrane usput, a svaki broj nadzire se 24/7.
Koliko daleko sežu history webhookovi, računajući od trenutka kad je poslovni korisnik prešao na Cloud API.
Vrijeme nakon onboardinga u kojem se kontakti i povijest poruka poslovnog korisnika moraju sinkronizirati.
Kôd pogreške na history webhooku kad je poslovni korisnik u WhatsApp Business aplikaciji isključio dijeljenje povijesti.
Koliko se često može pokrenuti svaka sinkronizacija; za ponavljanje korisnik mora odspojiti broj i ponovno proći Embedded Signup.
Vrijednost napretka koja označava da je sinkronizacija povijesti dovršena.
Kako započinje uvoz?
Uz odredište webhooka na broju. Kad se broj poveže s već postavljenim webhook_url u sjednici povezivanja ili kad ga postavite pomoću PUT /connections/{id}/webhook u roku od 24 sata od povezivanja, easyCoexistence jednom traži podatke od Mete: POST /{phone_number_id}/smb_app_data s sync_type smb_app_state_sync za kontakte, zatim history za chatove, redoslijedom koji Meta dokumentira. Dnevnik događaja broja bilježi history_sync_requested s vrijednostima request_id koje je dala Meta za podršku, ili history_sync_failed s razlogom.
Što nose webhookovi s kontaktima?
Polje smb_app_state_sync s nizom state_sync u value. Svaka stavka ima type contact; objekt contact s full_name, first_name i phone_number; radnju add ili remove; te metadata.timestamp. Imena se izostavljaju kod uklanjanja. Meta nastavlja slati ove webhookove nakon uvoza kad god poslovni korisnik u WhatsApp Business aplikaciji doda, uredi ili ukloni kontakt, pa vaš adresar ostaje usklađen s telefonom.
Što nose history webhookovi?
Polje history s nizom history u value. Svaka stavka sadrži metadata, s phase, chunk_order i progress, te threads, jednu nit po korisniku: ID niti je broj korisnika, a messages navodi taj individualni razgovor, dolazne i odlazne, pri čemu from pokazuje koja je strana poslala svaku poruku. Poruka nosi id, timestamp, type, svoj sadržaj pod nazivom tog tipa i history_context.status, primjerice READ ili DELIVERED. Grupni chatovi nisu uključeni.
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WABA_ID>",
"changes": [
{
"field": "history",
"value": {
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "<BUSINESS_NUMBER>", "phone_number_id": "<PHONE_NUMBER_ID>" },
"history": [
{
"metadata": { "phase": 1, "chunk_order": 3, "progress": 42 },
"threads": [
{
"id": "<CUSTOMER_NUMBER>",
"messages": [
{
"from": "<CUSTOMER_NUMBER>",
"id": "wamid.<ID>",
"timestamp": "1790726400",
"type": "text",
"text": { "body": "<MESSAGE_TEXT>" },
"history_context": { "status": "READ" }
}
]
}
]
}
]
}
}
]
}
]
}Kako se uvoze medijske poruke?
Prvo kao zamjenski sadržaj. Medijska poruka dolazi s type media_placeholder, bez sadržaja i bez ID-ja medija. Meta zatim šalje zasebne history webhookove s ID-jevima medija, ali samo za medije poslane u roku od 14 dana od onboardinga; te datoteke dohvatite od Mete pomoću tokena korisnika. Stariji mediji ostaju zamjenski sadržaj, pa ih prikažite kao privitak koji nije dostupan, umjesto da ostavite prazninu u niti.
Kojim redoslijedom stižu dijelovi i kad je uvoz gotov?
Ne nužno redom. Meta dijeli chatove u tri faze, od najnovijih: faza 0 je dan prije onboardinga, faza 1 seže do 90. dana, a faza 2 do 180. dana. Dijelovi mogu stići izvan slijeda, pa ih sortirajte prema metadata.chunk_order. metadata.progress je postotak cijele sinkronizacije, a 100 znači da je dovršena; sam broj faze ne pokazuje da je neka faza završila.
Što ako poslovni korisnik odbije dijeliti chatove?
Tijekom povezivanja WhatsApp Business aplikacija pita poslovnog korisnika želi li podijeliti povijest chatova. Odbijanje stiže kao history webhook bez poruka i s nizom errors čiji je kôd 2593109, naslovljen History sync is turned off by the business from the WhatsApp Business App. Kontakti i dalje stižu, a poruke uživo teku normalno od trenutka kad se broj povezao.
Može li se uvoz ponoviti?
Ne na istoj vezi. Meta dopušta svaku sinkronizaciju jednom, u roku od 24 sata od onboardinga, i ne može se ponoviti. Ponavljanje zahtijeva da korisnik odspoji broj i ponovno ga poveže, što se računa kao novi onboarding: ako je vaše odredište i dalje spremljeno, easyCoexistence ponovno traži uvoz, pa uklonite duplikate prema ID-ju svake poruke. To vrijedi i kad se broj vrati nakon pravila od 14 dana.
Što mora biti spremno prije slanja poveznice za povezivanje?
Vaš endpoint, pokrenut i odgovara. Meta provjerava URL pomoću svoje GET provjere kad se odredište primijeni, a uvoz se zatraži jednom, odmah nakon toga. Ako provjera ne uspije, broj se i dalje povezuje, ali bez odredišta; last_error sjednice objašnjava zašto, i ništa se ne uvozi osim ako ne popravite endpoint i ne postavite ga pomoću PUT /connections/{id}/webhook u roku od 24 sata. Broj bez webhook_url uopće ne dobiva uvoz, jer se sadržaj poslan easyCoexistenceu odbacuje.
Kako ga postaviti
- Prepare the endpointDeploy an HTTPS URL with a random secret in its path that answers Meta's GET handshake and accepts bodies up to 3 MB.
- Create the connect sessionPOST /connect-sessions with webhook_url and webhook_verify_token, then send the customer the url it returns.
- Store contacts and chatsUpsert contacts from smb_app_state_sync, and insert history messages keyed on their id, sorted by chunk_order.
- Wait for progress 100Treat the import as finished when metadata.progress reaches 100, or as declined when a history webhook carries error 2593109.
Uobičajene pogreške
- Odbijanje velikih dijelova povijesti. Metini payloadi mogu doseći 3 MB, dok Express po zadanim postavkama parsira JSON samo do 100 KB, pa povećajte ograničenje ili dijelovi neće proći, a Meta će ih pokušavati ponovno.
- Obrada dijelova prema redoslijedu dolaska. Mogu stići izvan slijeda, pa sortirajte prema metadata.chunk_order i pričekajte progress 100 prije nego što uvoz označite kao dovršen.
- Umetanje povijesti bez uklanjanja duplikata. Poruke uživo mogu se preklapati s uvozom, a ponovno povezivanje pokreće uvoz ponovno, pa poruke ključajte prema njihovom ID-ju.
- Slanje poveznice za povezivanje prije nego endpoint odgovori na Metinu GET provjeru. Odredište se tada ne primjenjuje, a ako ga ne postavite u roku od 24 sata, povijest broja se nikad ne uvozi.
Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, s prva 3 dana besplatno.
Često postavljana pitanja
Koliko daleko seže uvoz povijesti WhatsApp chatova?
Do 180 dana prije nego što je broj prešao na Cloud API, a obuhvaća individualne chatove u oba smjera.
Uvoze li se grupni chatovi?
Ne. Meta izostavlja poruke koje su dio grupnog chata.
Stižu li stari WhatsApp chatovi korisnika na moj webhook?
Da, do 180 dana individualnih chatova, poslanih jednom u roku od 24 sata od onboardinga, ako poslovni korisnik u aplikaciji odluči da ih podijeli.
Čuva li easyCoexistence kopiju uvezenih chatova?
Ne. Meta povijest šalje ravno na vaš webhook_url, kao i poruke uživo, a ništa se usput ne pohranjuje.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na