এর উপর তৈরি করুন টেক প্যাড এপিআই।
আপনার নিজের সিস্টেম থেকে হোয়াটসঅ্যাপ টেমপ্লেট মেসেজ পাঠান, হুকের মাধ্যমে ডেলিভারি ইভেন্টগুলি গ্রহণ করুন এবং লগে প্রতিটি অনুরোধ মনিটর করুন।
কোড এড়িয়ে চলুন — একটি কনেক্টর প্লাগইন ইনস্টল করুন।
একই WhatsApp বিজনেস API, আপনার ইতিমধ্যেই ব্যবহৃত টুলের জন্য ফ্রি কনেক্টর প্লাগইনে মোড়ানো — প্রতিটি ফর্ম, বুকিং, ইভেন্ট এবং স্টোর প্ল্যাটফর্ম সরাসরি আপনার WhatsApp এ পাঠায়। ইনস্টল করুন, আপনার ইমেইলের সাথে সংযোগ করুন, সম্পন্ন।
দ্রুত শুরু
চারটি ধাপে শূন্য থেকে একটি বিতরণকৃত হোয়াটসঅ্যাপ বার্তা। এখানে সবকিছু অ্যাপের ভেতরেও কাজ করে ডেভেলপার → ওভারভিউ পেজ, যা আপনার অগ্রগতি ট্র্যাক করে।
একটি API কী তৈরি করুন
খোলা ডেভেলপার → API কীগুলি অ্যাপে এবং একটি কী তৈরি করুন (প্রিফিক্স ttp_live_)। পূর্ণ সিক্রেট দেখানো হয় একবার — এটি অবিলম্বে অনুলিপি করুন।
একটি অনুমোদিত টেমপলেট নির্বাচন করুন
আপনার ওয়ার্কস্পেসের জন্য অন্তত একটি মেটা-অনুমোদিত টেমপ্লেট প্রয়োজন (দেখুন টেমপ্লেটস). টেমপ্লেট সরাসরি মেটা থেকে রিফ্রেশ হয়।
একটি টেস্ট অনুরোধ পাঠান
অ্যাপের মধ্যে ব্যবহার করুন API পরীক্ষক অথবা নিচের অনুরোধের জন্য। প্রাপকের অবশ্যই আপনার নম্বর থেকে টেমপ্লেট বার্তা গ্রহণের জন্য স্বীকৃতি দিতে হবে।
একটি ডেলিভারি ওয়েবহুক যোগ করুন
আপনার HTTPS এন্ডপয়েন্টে একটি ওয়েবহুক নির্দেশ করুন, যে ইভেন্টগুলি আপনি আগ্রহী সেগুলি নির্বাচন করুন, এবং দেখুন ওয়েবহুক লগ ডেলিভারি নিশ্চিত করুন।
প্রমাণীকরণ
এপিআই প্রতি-ওয়ার্কস্পেস এপিআই কী দিয়ে প্রমাণীকৃত হয় যা বিয়ারার টোকেন হিসেবে পাঠানো হয়। কী তৈরি এবং বাতিল করা হয় ডেভেলপার → API কীগুলি.
- কী দিয়ে শুরু হয়
ttp_live_এবং এটি একটি ওয়ার্কস্পেসের জন্য সীমাবদ্ধ। - প্রতিটি ইন্টিগ্রেশনের জন্য আলাদা কী তৈরি করুন — প্রতিটি কী নিজস্ব ট্র্যাক করে
last usedটার্মস্ট্যাম্প। - সম্পূর্ণ সিক্রেট শুধুমাত্র সৃষ্টির সময় একবার প্রদর্শিত হয়; এটি পরে পুনরুদ্ধার করা যায় না। পরিবর্তে বাতিল করে পুনরায় তৈরি করুন।
- কী পাঠান
Authorizationহেডারে:Authorization: Bearer ttp_live_…
একটি বার্তা পাঠান
সংযুক্ত নম্বর থেকে একটি অনুমোদিত WhatsApp টেমপ্লেট মেসেজ পাঠায় এমন একজন নির্বাচিত প্রাপককে, যিনি আপনার ওয়ার্কস্পেসে আছেন।
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.parameters | array<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 তৈরি করে।