Paano i-import ang chat history at contacts ng WhatsApp Business app sa pamamagitan ng API
Ang WhatsApp Business app number na naka-connect sa pamamagitan ng Coexistence ay maaaring magpadala ng umiiral nitong contacts at hanggang 180 araw ng one-to-one chats sa API nang isang beses, sa loob ng 24 oras mula onboarding. Ang contacts ay dumarating bilang smb_app_state_sync webhooks at ang chats bilang history webhooks, sa mga chunk na inayos ayon sa metadata.chunk_order; ang metadata.progress na 100 ay nagmamarka ng kumpletong import. Ang negosyo ang pumipili sa app kung ibabahagi ang chats.
Ikinokonekta ng easyCoexistence ang WhatsApp Business app numbers ng inyong mga customer gamit ang Coexistence at hinihiling sa Meta ang kanilang contacts at chat history sa sandaling nakalagay na ang inyong webhook, kaya diretso sa inyong endpoint ang history nang walang naiimbak sa daan, at bawat number ay minomonitor 24/7.
Gaano kalayo nakakarating ang history webhooks, binibilang mula nang i-onboard ang negosyo sa Cloud API.
Oras pagkatapos ng onboarding kung kailan dapat na-synchronize ang contacts at message history ng negosyo.
Error code sa history webhook kapag pinatay ng negosyo ang pagbabahagi ng history sa WhatsApp Business app.
Gaano kadalas maaaring tumakbo ang bawat sync; para maulit ito, kailangang mag-offboard ang customer at kumpletuhin muli ang Embedded Signup.
Ang progress value na nagmamarka na kumpleto na ang history synchronization.
Paano nagsisimula ang import?
Sa pamamagitan ng webhook destination sa number. Kapag kumonekta ito na may webhook_url na nakatakda na sa connect session, o kapag nagtakda kayo nito gamit ang PUT /connections/{id}/webhook sa loob ng 24 oras mula pagkakakonekta, hihilingin ng easyCoexistence sa Meta ang data nang isang beses: POST /{phone_number_id}/smb_app_data na may sync_type smb_app_state_sync para sa contacts, at pagkatapos history para sa chats, ang pagkakasunod-sunod na nakadokumento ng Meta. Itinatala ng event log ng number ang history_sync_requested kasama ang request_id values ng Meta para sa suporta, o history_sync_failed kasama ang dahilan.
Ano ang laman ng contact webhooks?
Field smb_app_state_sync, na may state_sync array sa value. Bawat item ay may type na contact; contact object na may full_name, first_name at phone_number; action na add o remove; at metadata.timestamp. Wala ang pangalan sa remove. Patuloy na nagpapadala ang Meta ng mga webhook na ito pagkatapos ng import tuwing magdaragdag, mag-e-edit o magtatanggal ng contact ang negosyo sa WhatsApp Business app, kaya nananatiling kasabay ng telepono ang inyong address book.
Ano ang laman ng history webhooks?
Field history, na may history array sa value. Bawat item ay may metadata, na may phase, chunk_order at progress, at threads, isa para sa bawat customer: ang thread id ay numero ng customer, at nakalista sa messages ang one-to-one na usapan, papasok at palabas, kung saan sinasabi ng from kung sino ang nagpadala. Ang bawat mensahe ay may id, timestamp, type, laman nito sa ilalim ng pangalan ng type, at history_context.status, gaya ng READ o DELIVERED. Hindi kasama ang group chats.
{
"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" }
}
]
}
]
}
]
}
}
]
}
]
}Paano iniimport ang media na mensahe?
Bilang placeholder muna. Ang media message ay dumarating na may type na media_placeholder, walang content at walang media ID. Pagkatapos, magpapadala ang Meta ng hiwalay na history webhooks na may media ID, pero para lang sa media na ipinadala sa loob ng 14 na araw mula onboarding; kunin ang mga file na iyon mula sa Meta gamit ang token ng customer. Ang media na mas matanda kaysa roon ay mananatiling placeholder, kaya ipakita ito bilang attachment na hindi available sa halip na iwanang blangko ang thread.
Anong pagkakasunod-sunod dumarating ang chunks, at kailan tapos ang import?
Hindi laging sunud-sunod. Hinahati ng Meta ang chats sa tatlong phase, mula pinakabago: phase 0 ang araw bago ang onboarding, umaabot ang phase 1 hanggang day 90 at ang phase 2 hanggang day 180. Maaaring dumating nang wala sa ayos ang chunks, kaya ayusin ang mga ito ayon sa metadata.chunk_order. Ang metadata.progress ay porsyento ng buong sync, at ang 100 ay nangangahulugang kumpleto na; hindi sapat ang numero ng phase para malaman na tapos na ang isang phase.
Paano kung tumanggi ang negosyo na ibahagi ang chats?
Habang nagko-connect, tinatanong ng WhatsApp Business app ang negosyo kung ibabahagi ang chat history nito. Kapag tumanggi, dumarating ito bilang history webhook na walang messages at may errors array na code na 2593109, na may titulong History sync is turned off by the business from the WhatsApp Business App. Dumarating pa rin ang contacts, at tuloy-tuloy ang live messages mula sa sandaling naka-connect ang number.
Puwede bang ulitin ang import?
Hindi sa parehong koneksyon. Pinapayagan ng Meta ang bawat sync nang isang beses, sa loob ng 24 oras mula onboarding, at hindi ito puwedeng i-replay. Para ulitin ito, kailangang i-disconnect ng customer ang number at i-connect muli, na binibilang na bagong onboarding: kapag nakatala pa rin ang inyong destination, hihilingin ulit ng easyCoexistence ang import, kaya i-deduplicate gamit ang id ng bawat mensahe. Kasama rito ang number na bumabalik pagkatapos ng 14-na-araw na patakaran.
Ano ang dapat handa bago ninyo ipadala ang connect link?
Ang inyong endpoint, aktibo at sumasagot. Sinusuri ng Meta ang URL gamit ang GET handshake nito kapag inilapat ang destination, at isang beses lang hihilingin ang import, agad pagkatapos noon. Kapag pumalya ang handshake, mako-connect pa rin ang number pero walang destination, ipapaliwanag ng last_error ng session kung bakit, at walang maiimport maliban kung ayusin ninyo ang endpoint at itakda ito gamit ang PUT /connections/{id}/webhook sa loob ng 24 oras. Ang number na walang webhook_url ay walang import, dahil ang content na ipinadala sa easyCoexistence ay natatapon.
Paano ito i-set up
- 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.
Mga karaniwang pagkakamali
- Pagtanggi sa malalaking history chunks. Ang payload ng Meta ay maaaring umabot sa 3 MB, habang ang Express ay nagpa-parse lang ng JSON hanggang 100 KB bilang default, kaya itaas ang limit o papalya ang chunks at paulit-ulit itong susubukan ng Meta.
- Pagproseso ng chunks ayon sa pagdating. Maaaring dumating nang wala sa ayos, kaya i-sort ayon sa metadata.chunk_order at hintayin ang progress 100 bago ituring na kumpleto ang import.
- Pag-insert ng history nang walang deduplication. Maaaring mag-overlap ang live messages sa import at uulitin ng reconnection ang pagpapatakbo nito, kaya i-key ang bawat mensahe sa id nito.
- Pagpapadala ng connect link bago sumagot ang endpoint sa handshake ng Meta. Hindi malalapat ang destination, at kung hindi ninyo ito itatakda sa loob ng 24 oras, hindi na kailanman maiimport ang history ng number.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Gaano kalayo ang inaabot ng import ng WhatsApp chat history?
Hanggang 180 araw bago na-onboard ang number sa Cloud API, sakop ang one-to-one chats sa parehong direksyon.
Iniimport ba ang group chats?
Hindi. Hindi isinasama ng Meta ang mga mensaheng bahagi ng group chat.
Makakarating ba sa webhook ko ang lumang WhatsApp chats ng customer?
Oo, hanggang 180 araw ng one-to-one chats, ipinapadala nang isang beses sa loob ng 24 oras mula onboarding, kung pipiliin ng negosyo sa app na ibahagi ang mga ito.
Nagtatago ba ng kopya ng mga na-import na chats ang easyCoexistence?
Hindi. Diretsong ipinapadala ng Meta ang history sa inyong webhook_url, tulad ng live messages, at walang naiimbak sa daan.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong