লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

API-এর মাধ্যমে WhatsApp Business অ্যাপের চ্যাট ইতিহাস ও কন্টাক্ট ইমপোর্ট করার উপায়

Coexistence-এর মাধ্যমে সংযুক্ত একটি WhatsApp Business অ্যাপ নম্বর তার বিদ্যমান কন্টাক্ট এবং অনধিক 180 দিনের এক-থেকে-এক চ্যাট অনবোর্ডিংয়ের 24 ঘণ্টার মধ্যে একবার API-তে পাঠাতে পারে। কন্টাক্ট আসে smb_app_state_sync ওয়েবহুক হিসেবে, আর চ্যাট আসে হিস্ট্রি ওয়েবহুকে, যেগুলো metadata.chunk_order অনুসারে সাজানো চাঙ্কে আসে; metadata.progress 100 হলে ইমপোর্ট সম্পূর্ণ হয়েছে বোঝায়। অ্যাপের ভেতরে ব্যবসা নিজে ঠিক করে চ্যাট শেয়ার করবে কি না।

easyCoexistence Coexistence-এর মাধ্যমে আপনার গ্রাহকদের WhatsApp Business অ্যাপ নম্বর সংযুক্ত করে, আর আপনার ওয়েবহুক প্রস্তুত হওয়া মাত্র তাদের কন্টাক্ট ও চ্যাট ইতিহাস চায়।

180 days

হিস্ট্রি ওয়েবহুক কতদূর পর্যন্ত যায়, ব্যবসাটি Cloud API-তে অনবোর্ড হওয়ার সময় থেকে গণনা করে।

24 hours

অনবোর্ডিংয়ের পর কত সময়ের মধ্যে ব্যবসার কন্টাক্ট ও মেসেজ ইতিহাস সিঙ্ক্রোনাইজ করতে হবে।

2593109

ব্যবসা WhatsApp Business অ্যাপে ইতিহাস শেয়ারিং বন্ধ করলে হিস্ট্রি ওয়েবহুকে যে ত্রুটি কোড আসে।

Once

প্রতিটি সিঙ্ক কত ঘন ঘন চলতে পারে; পুনরাবৃত্তির জন্য গ্রাহককে অফবোর্ড করে Embedded Signup আবার সম্পন্ন করতে হবে।

100

কোন প্রগ্রেস মানে হিস্ট্রি সিঙ্ক্রোনাইজেশন সম্পূর্ণ হয়েছে।

ইমপোর্ট কীভাবে শুরু হয়?

নম্বরে একটি ওয়েবহুক গন্তব্য থাকা দিয়ে। সংযোগ সেশনে webhook_url আগে থেকে সেট থাকলে অথবা সংযোগের 24 ঘণ্টার মধ্যে PUT /connections/{id}/webhook দিয়ে সেট করলে, easyCoexistence Meta-র কাছে ডেটা একবার চায়: POST /{phone_number_id}/smb_app_data, কন্টাক্টের জন্য sync_type smb_app_state_sync, তারপর চ্যাটের জন্য history, যে ক্রম Meta নথিভুক্ত করেছে। নম্বরের ইভেন্ট লগে সাপোর্টের জন্য Meta-র request_id মানসহ history_sync_requested লেখা হয়, ব্যর্থ হলে কারণসহ history_sync_failed।

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

কন্টাক্ট ওয়েবহুকে কী থাকে?

ফিল্ড smb_app_state_sync, যার value-তে একটি state_sync অ্যারে থাকে। প্রতিটি আইটেমে type contact থাকে; একটি কন্টাক্ট অবজেক্ট, যেখানে full_name, first_name ও phone_number; একটি action, add বা remove; এবং metadata.timestamp। remove-এ নাম বাদ দেওয়া হয়। ব্যবসা WhatsApp Business অ্যাপে কোনো কন্টাক্ট যোগ, সম্পাদনা বা মুছলে ইমপোর্টের পরেও Meta এই ওয়েবহুক পাঠাতে থাকে, যাতে আপনার ঠিকানার বই ফোনের সঙ্গে মিলে থাকে।

হিস্ট্রি ওয়েবহুকে কী থাকে?

ফিল্ড history, যার value-তে একটি history অ্যারে থাকে। প্রতিটি আইটেমে metadata থাকে, যেখানে phase, chunk_order ও progress আছে, এবং threads, প্রতি গ্রাহকের জন্য একটি করে: thread id হলো গ্রাহকের নম্বর, আর messages সেই এক-থেকে-এক কথোপকথনের তালিকা, আসা ও যাওয়া দুটোই, যেখানে from বলে কোন পক্ষ কোনটি পাঠিয়েছে। প্রতিটি মেসেজে থাকে id, timestamp, type, টাইপের নামের অধীনে তার কন্টেন্ট, এবং history_context.status, যেমন READ বা DELIVERED। গ্রুপ চ্যাট অন্তর্ভুক্ত নয়।

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

মিডিয়া মেসেজ কীভাবে ইমপোর্ট হয়?

প্রথমে প্লেসহোল্ডার হিসেবে। মিডিয়া মেসেজ আসে type media_placeholder নিয়ে, কোনো কন্টেন্ট ও কোনো মিডিয়া ID ছাড়া। পরে Meta আলাদা হিস্ট্রি ওয়েবহুকে মিডিয়া ID পাঠায়, তবে কেবল অনবোর্ডিংয়ের 14 দিনের মধ্যে পাঠানো মিডিয়ার জন্য; সেই ফাইলগুলো গ্রাহকের টোকেন দিয়ে Meta থেকে আনুন। এর চেয়ে পুরোনো মিডিয়া প্লেসহোল্ডারই থেকে যায়, তাই থ্রেডে ফাঁকা জায়গা না রেখে এটিকে অনুপলব্ধ একটি অ্যাটাচমেন্ট হিসেবে দেখান।

চাঙ্কগুলো কোন ক্রমে আসে, আর ইমপোর্ট কখন শেষ হয়?

ক্রম অনুযায়ী আসার নিশ্চয়তা নেই। Meta চ্যাটগুলোকে তিন ফেজে ভাগ করে, নতুন থেকে পুরোনো: ফেজ 0 হলো অনবোর্ডিংয়ের আগের দিন, ফেজ 1 পৌঁছায় 90 দিন পর্যন্ত এবং ফেজ 2 180 দিন পর্যন্ত। চাঙ্ক ক্রমের বাইরে আসতে পারে, তাই metadata.chunk_order অনুসারে সাজান। metadata.progress পুরো সিঙ্কের শতাংশ, আর 100 মানে সম্পূর্ণ; শুধু ফেজ নম্বর দেখে বোঝা যায় না যে একটি ফেজ শেষ হয়েছে।

ব্যবসা চ্যাট শেয়ার করতে না চাইলে কী হয়?

সংযোগের সময় WhatsApp Business অ্যাপ ব্যবসাকে জিজ্ঞেস করে সে তার চ্যাট ইতিহাস শেয়ার করবে কি না। প্রত্যাখ্যান করলে একটি হিস্ট্রি ওয়েবহুক আসে, যাতে কোনো messages থাকে না এবং একটি errors অ্যারে থাকে যার code 2593109, শিরোনাম "History sync is turned off by the business from the WhatsApp Business App"। কন্টাক্ট তবুও আসে, আর নম্বর সংযুক্ত হওয়ার মুহূর্ত থেকে লাইভ মেসেজ স্বাভাবিকভাবে আসতে থাকে।

ইমপোর্ট কি আবার চালানো যায়?

একই সংযোগে নয়। Meta প্রতিটি সিঙ্ক একবার, অনবোর্ডিংয়ের 24 ঘণ্টার মধ্যে অনুমতি দেয়, এবং তা পুনরায় চালানো যায় না। আবার চালাতে হলে গ্রাহককে নম্বর ডিসকানেক্ট করে আবার সংযুক্ত করতে হবে, যা একটি নতুন অনবোর্ডিং হিসেবে গণ্য হয়: আপনার গন্তব্য সংরক্ষিত থাকলে easyCoexistence আবার ইমপোর্ট চায়, তাই প্রতিটি মেসেজের id দিয়ে ডুপ্লিকেট বাদ দিন। 14 দিনের নিয়মের পরে ফিরে আসা নম্বরও এর মধ্যে পড়ে।

কানেক্ট লিংক পাঠানোর আগে কী প্রস্তুত থাকতে হবে?

আপনার এন্ডপয়েন্ট, চালু থাকা ও উত্তর দিচ্ছে এমন। গন্তব্য প্রয়োগের সময় Meta URL-টি তার GET হ্যান্ডশেক দিয়ে যাচাই করে, আর ইমপোর্ট অনুরোধ করা হয় একবার, সঙ্গে সঙ্গে পরেই। হ্যান্ডশেক ব্যর্থ হলে নম্বরটি সংযুক্ত হয় তবে গন্তব্য ছাড়া, সেশনের last_error কারণ জানায়, এবং 24 ঘণ্টার মধ্যে এন্ডপয়েন্ট ঠিক করে PUT /connections/{id}/webhook দিয়ে সেট না করলে কিছুই ইমপোর্ট হয় না। webhook_url ছাড়া নম্বর কোনো ইমপোর্টই পায় না, কারণ easyCoexistence-এ পাঠানো কন্টেন্ট বাদ পড়ে যায়।

কীভাবে সেট আপ করবেন

  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.

সাধারণ ভুলগুলো

  • বড় হিস্ট্রি চাঙ্ক প্রত্যাখ্যান। Meta-র পেলোড 3 MB পর্যন্ত হতে পারে, অথচ Express ডিফল্টভাবে JSON পার্স করে শুধু 100 KB পর্যন্ত, তাই সীমা বাড়ান; নইলে চাঙ্ক ব্যর্থ হয় এবং Meta বারবার চেষ্টা করতে থাকে।
  • চাঙ্ক আসার ক্রমে প্রক্রিয়া করা। সেগুলো ক্রমের বাইরে আসতে পারে, তাই metadata.chunk_order অনুসারে সাজান এবং ইমপোর্ট সম্পূর্ণ বলার আগে progress 100 পর্যন্ত অপেক্ষা করুন।
  • ডুপ্লিকেট না সরিয়ে ইতিহাস ঢোকানো। লাইভ মেসেজ ইমপোর্টের সঙ্গে ওভারল্যাপ করতে পারে, এবং পুনঃসংযোগে ইমপোর্ট আবার চলে, তাই প্রতিটি মেসেজ তার id দিয়ে চিহ্নিত করুন।
  • এন্ডপয়েন্ট Meta-র হ্যান্ডশেকে উত্তর দেওয়ার আগে কানেক্ট লিংক পাঠানো। তখন গন্তব্য প্রয়োগ হয় না, আর 24 ঘণ্টার মধ্যে সেট না করলে নম্বরের ইতিহাস আর কখনো ইমপোর্ট হয় না।
EasyCoexistence দিয়ে এটি করা

মাঝপথে কিছু জমা না রেখে ইতিহাস সরাসরি আপনার এন্ডপয়েন্টে যায়, এবং প্রতিটি নম্বর 24/7 পর্যবেক্ষণ করা হয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত বাড়ে তত কমে, প্রথম 3 দিন ফ্রি।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

WhatsApp চ্যাট ইতিহাস ইমপোর্ট কতদূর পর্যন্ত যায়?

নম্বরটি Cloud API-তে অনবোর্ড হওয়ার আগের 180 দিন পর্যন্ত, দুই দিকের এক-থেকে-এক চ্যাট ধরে।

গ্রুপ চ্যাট কি ইমপোর্ট হয়?

না। Meta গ্রুপ চ্যাটের অংশ হিসেবে থাকা মেসেজ বাদ দেয়।

গ্রাহকের পুরোনো WhatsApp চ্যাট কি আমার ওয়েবহুকে পৌঁছাবে?

হ্যাঁ, ব্যবসা অ্যাপে শেয়ার করা বেছে নিলে, অনবোর্ডিংয়ের 24 ঘণ্টার মধ্যে একবার পাঠানো 180 দিন পর্যন্ত এক-থেকে-এক চ্যাট।

easyCoexistence কি ইমপোর্ট করা চ্যাটের কোনো কপি রাখে?

না। লাইভ মেসেজের মতোই Meta ইতিহাস সরাসরি আপনার webhook_url-এ পাঠায়, মাঝপথে কিছু জমা থাকে না।

আরও পড়ুন

গ্রাহকদের WhatsApp মেসেজ ও সোশ্যাল কমেন্ট ওয়েবহুকের মাধ্যমে কীভাবে পাবেনপ্রতিটি সংযোগের জন্য আলাদা ওয়েবহুক: Meta থেকে সরাসরি WhatsApp মেসেজ, URL-এর গোপন কী দিয়ে যাচাই করা, আর সোশ্যাল কমেন্ট ও DM X-EC-Signature দিয়ে স্বাক্ষরিত।কোনো গ্রাহকের WhatsApp বা সোশ্যাল সংযোগ বিচ্ছিন্ন হলে কীভাবে জানবেনconnection.* ও channel.* স্ট্যাটাস ইভেন্ট: পেলোড, PRIMARY_INACTIVITY-এর মতো কারণ, X-EC-Signature, প্রায় 33 ঘণ্টা ধরে পুনঃচেষ্টা এবং id দিয়ে ডুপ্লিকেট বাদ।WhatsApp, Instagram ও TikTok-এর জন্য গ্রাহকদের API টোকেন কীভাবে পাবেনWhatsApp নম্বর ও প্রতিটি সোশ্যাল অ্যাকাউন্টের ক্রেডেনশিয়াল কল কী ফেরত দেয়, ফিল্ড ধরে ধরে, এবং টোকেন নবায়ন কীভাবে কাজ করে।history ওয়েবহুকCoexistence নম্বরে একবারের চ্যাট ইতিহাসের স্থানান্তর এই `history` ফিল্ডে আসে। কী আসে, কখন আসে এবং কেন শুধু একবার আসে।smb_app_state_sync ওয়েবহুকWhatsApp Business অ্যাপে কনট্যাক্ট সিঙ্ক্রোনাইজেশন এই ফিল্ডে আসে। এতে কী থাকে এবং মেসেজ history থেকে এটি আলাদা কেন।চ্যাট না হারিয়ে WhatsApp-কে API-তে কীভাবে যুক্ত করবেনWhatsApp Business নম্বর Cloud API-তে যুক্ত করেও কথোপকথন অক্ষত থাকে। চ্যাট ফোনেই থাকে এবং কী সিঙ্ক হয়, তা জানুন।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে