IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Jinsi ya kuingiza historia ya mazungumzo na anwani za programu ya WhatsApp Business kupitia API

Nambari ya programu ya WhatsApp Business iliyounganishwa kupitia Coexistence inaweza kutuma anwani zake zilizopo na mazungumzo ya hadi siku 180 ya mtu mmoja kwa mmoja kwa API mara moja, ndani ya saa 24 tangu usajili. Anwani hufika kama webhook za smb_app_state_sync na mazungumzo kama webhook za history, kwa vipande vilivyopangwa kwa metadata.chunk_order; metadata.progress ikifika 100 inaashiria kwamba uingizaji umekamilika. Biashara ndiyo huamua kwenye programu kama itashiriki mazungumzo.

easyCoexistence huunganisha nambari za programu ya WhatsApp Business za wateja wako kupitia Coexistence, na huiomba Meta anwani zao na historia ya mazungumzo mara tu webhook yako inapokuwa tayari, kwa hiyo historia inaenda moja kwa moja kwenye endpoint yako bila kuhifadhiwa njiani, na kila nambari inafuatiliwa saa 24 kwa siku, siku 7 kwa wiki.

180 days

Umbali wa nyuma ambao webhook za historia zinafikia, ukihesabiwa tangu biashara ilipounganishwa na Cloud API.

24 hours

Muda baada ya kuunganishwa ambao ndani yake anwani za biashara na historia yake ya ujumbe lazima zisawazishwe.

2593109

Msimbo wa hitilafu kwenye webhook ya historia wakati biashara imezima kushiriki historia kwenye programu ya WhatsApp Business.

Once

Mara ngapi kila usawazishaji unaweza kuendeshwa; kuurudia kunahitaji mteja aondoe muunganisho na kukamilisha Embedded Signup tena.

100

Thamani ya progress inayoashiria kwamba usawazishaji wa historia umekamilika.

Uingizaji unaanzaje?

Kwa kuwa na mahali pa kupokelea webhook kwenye nambari. Ikiunganishwa ukiwa tayari umeweka webhook_url kwenye kipindi cha muunganisho, au ukiiweka kwa PUT /connections/{id}/webhook ndani ya saa 24 tangu kuunganishwa, easyCoexistence huiomba Meta data mara moja: POST /{phone_number_id}/smb_app_data yenye sync_type smb_app_state_sync kwa anwani, kisha history kwa mazungumzo, mpangilio ambao Meta anaueleza. Kumbukumbu za matukio za nambari huandika history_sync_requested pamoja na thamani za request_id za Meta kwa msaada, au history_sync_failed pamoja na sababu.

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

Webhook za anwani zina nini?

Sehemu ya smb_app_state_sync, yenye safu ya state_sync kwenye value. Kila kipengee kina type contact; kitu cha anwani chenye full_name, first_name na phone_number; action ya add au remove; na metadata.timestamp. Majina huachwa kwenye remove. Meta huendelea kutuma webhook hizi baada ya uingizaji kila biashara inapoongeza, kuhariri au kuondoa anwani kwenye programu ya WhatsApp Business, ili kitabu chako cha anwani kiendane na simu.

Webhook za historia zina nini?

Sehemu ya history, yenye safu ya history kwenye value. Kila kipengee kina metadata, yenye phase, chunk_order na progress, na threads, moja kwa kila mteja: kitambulisho cha thread ni nambari ya mteja, na messages inaorodhesha mazungumzo hayo ya mtu mmoja kwa mmoja, yanayoingia na yanayotoka, huku from ikionyesha upande uliotuma kila ujumbe. Ujumbe una id, timestamp, type, maudhui yake chini ya jina la type, na history_context.status, kama READ au DELIVERED. Mazungumzo ya vikundi hayajumuishwi.

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

Ujumbe wa midia unaingizwaje?

Kwanza kama vishikilia nafasi. Ujumbe wa midia unakuja na type media_placeholder, bila maudhui na bila media ID. Kisha Meta hutuma webhook za historia tofauti zenye media ID, lakini kwa midia iliyotumwa ndani ya siku 14 tangu kuunganishwa pekee; pakua faili hizo kutoka Meta kwa token ya mteja. Midia ya zamani zaidi ya hapo hubaki kama kishikilia nafasi, kwa hiyo ionyeshe kama kiambatisho kisichopatikana badala ya kuacha pengo kwenye mazungumzo.

Vipande vinafika kwa mpangilio gani, na uingizaji unakamilika lini?

Si lazima yafike kwa mpangilio. Meta hugawanya mazungumzo katika awamu tatu, mapya kwanza: awamu 0 ni siku moja kabla ya kuunganishwa, awamu 1 inafika nyuma hadi siku 90 na awamu 2 hadi siku 180. Vipande vinaweza kufika nje ya mfuatano, kwa hiyo vipange kwa metadata.chunk_order. metadata.progress ni asilimia ya usawazishaji wote, na 100 inamaanisha umekamilika; nambari ya awamu peke yake haikuambii kwamba awamu imemalizika.

Je, biashara ikikataa kushiriki mazungumzo?

Wakati wa muunganisho, programu ya WhatsApp Business humuuliza biashara kama ishiriki historia yake ya mazungumzo. Kukataa hufika kama webhook ya historia isiyo na messages na safu ya errors ambayo code yake ni 2593109, yenye kichwa History sync is turned off by the business from the WhatsApp Business App. Anwani bado hufika, na ujumbe wa moja kwa moja hutiririka kama kawaida tangu wakati nambari ilipounganishwa.

Je, uingizaji unaweza kuendeshwa tena?

Si kwenye muunganisho uleule. Meta huruhusu kila usawazishaji mara moja, ndani ya saa 24 tangu kuunganishwa, na hauwezi kurudiwa. Kuuendesha tena kunahitaji mteja akatenganishe nambari na kuiunganisha tena, jambo linalohesabiwa kama kuunganishwa upya: mahali pako pa kupokelea pamehifadhiwa, kwa hiyo easyCoexistence huomba uingizaji tena, na ondoa marudio kwa kutumia id ya kila ujumbe. Hilo linajumuisha nambari inayorudi baada ya kanuni ya siku 14.

Nini kinapaswa kuwa tayari kabla ya kutuma kiungo cha muunganisho?

Endpoint yako, ikiwa hewani na inajibu. Meta hukagua URL kwa handshake yake ya GET wakati mahali pa kupokelea panapowekwa, na uingizaji huombwa mara moja, moja kwa moja baadaye. Handshake ikishindwa, nambari bado huunganishwa lakini bila mahali pa kupokelea, last_error ya kipindi inaeleza sababu, na hakuna kinachoingizwa isipokuwa urekebishe endpoint na kuiweka kwa PUT /connections/{id}/webhook ndani ya saa 24. Nambari isiyo na webhook_url haipati uingizaji kabisa, kwa sababu maudhui yanayotumwa kwa easyCoexistence hutupwa.

Jinsi ya kuisanidi

  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.

Makosa ya kawaida

  • Kukataa vipande vikubwa vya historia. Payload za Meta zinaweza kufikia 3 MB, lakini Express husoma JSON hadi 100 KB pekee kwa chaguo-msingi; kwa hiyo ongeza kikomo, vinginevyo vipande vinashindwa na Meta huendelea kuvijaribu tena.
  • Kuchakata vipande kwa mpangilio wa kufika. Vinaweza kufika nje ya mfuatano, kwa hiyo vipange kwa metadata.chunk_order na usubiri progress 100 kabla ya kuita uingizaji umekamilika.
  • Kuingiza historia bila kuondoa marudio. Ujumbe wa moja kwa moja unaweza kuingiliana na uingizaji, na muunganisho upya huuendesha tena, kwa hiyo weka kila ujumbe kwa id yake.
  • Kutuma kiungo cha muunganisho kabla endpoint haijajibu handshake ya Meta. Mahali pa kupokelea hapatumiki basi, na isipowekwa ndani ya saa 24, historia ya nambari haiingizwi kamwe.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka kadri unavyoongeza muunganisho, huku siku 3 za kwanza zikiwa bila malipo.

Maswali yanayoulizwa mara kwa mara

Historia ya mazungumzo ya WhatsApp inaingizwa nyuma kwa umbali gani?

Hadi siku 180 kabla ya nambari kuunganishwa na Cloud API, ikihusisha mazungumzo ya mtu mmoja kwa mmoja pande zote mbili.

Je, mazungumzo ya vikundi yanaingizwa?

Hapana. Meta huacha ujumbe unaokuwa sehemu ya mazungumzo ya kikundi.

Mazungumzo ya zamani ya WhatsApp ya mteja yatafika kwenye webhook yangu?

Ndiyo, hadi siku 180 za mazungumzo ya mtu mmoja kwa mmoja, yanayotumwa mara moja ndani ya saa 24 tangu kuunganishwa, ikiwa biashara itachagua kwenye programu kuyashiriki.

Je, easyCoexistence huhifadhi nakala ya mazungumzo yaliyoingizwa?

Hapana. Meta hutuma historia moja kwa moja kwenye webhook_url yako, kama ujumbe wa moja kwa moja, na hakuna kinachohifadhiwa njiani.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye