Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Kuinka WhatsApp Business -sovelluksen chat-historia ja yhteystiedot tuodaan API:n kautta

WhatsApp Business -sovelluksen numero, joka on yhdistetty Coexistencen kautta, voi lähettää olemassa olevat yhteystietonsa ja enintään 180 päivän yksi-yhteen-chatit API:hin kerran, 24 tunnin sisällä käyttöönotosta. Yhteystiedot tulevat smb_app_state_sync-webhookeina ja chatit history-webhookeina, osina järjestettynä metadata.chunk_orderin mukaan. Kun metadata.progress on 100, tuonti on valmis. Yritys päättää sovelluksessa, jaetaanko chatit.

easyCoexistence yhdistää asiakkaidesi WhatsApp Business -sovellusnumerot Coexistencen kautta ja pyytää Metalta niiden yhteystiedot ja chat-historian heti, kun webhookisi on paikallaan.

180 days

Kuinka pitkälle historia-webhookit ulottuvat, laskettuna siitä, kun yritys otettiin Cloud API:in käyttöön.

24 hours

Aika käyttöönotosta, jonka kuluessa yrityksen yhteystiedot ja viestihistoria on synkronoitava.

2593109

Virhekoodi historia-webhookissa, kun yritys on kytkenyt historian jakamisen pois päältä WhatsApp Business -sovelluksessa.

Once

Kuinka usein kukin synkronointi voidaan ajaa; sen toistaminen vaatii, että asiakas irrottaa numeron ja suorittaa Embedded Signupin uudelleen.

100

Edistymisarvo, joka merkitsee historian synkronoinnin valmiiksi.

Miten tuonti alkaa?

Numeron webhook-kohteella. Kun numero yhdistyy niin, että webhook_url on jo asetettu yhteysistunnossa, tai kun asetat sen PUT /connections/{id}/webhook -kutsulla 24 tunnin sisällä yhdistämisestä, easyCoexistence pyytää datan Metalta kerran: POST /{phone_number_id}/smb_app_data, jossa sync_type on smb_app_state_sync yhteystiedoille ja sen jälkeen history chateille, Metan dokumentoimassa järjestyksessä. Numeron tapahtumalokiin kirjautuu history_sync_requested Metan request_id-arvoineen tukea varten, tai history_sync_failed syineen.

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

Mitä yhteystiedoista kertovat webhookit sisältävät?

Kenttä smb_app_state_sync, jonka value-kohdassa on state_sync-taulukko. Jokaisella kohteella on tyyppi contact; contact-objekti, jossa full_name, first_name ja phone_number; toiminto add tai remove; sekä metadata.timestamp. Nimet jätetään pois remove-tapauksessa. Meta lähettää näitä webhookeja tuonnin jälkeenkin aina, kun yritys lisää, muokkaa tai poistaa yhteystiedon WhatsApp Business -sovelluksessa, joten osoitekirjasi pysyy puhelimen kanssa samassa tilassa.

Mitä historia-webhookit sisältävät?

Kenttä history, jonka value-kohdassa on history-taulukko. Jokaisessa kohteessa on metadata, jossa ovat kentät phase, chunk_order ja progress, sekä threads, yksi asiakasta kohden: säikeen id on asiakkaan numero, ja messages luettelee tuon yksi-yhteen-keskustelun saapuneet ja lähteneet viestit. Kenttä from kertoo, kumpi osapuoli lähetti kunkin. Viesti sisältää kentät id, timestamp ja type sekä sisällön tyypin nimen alla, ja history_context.status-kentän, kuten READ tai DELIVERED. Ryhmäkeskusteluja ei sisällytetä.

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" }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  ]
}

Miten mediaviestit tuodaan?

Ensin paikanvaraajina. Mediaviesti tulee tyypillä media_placeholder, ilman sisältöä ja ilman media-ID:tä. Meta lähettää sen jälkeen erilliset history-webhookit, joissa on media-ID:t, mutta vain käyttöönottoa edeltäneiden 14 päivän aikana lähetetyille mediatiedostoille. Hae nämä tiedostot Metalta asiakkaan tokenilla. Sitä vanhempi media jää paikanvaraajaksi, joten näytä se liitteenä, jota ei ole saatavilla, sen sijaan että jättäisit aukon keskusteluun.

Missä järjestyksessä osat saapuvat ja milloin tuonti on valmis?

Ei välttämättä järjestyksessä. Meta jakaa chatit kolmeen vaiheeseen, uusimmasta alkaen: vaihe 0 on päivä ennen käyttöönottoa, vaihe 1 ulottuu takaisin päivään 90 ja vaihe 2 päivään 180. Osat voivat saapua väärässä järjestyksessä, joten lajittele ne metadata.chunk_orderin mukaan. metadata.progress on koko synkronoinnin prosenttiosuus, ja 100 tarkoittaa, että se on valmis. Pelkkä vaihenumero ei kerro, että vaihe on päättynyt.

Mitä jos yritys kieltäytyy jakamasta chatteja?

Yhteyden aikana WhatsApp Business -sovellus kysyy yritykseltä, jaetaanko sen chat-historia. Kieltäytyminen saapuu history-webhookina ilman viestejä ja errors-taulukolla, jonka code on 2593109 ja otsikkona ”History sync is turned off by the business from the WhatsApp Business App”. Yhteystiedot saapuvat silti, ja reaaliaikaiset viestit kulkevat normaalisti heti, kun numero on yhdistetty.

Voiko tuonnin ajaa uudelleen?

Ei samassa yhteydessä. Meta sallii kunkin synkronoinnin kerran, 24 tunnin sisällä käyttöönotosta, eikä sitä voi toistaa. Uusintaan tarvitaan, että asiakas irrottaa numeron ja yhdistää sen uudelleen, mikä lasketaan uudeksi käyttöönotoksi. Kun kohde on yhä tallessa, easyCoexistence pyytää tuontia uudelleen, joten poista päällekkäisyydet kunkin viestin id:n perusteella. Sama koskee numeroa, joka palaa 14 päivän säännön jälkeen.

Mitä pitää olla valmiina ennen yhteyslinkin lähettämistä?

Päätepiste, pystyssä ja vastaamassa. Meta tarkistaa URL:n GET-kättelyllä, kun kohde otetaan käyttöön, ja tuonti pyydetään kerran heti sen jälkeen. Jos kättely epäonnistuu, numero yhdistyy silti ilman kohdetta, session last_error selittää syyn, eikä mitään tuoda, ellet korjaa päätepistettä ja aseta sitä PUT /connections/{id}/webhook -kutsulla 24 tunnin sisällä. Numero ilman webhook_url-kenttää ei saa tuontia lainkaan, koska easyCoexistenceen lähetettävä sisältö hylätään.

Näin otat sen käyttöön

  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.

Yleiset virheet

  • Suurten historiaosien hylkääminen. Metan payloadit voivat olla jopa 3 MB, kun Express jäsentää JSON:n oletusarvoisesti vain 100 KB asti. Nosta siis rajaa, muuten osat epäonnistuvat ja Meta yrittää niitä uudelleen.
  • Osien käsittely saapumisjärjestyksessä. Ne voivat saapua väärässä järjestyksessä, joten lajittele ne metadata.chunk_orderin mukaan ja odota progress-arvoa 100 ennen kuin merkitset tuonnin valmiiksi.
  • Historian lisääminen ilman päällekkäisyyksien poistoa. Reaaliaikaiset viestit voivat mennä päällekkäin tuonnin kanssa, ja yhteyden uudelleenmuodostus ajaa tuonnin uudelleen, joten avaa jokainen viesti sen id:n perusteella.
  • Yhteyslinkin lähettäminen ennen kuin päätepiste vastaa Metan kättelyyn. Kohdetta ei silloin oteta käyttöön, eikä numeron historiaa tuoda koskaan, ellet aseta sitä 24 tunnin sisällä.
Näin teet tämän EasyCoexistencen avulla

Historia menee suoraan päätepisteellesi ilman välivarastointia, ja jokaista numeroa valvotaan 24/7. Hinta on US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, ja se laskee yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Kuinka pitkälle WhatsApp-chat-historian tuonti ulottuu?

Enintään 180 päivää ennen kuin numero otettiin käyttöön Cloud API:in, ja se kattaa yksi-yhteen-chatit molempiin suuntiin.

Tuodaanko ryhmäkeskustelut?

Ei. Meta jättää pois ryhmäkeskusteluun kuuluvat viestit.

Päätyvätkö asiakkaan vanhat WhatsApp-chatit webhookiini?

Kyllä, enintään 180 päivän yksi-yhteen-chatit, jotka lähetetään kerran 24 tunnin sisällä käyttöönotosta, jos yritys valitsee sovelluksessa jakaa ne.

Tallentaako easyCoexistence kopion tuoduista chateista?

Ei. Meta lähettää historian suoraan webhook_url-osoitteeseesi kuten reaaliaikaisetkin viestit, eikä mitään tallenneta välissä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu