Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Kako uvesti istoriju razgovora i kontakte iz WhatsApp Business aplikacije preko API-ja

Broj iz WhatsApp Business aplikacije povezan preko Coexistence može jednom, u roku od 24 sata od priključenja, da pošalje svoje postojeće kontakte i do 180 dana razgovora jedan na jedan u oba smera ka API-ju. Kontakti stižu kao webhookovi smb_app_state_sync, a razgovori kao webhookovi history, u delovima poređanim po metadata.chunk_order; metadata.progress na 100 označava da je uvoz završen. Firma u aplikaciji sama bira da li će deliti razgovore.

easyCoexistence povezuje brojeve WhatsApp Business aplikacije vaših kupaca preko Coexistence i traži od kompanije Meta njihove kontakte i istoriju razgovora čim vaš webhook bude postavljen, pa istorija ide direktno na vaš endpoint bez ikakvog čuvanja usput, a svaki broj se prati 24/7.

180 days

Koliko unazad sežu webhookovi istorije, računajući od trenutka kada je firma priključena na Cloud API.

24 hours

Rok posle priključenja u kojem se kontakti i istorija poruka firme moraju sinhronizovati.

2593109

Kod greške na history webhooku kada je firma isključila deljenje istorije u aplikaciji WhatsApp Business.

Once

Koliko često se svaka sinhronizacija može pokrenuti; ponavljanje zahteva da korisnik ukloni broj i ponovo prođe kroz Embedded Signup.

100

Vrednost napretka koja označava da je sinhronizacija istorije završena.

Kako počinje uvoz?

Uvoz počinje webhook odredištem na broju. Kada se broj poveže sa već postavljenim webhook_url u sesiji povezivanja, ili kada ga postavite pomoću PUT /connections/{id}/webhook u roku od 24 sata od povezivanja, easyCoexistence jednom traži podatke od kompanije Meta: POST /{phone_number_id}/smb_app_data sa sync_type smb_app_state_sync za kontakte, pa zatim history za razgovore, redosledom koji Meta dokumentuje. Dnevnik događaja broja beleži history_sync_requested sa vrednostima request_id koje Meta dodeljuje za podršku, ili history_sync_failed sa razlogom.

1Connect sessionwebhook_url and webhook_verify_token set before the link goes out
2Customer connectsScans the QR code and chooses whether to share chats
3Contactssmb_app_state_sync, a change per contact
4Chatshistory chunks, the newest phase first
5Completemetadata.progress reaches 100

Šta nose webhookovi kontakata?

Polje smb_app_state_sync, sa nizom state_sync u polju value. Svaka stavka ima type contact; objekat contact sa full_name, first_name i phone_number; radnju add ili remove; i metadata.timestamp. Kod remove imena se izostavljaju. Meta nastavlja da šalje ove webhookove i posle uvoza kad god firma doda, izmeni ili ukloni kontakt u aplikaciji WhatsApp Business, pa vaš adresar ostaje usklađen sa telefonom.

Šta nose webhookovi istorije?

Polje history, sa nizom history u polju value. Svaka stavka sadrži metadata, sa phase, chunk_order i progress, i threads, po jedan za svakog kupca: id niti je broj kupca, a messages navodi taj razgovor jedan na jedan, dolazne i odlazne, pri čemu from pokazuje ko je poslao svaku poruku. Poruka nosi id, timestamp, type, sadržaj pod nazivom tipa i history_context.status, na primer READ ili DELIVERED. Grupni razgovori nisu uključeni.

A history webhook, as Meta sends it
{
  "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 zamenski sadržaj. Medijska poruka dolazi sa type media_placeholder, bez sadržaja i bez ID-ja medija. Meta zatim šalje posebne webhookove istorije sa ID-jevima medija, ali samo za medije poslate u roku od 14 dana od priključenja; te fajlove preuzmite od kompanije Meta koristeći token kupca. Stariji mediji ostaju zamenski sadržaj, pa ih prikažite kao prilog koji nije dostupan, umesto da ostavite prazninu u niti.

Kojim redom stižu delovi i kada je uvoz završen?

Ne nužno redom. Meta deli razgovore na tri faze, od najnovijih: faza 0 je dan pre priključenja, faza 1 seže do 90. dana, a faza 2 do 180. dana. Delovi mogu stići van redosleda, zato ih sortirajte po metadata.chunk_order. metadata.progress je procenat ukupne sinhronizacije, a 100 znači da je završena; sam broj faze ne govori da je neka faza završena.

Šta ako firma odbije da deli razgovore?

Tokom povezivanja aplikacija WhatsApp Business pita firmu da li želi da podeli istoriju razgovora. Odbijanje stiže kao webhook istorije bez poruka i sa nizom errors čiji je kod 2593109, naslova „History sync is turned off by the business from the WhatsApp Business App“. Kontakti i dalje stižu, a poruke uživo teku uobičajeno od trenutka kada se broj povezao.

Može li uvoz da se pokrene ponovo?

Ne na istoj vezi. Meta dozvoljava svaku sinhronizaciju jednom, u roku od 24 sata od priključenja, i ne može se ponoviti. Ponovno pokretanje zahteva da korisnik isključi broj i ponovo ga poveže, što se računa kao novo priključenje: ako je vaše odredište još sačuvano, easyCoexistence ponovo traži uvoz, pa zato deduplikujte po id-u svake poruke. Ovo važi i kada se broj vrati posle pravila od 14 dana.

Šta treba da bude spremno pre slanja linka za povezivanje?

Vaš endpoint, podignut i spreman da odgovara. Meta proverava URL svojim GET rukovanjem kada se odredište primeni, a uvoz se traži jednom, odmah posle toga. Ako rukovanje ne uspe, broj se i dalje povezuje, ali bez odredišta; last_error u sesiji objašnjava zašto, i ništa se ne uvozi dok ne ispravite endpoint i ne postavite ga pomoću PUT /connections/{id}/webhook u roku od 24 sata. Broj bez webhook_url uopšte ne dobija uvoz, jer se sadržaj poslat easyCoexistence odbacuje.

Kako da podesite

  1. 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.
  2. Create the connect sessionPOST /connect-sessions with webhook_url and webhook_verify_token, then send the customer the url it returns.
  3. Store contacts and chatsUpsert contacts from smb_app_state_sync, and insert history messages keyed on their id, sorted by chunk_order.
  4. Wait for progress 100Treat the import as finished when metadata.progress reaches 100, or as declined when a history webhook carries error 2593109.

Česte greške

  • Odbijanje velikih delova istorije. Payloadi koje šalje Meta mogu dostići 3 MB, dok Express podrazumevano parsira JSON samo do 100 KB, pa podignite limit, inače delovi propadaju i Meta ih ponovo šalje.
  • Obrada delova po redosledu dolaska. Mogu stići van redosleda, zato sortirajte po metadata.chunk_order i sačekajte progress 100 pre nego što uvoz označite kao završen.
  • Upisivanje istorije bez deduplikacije. Poruke uživo mogu se preklapati sa uvozom, a ponovno povezivanje ga pokreće ponovo, zato svaku poruku ključite po njenom id-u.
  • Slanje linka za povezivanje pre nego što endpoint odgovori na proveru koju šalje Meta. Odredište se tada ne primenjuje, pa ako ga ne postavite u roku od 24 sata, istorija broja se nikada ne uvozi.
Ovo radite uz EasyCoexistence

US$ 9 do US$ 0.75 po vezi mesečno, sa padom kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Koliko unazad seže uvoz istorije WhatsApp razgovora?

Do 180 dana pre nego što je broj priključen na Cloud API, i pokriva razgovore jedan na jedan u oba smera.

Da li se uvoze grupni razgovori?

Ne. Meta izostavlja poruke koje su deo grupnog razgovora.

Da li će stari WhatsApp razgovori kupca stići na moj webhook?

Da, do 180 dana razgovora jedan na jedan, poslatih jednom u roku od 24 sata od priključenja, ako firma u aplikaciji izabere da ih podeli.

Da li easyCoexistence čuva kopiju uvezenih razgovora?

Ne. Meta šalje istoriju direktno na vaš webhook_url, kao i poruke uživo, a ništa se ne čuva usput.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na