WhatsApp Business uygulamasının sohbet geçmişi ve kişileri API üzerinden nasıl içe aktarılır
Coexistence üzerinden bağlanan bir WhatsApp Business uygulama numarası, mevcut kişilerini ve birebir sohbetlerinin 180 güne kadarını, kurulumdan sonraki 24 saat içinde API'ye bir kez gönderebilir. Kişiler smb_app_state_sync webhook'ları olarak, sohbetler ise history webhook'ları olarak, metadata.chunk_order alanına göre sıralanmış parçalar halinde gelir; metadata.progress değeri 100 olduğunda içe aktarma tamamlanmış olur. Sohbetlerin paylaşılıp paylaşılmayacağına işletme uygulamada kendisi karar verir.
easyCoexistence, müşterilerinizin WhatsApp Business uygulama numaralarını Coexistence üzerinden bağlar ve webhook'unuz hazır olur olmaz Meta'dan kişilerini ve sohbet geçmişlerini ister; böylece geçmiş, aradaki hiçbir yerde saklanmadan doğrudan uç noktanıza ulaşır ve her numara 7/24 izlenir.
History webhook'larının ne kadar geriye gittiği, işletmenin Cloud API'ye kaydedildiği andan itibaren sayılır.
İşletmenin kişilerinin ve mesaj geçmişinin eşitlenmesi gereken, kurulumdan sonraki süre.
İşletme WhatsApp Business uygulamasında geçmiş paylaşımını kapattığında history webhook'unda görülen hata kodu.
Her eşitlemenin ne sıklıkla çalışabileceği; tekrarlamak için müşterinin bağlantıyı kesip Embedded Signup'ı yeniden tamamlaması gerekir.
Geçmiş eşitlemesinin tamamlandığını gösteren ilerleme değeri.
İçe aktarma nasıl başlar?
Numarada bir webhook hedefi bulunduğunda başlar. webhook_url bağlantı oturumunda zaten ayarlıysa veya bağlandıktan sonraki 24 saat içinde PUT /connections/{id}/webhook ile bir hedef belirlenirse easyCoexistence, veriyi Meta'dan bir kez ister: önce kişiler için sync_type smb_app_state_sync ile POST /{phone_number_id}/smb_app_data, ardından sohbetler için history, Meta'nın belgelediği sırayla. Numaranın olay günlüğüne, destek için Meta'nın request_id değerleriyle birlikte history_sync_requested kaydı, ya da neden bilgisiyle birlikte history_sync_failed kaydı düşer.
Kişi webhook'ları neleri taşır?
Alan smb_app_state_sync, değerinde bir state_sync dizisiyle gelir. Her öğe type olarak contact taşır; full_name, first_name ve phone_number alanlarına sahip bir contact nesnesi, add ya da remove eylemi ve metadata.timestamp bulunur. Silme işleminde adlar gönderilmez. İşletme WhatsApp Business uygulamasında bir kişi eklediğinde, düzenlediğinde ya da ssildiğinde Meta, içe aktarmadan sonra da bu webhook'ları göndermeye devam eder; böylece adres defteriniz telefonla uyumlu kalır.
Geçmiş webhook'ları neleri taşır?
Alan history, değerinde bir history dizisiyle gelir. Her öğe phase, chunk_order ve progress alanlarını içeren metadata ile müşteri başına bir tane olmak üzere threads taşır: thread kimliği müşterinin numarasıdır ve messages, bu birebir sohbeti listeler. Gelen ve giden mesajların her biri, hangi tarafın gönderdiğini from alanıyla belirtir. Her mesaj id, timestamp, type, içeriği türün adı altında ve READ ya da DELIVERED gibi history_context.status değerini taşır. Grup sohbetleri dahil değildir.
{
"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" }
}
]
}
]
}
]
}
}
]
}
]
}Medya mesajları nasıl içe aktarılır?
Önce yer tutucu olarak. Medya mesajı, type değeri media_placeholder olarak, içerik ve medya kimliği olmadan gelir. Meta daha sonra medya kimliklerini taşıyan ayrı history webhook'ları gönderir, ancak bu yalnızca kurulum tarihinden itibaren 14 gün içinde gönderilen medyalar için geçerlidir; bu dosyaları müşterinin token'ıyla Meta'dan çekin. Bu süreden eski medya yer tutucu olarak kalır; bu yüzden sohbette boşluk bırakmak yerine onu kullanılamayan bir ek olarak gösterin.
Parçalar hangi sırayla gelir ve içe aktarma ne zaman biter?
Mutlaka sırayla gelmezler. Meta sohbetleri en yeniden eskiye doğru üç aşamaya böler: aşama 0 kurulumdan önceki gündür, aşama 1 90. güne, aşama 2 ise 180. güne kadar uzanır. Parçalar sıra dışı gelebilir, bu yüzden metadata.chunk_order alanına göre sıralayın. metadata.progress, eşitlemenin tamamının yüzdesidir ve 100 tamamlandı demektir; yalnızca aşama numarası, bir aşamanın bittiğini göstermez.
İşletme sohbetleri paylaşmayı reddederse ne olur?
Bağlantı sırasında WhatsApp Business uygulaması işletmeye sohbet geçmişini paylaşıp paylaşmayacağını sorar. Reddetmek, mesaj içermeyen ve errors dizisinde kodu 2593109 olan bir history webhook'u olarak gelir; başlığı şöyledir: History sync is turned off by the business from the WhatsApp Business App. Kişiler yine gelir ve numara bağlandığı andan itibaren canlı mesajlar normal şekilde akmaya devam eder.
İçe aktarma yeniden çalıştırılabilir mi?
Aynı bağlantı üzerinde çalıştırılamaz. Meta her eşitlemeye kurulumdan itibaren 24 saat içinde yalnızca bir kez izin verir ve tekrar oynatılamaz. Yeniden çalıştırmak için müşterinin numarasının bağlantısını kesip yeniden bağlaması gerekir; bu yeni bir kurulum sayılır. Hedefiniz hâlâ kayıtlıyken easyCoexistence içe aktarmayı yeniden ister, bu yüzden her mesajı id değerine göre tekilleştirin. Bu durum, 14 günlük kuralın ardından geri dönen bir numara için de geçerlidir.
Bağlantı linkini göndermeden önce hazır olması gerekenler nelerdir?
Uç noktanız çalışır durumda ve yanıt verir halde olmalı. Meta, hedef uygulandığında URL'yi GET el sıkışmasıyla kontrol eder ve içe aktarma hemen ardından bir kez istenir. El sıkışma başarısız olursa numara yine bağlanır ancak hedefsiz kalır, oturumun last_error alanı nedenini açıklar ve uç noktayı düzeltip 24 saat içinde PUT /connections/{id}/webhook ile ayarlamadığınız sürece hiçbir şey içe aktarılmaz. webhook_url'si olmayan bir numara hiç içe aktarma almaz, çünkü easyCoexistence'a gönderilen içerik bırakılır.
Nasıl kurulur
- 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.
Yaygın hatalar
- Büyük geçmiş parçalarını reddetmek. Meta'nın payload'ları 3 MB'a kadar çıkabilir, Express ise JSON'u varsayılan olarak yalnızca 100 KB'a kadar ayrıştırır; bu yüzden sınırı yükseltin, yoksa parçalar başarısız olur ve Meta bunları yeniden denemeye devam eder.
- Parçaları geliş sırasına göre işlemek. Sıra dışı gelebilirler, bu yüzden metadata.chunk_order alanına göre sıralayın ve içe aktarmayı tamamlandı saymadan önce progress değerinin 100 olmasını bekleyin.
- Tekilleştirmeden geçmişi eklemek. Canlı mesajlar içe aktarmayla çakışabilir ve yeniden bağlanma içe aktarmayı tekrar çalıştırır, bu yüzden her mesajı id değerine göre tekilleştirin.
- Uç nokta Meta'nın el sıkışmasına yanıt vermeden bağlantı linkini göndermek. Hedef o zaman uygulanmaz ve 24 saat içinde ayarlamazsanız numaranın geçmişi hiç içe aktarılmaz.
Bağlantı başına aylık US$ 9'dan başlayıp bağlantı ekledikçe US$ 0.75'e kadar düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
WhatsApp sohbet geçmişi içe aktarması ne kadar geriye gider?
Numara Cloud API'ye kaydedilmeden önceki 180 güne kadar; birebir sohbetleri her iki yönde kapsar.
Grup sohbetleri içe aktarılıyor mu?
Hayır. Meta, grup sohbetinin parçası olan mesajları dışarıda bırakır.
Müşterinin eski WhatsApp sohbetleri webhook'uma ulaşır mı?
Evet, işletme uygulamada paylaşmayı seçerse, kurulumdan sonraki 24 saat içinde bir kez gönderilen, 180 güne kadar birebir sohbetler.
easyCoexistence içe aktarılan sohbetlerin bir kopyasını tutuyor mu?
Hayır. Meta geçmişi, canlı mesajlar gibi doğrudan webhook_url adresinize gönderir ve aradaki hiçbir yerde saklanmaz.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi