ডেভেলপার ডকুমেন্টেশন

এর উপর তৈরি করুন টেক প্যাড এপিআই।

আপনার নিজের সিস্টেম থেকে হোয়াটসঅ্যাপ টেমপ্লেট মেসেজ পাঠান, হুকের মাধ্যমে ডেলিভারি ইভেন্টগুলি গ্রহণ করুন এবং লগে প্রতিটি অনুরোধ মনিটর করুন।

মুক্ত ওয়ার্ডপ্রেস প্লাগইনসমূহ

কোড এড়িয়ে চলুন — একটি কনেক্টর প্লাগইন ইনস্টল করুন।

একই WhatsApp বিজনেস API, আপনার ইতিমধ্যেই ব্যবহৃত টুলের জন্য ফ্রি কনেক্টর প্লাগইনে মোড়ানো — প্রতিটি ফর্ম, বুকিং, ইভেন্ট এবং স্টোর প্ল্যাটফর্ম সরাসরি আপনার WhatsApp এ পাঠায়। ইনস্টল করুন, আপনার ইমেইলের সাথে সংযোগ করুন, সম্পন্ন।

দ্রুত শুরু

চারটি ধাপে শূন্য থেকে একটি বিতরণকৃত হোয়াটসঅ্যাপ বার্তা। এখানে সবকিছু অ্যাপের ভেতরেও কাজ করে ডেভেলপার → ওভারভিউ পেজ, যা আপনার অগ্রগতি ট্র্যাক করে।

1

একটি API কী তৈরি করুন

খোলা ডেভেলপার → API কীগুলি অ্যাপে এবং একটি কী তৈরি করুন (প্রিফিক্স ttp_live_)। পূর্ণ সিক্রেট দেখানো হয় একবার — এটি অবিলম্বে অনুলিপি করুন।

2

একটি অনুমোদিত টেমপলেট নির্বাচন করুন

আপনার ওয়ার্কস্পেসের জন্য অন্তত একটি মেটা-অনুমোদিত টেমপ্লেট প্রয়োজন (দেখুন টেমপ্লেটস). টেমপ্লেট সরাসরি মেটা থেকে রিফ্রেশ হয়।

3

একটি টেস্ট অনুরোধ পাঠান

অ্যাপের মধ্যে ব্যবহার করুন API পরীক্ষক অথবা নিচের অনুরোধের জন্য। প্রাপকের অবশ্যই আপনার নম্বর থেকে টেমপ্লেট বার্তা গ্রহণের জন্য স্বীকৃতি দিতে হবে।

4

একটি ডেলিভারি ওয়েবহুক যোগ করুন

আপনার HTTPS এন্ডপয়েন্টে একটি ওয়েবহুক নির্দেশ করুন, যে ইভেন্টগুলি আপনি আগ্রহী সেগুলি নির্বাচন করুন, এবং দেখুন ওয়েবহুক লগ ডেলিভারি নিশ্চিত করুন।

প্রমাণীকরণ

এপিআই প্রতি-ওয়ার্কস্পেস এপিআই কী দিয়ে প্রমাণীকৃত হয় যা বিয়ারার টোকেন হিসেবে পাঠানো হয়। কী তৈরি এবং বাতিল করা হয় ডেভেলপার → API কীগুলি.

  • কী দিয়ে শুরু হয় ttp_live_ এবং এটি একটি ওয়ার্কস্পেসের জন্য সীমাবদ্ধ।
  • প্রতিটি ইন্টিগ্রেশনের জন্য আলাদা কী তৈরি করুন — প্রতিটি কী নিজস্ব ট্র্যাক করে last used টার্মস্ট্যাম্প।
  • সম্পূর্ণ সিক্রেট শুধুমাত্র সৃষ্টির সময় একবার প্রদর্শিত হয়; এটি পরে পুনরুদ্ধার করা যায় না। পরিবর্তে বাতিল করে পুনরায় তৈরি করুন।
  • কী পাঠান Authorization হেডারে: Authorization: Bearer ttp_live_…
আপনার API কী কখনও প্রকাশ করবেন না ক্লায়েন্ট-সাইড কোড, মোবাইল অ্যাপ বা পাবলিক রিপোজিটরিতে। কী শুধুমাত্র আপনার নিজস্ব সার্ভার এবং নিরাপদ ব্যাকএন্ডের জন্য предназначিত।

একটি বার্তা পাঠান

সংযুক্ত নম্বর থেকে একটি অনুমোদিত WhatsApp টেমপ্লেট মেসেজ পাঠায় এমন একজন নির্বাচিত প্রাপককে, যিনি আপনার ওয়ার্কস্পেসে আছেন।

POST https://v1.thetechpad.com/functions/v1/api-send

হেডার: Authorization: Bearer ttp_live_… · Content-Type: application/json

রিকোয়েস্ট বডি

ফিল্ডটাইপবর্ণনা
phoneNumberIdস্ট্রিংআপনার ওয়ার্কস্পেসে সংযুক্ত WhatsApp নম্বরের আইডি (WhatsApp নম্বর পেজ)।
toস্ট্রিংগ্রাহকের ফোন নম্বর E.164 ফরম্যাটে, উদাহরণস্বরূপ 15551234567.
template.nameস্ট্রিংআপনার ওয়ার্কস্পেসে মেটা-অনুমোদিত টেমপ্লেটের নাম, উদাহরণস্বরূপ order_update.
template.languageস্ট্রিংটেমপ্লেটের ভাষার কোড, উদাহরণস্বরূপ en.
template.parametersarray<string>টেমপ্লেটের ভেরিয়েবলগুলোর পজিশনাল মান, ক্রম অনুসারে।

উদাহরণ অনুরোধ

curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \
  -H 'Authorization: Bearer ttp_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "phoneNumberId": "1122334455",
  "to": "15551234567",
  "template": {
    "name": "order_update",
    "language": "en",
    "parameters": ["Ava", "#4031"]
  }
}'
// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
  method: 'POST',
  headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phoneNumberId: '1122334455',
    to: '15551234567',
    template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
  })
});
টেমপ্লেট নিয়ম প্রয়োগ হয়। বার্তাটি একটি অনুমোদিত টেমপ্লেট ব্যবহার করতে হবে এবং প্রাপককে যোগ্য (অপ্ট-ইন করা) হতে হবে। মেটা প্রতিটি প্রেরিত টেমপ্লেট বার্তার জন্য যাচাই করে এবং চার্জ করে — এই চার্জগুলো আলাদাভাবে মেটা দ্বারা বিল করা হয়, আপনার টেক প্যাড প্ল্যানের বাইরে।

ওয়েবহুক

আউটবাউন্ড ওয়েবহুকগুলি প্রায় বাস্তব সময়ে বার্তার জীবনচক্র ইভেন্টগুলি আপনার HTTPS এন্ডপয়েন্টে পাঠায়। এন্ডপয়েন্টগুলি পরিচালনা করুন ডেভেলপার → ওয়েবহুকস — যোগ করুন, সম্পাদনা করুন, বিরতি দিন, পরীক্ষা করুন এবং মুছুন।

ইভেন্ট

ইভেন্টঘটিত হয় যখন
message.sentএকটি বার্তা গ্রহণ করা হয়েছে এবং WhatsApp প্ল্যাটফর্ম দ্বারা প্রেরণ করা হয়েছে।
message.deliveredবার্তাটি প্রাপকের ডিভাইসে পৌঁছে দেওয়া হয়েছে।
message.readপ্রাপকটি বার্তাটি পড়েছে।
message.failedবার্তাটি ব্যর্থ হয়েছে (সরবরাহযোগ্য নয়, টেমপ্লেট প্রত্যাখ্যান, প্রেরকের সীমা, …)।
message.receivedএকটি ইনবাউন্ড বার্তা একজন গ্রাহক থেকে এসেছে।
  • এন্ডপয়েন্টগুলি অবশ্যই হতে হবে এইচটিটি‌পিএস এবং ইন্টারনেট থেকে পৌঁছানো যায়।
  • প্রতিটি এন্ডপয়েন্ট একটি নির্বাচিত ইভেন্টের উপসেটের সঙ্গে সাবস্ক্রাইব করে; প্রতিটি ইভেন্ট একটি JSON পে-লোডের সঙ্গে ফায়ার হয় যা মেসেজ আইডি এবং স্ট্যাটাস ধারণ করে।
  • ব্যবহার করুন পরীক্ষা একটি এন্ডপয়েন্টে একটি নমুনা ডেলিভারি পাঠাতে এবং আপনার হ্যান্ডলার যাচাই করতে।
  • বিরতি দেওয়া এন্ডপয়েন্টগুলি তাদের কনফিগারেশন রাখে কিন্তু ইভেন্ট গ্রহণ বন্ধ করে।

রেট সীমা

মেসেজগুলি আপনার প্ল্যানের প্যাকেজ রেট অনুযায়ী পাঠানো হয়। যখন Meta মেসেজিং-টিয়ার, ফোন-গুণমান বা অ্যাকাউন্ট-লেভেল সীমা প্রয়োগ করে তখন প্রকৃত থ্রুপুট কম হতে পারে। মেসেজগুলি থাকে নিরাপদে সারিতে রাখা হয়েছে ফেলে দেওয়ার পরিবর্তে।

পরিকল্পনাAPI কল / মাসমূল প্রেরণ হার
ক্যাম্পেইন স্টার্টার—প্রতি মিনিটে সর্বোচ্চ ৬টি বার্তা
লঞ্চ10,000প্যাকেজ হার
গ্রো200,000প্যাকেজ হার
স্কেল2,000,000প্যাকেজ হার

প্রতিটি অনুরোধ আপনার API-কল কোটা হিসাবের মধ্যে গণনা করা হয় এবং এর স্ট্যাটাস কোড এবং সময়কাল সহ API লগে নথিভুক্ত করা হয়।

লগ এবং তদারকি

ডেভেলপার → লগ দুটি ভিউ রাখে:

  • API লগ — প্রতিটি API অনুরোধ: পদ্ধতি, এন্ডপয়েন্ট, HTTP স্ট্যাটাস, ব্যবহৃত টেমপ্লেট এবং সময়কাল।
  • ওয়েবহুক লগ — প্রতিটি ওয়েবহুক প্রদানের চেষ্টা এবং তার ফলাফল।

ব্যর্থ পাঠানো ডিবাগ করতে, ওয়েবহুক ডেলিভারি নিশ্চিত করতে এবং এন্ড-টু-এন্ড ইন্টিগ্রেশন অডিট করতে এগুলো ব্যবহার করুন।

ত্রুটি

সফল অনুরোধ একটি 2xx স্ট্যাটাস ফেরত দেয়। ব্যর্থতা একটি non-2xx স্ট্যাটাস ফেরত দেয় সঙ্গে একটি JSON বডি যা সমস্যাটি বর্ণনা করে:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}
স্ট্যাটাসঅর্থ
2xxঅনুরোধ গ্রহণ / প্রক্রিয়াকৃত।
400ত্রুটিপূর্ণ অনুরোধ — অনুপস্থিত বা অবৈধ ফিল্ড।
401অনুপস্থিত বা অবৈধ API কী।
403চাবি বৈধ কিন্তু এই ক্রিয়া বা কর্মক্ষেত্রের জন্য অনুমোদিত নয়।
404অজানা সংখ্যা, টেমপ্লেট বা সম্পদ।
429হার্ড সীমা বা কোটা অতিক্রম হয়েছে — ব্যাকঅফের পরে আবার চেষ্টা করুন।
5xxপ্ল্যাটফর্ম ত্রুটি — পুনরায় চেষ্টা করুন; API লগ এবং স্ট্যাটাস পৃষ্ঠা দেখুন।

কনসোল থেকে API চেষ্টা করুন।

ইন-অ্যাপ API পরীক্ষক প্রতিটি অনুরোধের জন্য curl, JavaScript এবং PHP তৈরি করে।

আমাদের সাথে চ্যাট করুন