Spun আপনাকে সেই নম্বরেই একটি REST API দেয়, যে নম্বরে আপনার টিম শেয়ার্ড WhatsApp ইনবক্স থেকে উত্তর দেয়: টেক্সট আর মিডিয়া পাঠান, মেসেজ পড়ুন, কন্টাক্ট ও লেবেল আপডেট করুন, আর ওয়েবহুক সাবস্ক্রাইব করুন। এটি কাজ করে সেই নম্বরের সামনে, যেটি আপনি QR স্ক্যান করে লিঙ্ক করেছেন, তাই এর জন্য Business API লাগে না এবং কোনো প্রতি মেসেজ ফি নেই।
একটি WhatsApp API-কে দিয়ে যা যা করানো হয়, তার বেশিরভাগই চারটি কাজে এসে দাঁড়ায়: মেসেজ পাঠানো, কিছু খুঁজে দেখা, কোনো রেকর্ড বদলানো, আর কিছু ঘটলে খবর পাওয়া। Spun এই চারটিই সাধারণ HTTP-তে দেয়, সেই একই নম্বরের জন্য যেখানে আপনার টিম ইনবক্সে উত্তর দেয়। অথেনটিকেশন হয় এমন একটি কী দিয়ে, যা আপনি নিজে তৈরি করেন এবং ইন্টিগ্রেশনের ঠিক যতটুকু দরকার ততটুকু স্কোপে সীমিত রাখেন।
এই পেজটি এর ব্যবহারিক রূপ: এন্ডপয়েন্টগুলো কী কী, অথেনটিকেশন আর স্কোপ কীভাবে কাজ করে, কল করার মুহূর্তে আপনার WhatsApp লাইন অফলাইন থাকলে কী হয়, আর মেশিনে পড়া যায় এমন কন্ট্র্যাক্টটি কোথায় আছে।
কী, স্কোপ আর কী ফাঁস হলে ক্ষতির পরিধি
অথেনটিকেশন হয় একটি bearer টোকেন দিয়ে। আপনি অ্যাপে একটি কী তৈরি করেন, সেটি আপনাকে মাত্র একবার দেখানো হয়, আর প্রতিটি রিকোয়েস্ট সেটিকে Authorization হেডারে বহন করে। Spun কী-টির শুধু একটি হ্যাশ সংরক্ষণ করে, তাই হারানো কী আর ফিরে পাওয়া যায় না, শুধু নতুন কী দিয়ে বদলানো যায়।
যে অংশে এক মিনিট সময় দেওয়া সার্থক, সেটি হলো স্কোপিং। একটি কী মানে শুধু "অ্যাকাউন্টের অ্যাক্সেস" নয়: এর সাথে স্কোপের একটি তালিকা থাকে, আর প্রতিটি এন্ডপয়েন্ট তার নিজের দরকারি নির্দিষ্ট স্কোপটি আছে কি না যাচাই করে। শুধু read_contacts থাকা কী দিয়ে মেসেজ পাঠানো যায় না। শুধু send_message থাকা কী দিয়ে আপনার কন্টাক্ট তালিকা একে একে বের করা যায় না। স্কোপের পাশাপাশি একটি কী-তে মেয়াদ শেষের তারিখ আর একটি IP অ্যালাউলিস্টও দেওয়া যায়, ফলে নির্দিষ্ট ঠিকানার কোনো সার্ভারকে দেওয়া কী অন্য কোথাও থেকে ব্যবহার করা হলে সেই মুহূর্তেই কাজ করা বন্ধ করে দেয়।
- send_message-এর মধ্যে আছে টেক্সট ও মিডিয়া পাঠানো, আর কিউতে থাকা একটি সেন্ড আবার পড়ে দেখা।
- read_contacts, read_messages আর read_labels হলো পড়ার দিক, প্রতিটি আলাদাভাবে দেওয়া যায়।
- manage_contacts আর manage_labels-এর মধ্যে আছে তৈরি করা, আপডেট করা আর লেবেল লাগানো।
- check_phone জানায় একটি নম্বরে WhatsApp-এ পৌঁছানো যায় কি না।
- manage_webhooks ওয়েবহুক সাবস্ক্রিপশন তৈরি করে, তালিকা দেখায় আর মুছে ফেলে।
রিকোয়েস্ট
curl -X POST https://api.spun.com/api/integrations/send-message \
-H "Authorization: Bearer wap_0f3c9a1d7b524e86a1c05d9e2f7b48ac" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550142",
"text": "Your appointment is confirmed for Thursday at 10:00.",
"idempotency_key": "booking-8871"
}'রেসপন্স
HTTP/1.1 200 OK
Content-Type: application/json
{
"success": true,
"message_id": "yq0Zt9C1sK2mfE7x"
}Spun MCP সার্ভারের জন্য তৈরি কী এই API-তে ইচ্ছা করেই প্রত্যাখ্যান করা হয়, বৈধ কী হলেও। দুটি ইন্টারফেসের অনুমোদনের নিয়ম আলাদা, আর একটির জন্য দেওয়া কী নিঃশব্দে অন্যটিতে ব্যবহার করা যায় না।
সম্পর্কিত: কোড লেখার বদলে একটি AI সহকারী সংযুক্ত করা
WhatsApp API-এর এন্ডপয়েন্টগুলো আসলে কী কী করে
ইন্টারফেসটি ইচ্ছা করেই ছোট আর স্থির রাখা হয়েছে, প্রোডাক্টের সবকিছুর পুরো প্রতিলিপি নয়। এটি আছে যাতে বাইরের কোনো সিস্টেম সেই কাজগুলো করতে পারে, যা বাইরের সিস্টেমের সত্যিই করার দরকার হয়।
- সেন্ড: একটি টেক্সট মেসেজ, অথবা URL বা base64 হিসেবে মিডিয়া, ঐচ্ছিক ক্যাপশনসহ।
- কন্টাক্ট: কন্টাক্ট তৈরি করুন, কোনো কন্টাক্ট আপডেট করুন, আর কার্সর পেজিনেশন দিয়ে কন্টাক্টের তালিকা দেখুন।
- লেবেল: ওয়ার্কস্পেসের লেবেলগুলোর তালিকা দেখুন, কোনো কথোপকথনে লেবেল লাগান, লেবেল সরান।
- মেসেজ: কার্সর পেজিনেশন দিয়ে মেসেজের তালিকা, কোনো ডেটা ওয়্যারহাউস বা CRM-এ সিঙ্ক করার জন্য।
- ফোন যাচাই: কোনো নম্বর ঘিরে তালিকা বানানোর আগে নিশ্চিত হয়ে নিন সেটি WhatsApp-এ আছে।
- কিউ: লাইন অফলাইন থাকায় কিউতে রাখা কোনো সেন্ড খুঁজে দেখুন।
- ওয়েবহুক: সাবস্ক্রিপশন তৈরি করুন, তালিকা দেখুন আর মুছে ফেলুন।
মেশিনে পড়া যায় এমন কন্ট্র্যাক্টটি /api/integrations/openapi.json-এ প্রকাশিত এবং পড়ার জন্য কোনো কী লাগে না, তাই একজন n8n নোড লেখক, একজন Zapier অ্যাপ নির্মাতা বা আপনার নিজের জেনারেটর কাউকে ক্রেডেনশিয়াল দেওয়ার আগেই স্পেকটি নিয়ে নিতে পারে।
WhatsApp লাইন অফলাইন থাকলে কী হয়
এই অংশটি মানুষকে অবাক করে, তাই স্পষ্ট করে বলা দরকার। Spun একটি লাইভ WhatsApp সেশনের মাধ্যমে পাঠায়, আর আপনার কোড ঠিক যে সেকেন্ডে কল করে, সেই সেকেন্ডেই লাইভ সেশন বন্ধ থাকতে পারে। API এর উল্টো ভান করে না, আর ইচ্ছা করেই টেক্সট আর মিডিয়ার ক্ষেত্রে আলাদা আচরণ করে।
অফলাইন লাইনে টেক্সট পাঠালে এরর নয়, 202 ফেরত আসে, সাথে একটি কিউ id। মেসেজটি ধরে রাখা হয় এবং লাইন আবার সংযুক্ত হলে ডেলিভার হয়, আর এর পরিণতি জানতে আপনি কিউ এন্ডপয়েন্ট পোল করতে পারেন। অফলাইন লাইনে মিডিয়া পাঠালে এর বদলে একটি কনফ্লিক্ট ফেরত আসে, এবং কিছুই পাঠানো হয় না। এই অসমতা ইচ্ছাকৃত: কিউ মেসেজগুলোকে টেক্সট হিসেবে পাঠায়, তাই কিউতে রাখা একটি ছবি ছবি ছাড়াই শুধু ক্যাপশন হয়ে পৌঁছাত। স্পষ্টভাবে ব্যর্থ হওয়াই ভালো ফল, আর পরে কী হবে তা ঠিক করে আপনার রিট্রাই লজিক।
রেট লিমিট প্রতি কী-তে প্রতি মিনিটে 60টি রিকোয়েস্ট, আর প্রতিটি রেসপন্সে স্ট্যান্ডার্ড রেট-লিমিট হেডার থাকে, যাতে কোনো ক্লায়েন্ট অপ্রত্যাশিত 429-এর বদলে হেডার দেখেই গতি কমাতে পারে।
ওয়েবহুক: পোল করার বদলে খবর পাওয়া
টাইমার ধরে মেসেজ এন্ডপয়েন্ট বারবার পোল করা কথোপকথনের জন্য সঠিক পদ্ধতি নয়, তাই API নিজেই পুশ করতে পারে। আপনি একটি URL আর যে ইভেন্টগুলো আপনার দরকার সেগুলো রেজিস্টার করেন, আর সেগুলো ঘটার সাথে সাথে Spun সেই URL-এ একটি JSON বডি পোস্ট করে।
প্রতিটি ডেলিভারির হেডারে থাকে ইভেন্টের নাম আর একটি অনন্য ডেলিভারি id, এবং সাবস্ক্রিপশনে সাইনিং সিক্রেট থাকলে ঠিক সেই বডির একটি HMAC-SHA256 সিগনেচারও। পেলোডে ভরসা করার আগে সিগনেচার যাচাই করুন: যে কেউ URL-টি জেনে ফেললে, শুধু এটিই আপনার এন্ডপয়েন্টকে তার থেকে আলাদা করে। সিক্রেটটি মাত্র একবার ফেরত দেওয়া হয়, সাবস্ক্রিপশন তৈরির সময়, আর কখনো নয়।
- মেসেজ ইভেন্ট, আসা আর যাওয়া দুই দিকেরই।
- কন্টাক্ট তৈরি, আপডেট আর মুছে ফেলা।
- লেবেল অ্যাসাইন করা।
- চ্যাটফ্লো সম্পূর্ণ, কিউতে থাকা সেন্ড প্রসেস হয়েছে, লিড যোগ্য বলে চিহ্নিত।
- কথোপকথন বন্ধ, কল সম্পূর্ণ, আর পাইপলাইনের ধাপ বদলেছে।
সম্পর্কিত: Spun-কে Zapier আর Make-এর সাথে সংযুক্ত করা · Spun-কে n8n-এর সাথে সংযুক্ত করা · একটি হেল্পডেস্ক সংযুক্ত করা: Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub, Jira
সীমা আর সৎ সতর্কতা
- এটি WhatsApp Business API নয়। এটি আপনার লিঙ্ক করা নম্বরের সামনে Spun-এর নিজস্ব API, তাই অনুমোদন করানোর মতো কোনো মেসেজ টেমপ্লেট নেই, কোনো প্রতি মেসেজ ফি নেই, আর একইভাবে Meta-র কোনো আনুষ্ঠানিক গ্যারান্টিও নেই।
- প্রতি কী-তে প্রতি মিনিটে ষাটটি রিকোয়েস্ট। বড় পরিমাণের কাজ ক্যাম্পেইনে করুন, যেগুলো নিজেদের গতি ঠিকভাবে সামলায়, কোনো দ্রুত API লুপে নয়।
- উপরের এন্ডপয়েন্ট তালিকাই আজকের পুরো ইন্টারফেস। যা এতে নেই তা খোলা নেই, আর ডকুমেন্টেশনে নেই এমন কোনো এন্ডপয়েন্টের উপর নির্ভর করা উচিত নয়।
- কী স্কোপ-নির্দিষ্ট, কিন্তু প্রতি ইউজারের জন্য আলাদা নয়। এটিকে ওয়ার্কস্পেসের ক্রেডেনশিয়াল হিসেবে দেখুন, আর অ্যাক্সেস আছে এমন কেউ চলে গেলে কী বদলে দিন।
- যাঁরা কখনো সম্মতি দেননি তাঁদের মেসেজ পাঠালে WhatsApp নম্বরটি সীমিত করে দেবে, মেসেজ যে পথেই যাক না কেন।
সম্পর্কিত: Spun কীভাবে WhatsApp-এর সাথে সংযুক্ত হয়