FAQ
Bulk SMS API প্রশ্ন এবং উত্তর
39 উত্তর অ্যাকাউন্ট, পাঠানো, মূল্য, ডেলিভারি রিপোর্ট এবং API সম্পর্কে, কোডের সীমার বিরুদ্ধে পরীক্ষা করা হয়েছে। এন্ডপয়েন্ট এবং ফিল্ডের জন্য, API রেফারেন্স এ বিস্তারিত রয়েছে।
সেবা
BulkSMSAPI কি?
ডেভেলপারদের জন্য একটি বাল্ক এসএমএস API: REST এর মাধ্যমে 227টি দেশে প্রতি অনুরোধে একটি টেক্সট বা 10,000 নম্বর পর্যন্ত একটি ব্যাচ পাঠান, প্রতিটি বার্তাকে সাইনড ওয়েবহুকসের সাথে অনুসরণ করুন, এবং একটি প্রিপেইড ব্যালেন্স থেকে প্রতি বার্তার জন্য অর্থ প্রদান করুন। একটি ওয়েব কনসোল কোড ছাড়াই পেস্ট করা তালিকা বা CSV থেকে প্রচারণা পাঠায়।
কে একটি বাল্ক এসএমএস API ব্যবহার করে?
পণ্য এবং ইঞ্জিনিয়ারিং দলগুলি যারা তাদের নিজস্ব সিস্টেম থেকে টেক্সট পাঠায়: লগইন এবং সাইন-আপ কোড, অর্ডার এবং ডেলিভারি আপডেট, অ্যাপয়েন্টমেন্ট রিমাইন্ডার, পেমেন্ট অ্যালার্ট, সার্ভিস নোটিশ এবং মার্কেটিং প্রচারণা। যে কেউ HTTPS অনুরোধ করতে পারে সে এটি ব্যবহার করতে পারে।
আমি কোন দেশে পাঠাতে পারি?
227টি দেশ এবং অঞ্চল, তাদের মূল্য সহ মূল্য নির্ধারণ পৃষ্ঠা এবং দেশ পৃষ্ঠাগুলিতে তালিকাভুক্ত। একটি অনুরোধ দেশগুলিকে মিশ্রিত করতে পারে: প্রতিটি নম্বর তার অন্তর্ভুক্ত দেশ দ্বারা মূল্য নির্ধারণ করা হয়।
একটি মাসিক ফি বা চুক্তি আছে কি?
না। আপনি একটি প্রিপেইড ব্যালেন্স থেকে প্রতি বার্তা সেগমেন্টের জন্য অর্থ প্রদান করেন, এবং কোন মাসিক ফি, সেটআপ ফি বা ন্যূনতম ভলিউম নেই। ব্যালেন্সের কোন মেয়াদ শেষ হওয়ার তারিখ নেই।
একটি ফ্রি ট্রায়াল আছে কি?
অ্যাকাউন্টগুলি শূন্য ব্যালেন্স দিয়ে শুরু হয় এবং প্রথম টপ-আপ সবকিছু খুলে দেয়। প্রথম টপ-আপ 40% পর্যন্ত বোনাস যোগ করে, তাই প্রথম বার্তাগুলির খরচ কম। মূল্য সর্বজনীন, এবং অনুমান এন্ডপয়েন্ট এবং কনসোল পাঠানোর আগে সঠিক খরচ দেখায়।
অ্যাকাউন্ট এবং API কী
আমি কিভাবে একটি অ্যাকাউন্ট তৈরি করব?
Get API key খুলুন। আপনার ব্রাউজার একটি অ্যাকাউন্ট কী তৈরি করে যা acct_ দিয়ে শুরু হয়; এটি কপি করুন বা একটি টেক্সট ফাইল হিসাবে সংরক্ষণ করুন, নিশ্চিত করুন যে আপনি এটি সংরক্ষণ করেছেন, এবং অ্যাকাউন্ট প্রস্তুত। অ্যাকাউন্ট কী একমাত্র লগইন: কোন ইমেল বা পাসওয়ার্ড পরিচালনা করার নেই।
যদি আমি আমার অ্যাকাউন্ট কী হারিয়ে ফেলি তাহলে কী হবে?
আমরা শুধুমাত্র এর একটি কীড হ্যাশ সংরক্ষণ করি, তাই কেউই এটি আবার দেখাতে পারে না, আমাদের সহায়তা দল সহ। এটি একটি পাসওয়ার্ড ম্যানেজারে রাখুন। আপনি যখনও সাইন ইন থাকেন, কনসোল কাজ করতে থাকে, এবং আপনি এটি থেকে সহায়তা যোগাযোগ করতে পারেন।
আমি কিভাবে একটি API কী পেতে পারি?
কনসোলের API কী পৃষ্ঠায়, প্রথম টপ-আপ ক্রেডিট হওয়ার পরে। কীটির নাম দিন, এটি তৈরি করুন এবং একবার কপি করুন: এটি bsa_live_ দিয়ে শুরু হয়। একটি অ্যাকাউন্টে 10টি সক্রিয় কী থাকতে পারে, প্রতিটির নিজস্ব নাম এবং রেট লিমিট কাউন্টার রয়েছে।
আমি কি প্রোডাকশন এবং স্টেজিংয়ের জন্য আলাদা কী ব্যবহার করতে পারি?
হ্যাঁ। প্রতি অ্যাপ বা পরিবেশের জন্য একটি কী তৈরি করুন এবং এর একটি নাম দিন। প্রতিটি কী দেখায় যে এটি সর্বশেষ কখন ব্যবহার করা হয়েছিল, এবং একটি বাতিল করলে অন্যগুলি কাজ করতে থাকে।
আমি কতগুলি অ্যাকাউন্ট তৈরি করতে পারি?
প্রতি নেটওয়ার্ক ঠিকানায় সর্বোচ্চ 3টি অ্যাকাউন্ট। বেশিরভাগ দলের একাধিক API কী সহ একটি অ্যাকাউন্ট প্রয়োজন।
বার্তা পাঠানো
একটি অনুরোধে কতগুলি নম্বর নিতে পারে?
POST /v1/batches প্রতিটি অনুরোধে সর্বোচ্চ 10,000 নম্বর নেয়, হয় সবার জন্য একটি টেক্সট বা প্রতি নম্বরের জন্য একটি ব্যক্তিগত টেক্সট। কনসোল প্রতিটি ক্যাম্পেইনের জন্য 50,000 নম্বর নেয়। বড় তালিকাগুলি একাধিক অনুরোধে বিভক্ত করা হয়।
বার্তাগুলি কত দ্রুত পাঠানো হয়?
কিউ প্রতি দুই সেকেন্ডে চলে এবং প্রতি অ্যাকাউন্টে প্রতি মিনিটে সর্বোচ্চ 1,200 বার্তা নেটওয়ার্কে হস্তান্তর করে, যে ক্রমে তারা গৃহীত হয়েছিল। একটি একক বার্তা সাধারণত অনুরোধের কয়েক সেকেন্ডের মধ্যে পাঠানো হয়।
ফোন নম্বরগুলি কোন ফর্ম্যাটে হওয়া উচিত?
আন্তর্জাতিক E.164: একটি প্লাস চিহ্ন, কলিং কোড এবং জাতীয় নম্বর, যেমন +14155550123। স্পেস, ড্যাশ, ব্র্যাকেট এবং 00 প্রিফিক্স স্বয়ংক্রিয়ভাবে পরিষ্কার করা হয়; ডুপ্লিকেট এবং পড়া যায় না এমন নম্বরগুলি আলাদা রাখা হয় এবং চার্জ করা হয় না।
একটি বার্তা কত দীর্ঘ হতে পারে?
সর্বোচ্চ 10 সেগমেন্ট: GSM-7 এ 1,530 অক্ষর বা ইউনিকোডে 670। একটি সেগমেন্টে 160 GSM-7 বা 70 ইউনিকোড অক্ষর থাকে; দীর্ঘ টেক্সটগুলি 153 বা 67 অক্ষরের অংশে বিভক্ত করা হয় এবং ফোনে আবার যুক্ত করা হয়।
আমার বার্তা কেন আমার প্রত্যাশার চেয়ে বেশি সেগমেন্ট ব্যবহার করেছে?
GSM-7 বর্ণমালার বাইরে একটি অক্ষর, যেমন একটি কার্লি উদ্ধৃতি, একটি ইমোজি বা á বা ç এর মতো একটি অক্ষর, পুরো টেক্সটকে ইউনিকোডে স্যুইচ করে প্রতি সেগমেন্টে 70 অক্ষরে। কনসোল কম্পোজার সেই অক্ষরগুলির নাম দেয়, এবং POST /v1/estimates পাঠানোর আগে এনকোডিং ফেরত দেয়।
আমি কি বার্তা সময়সূচী করতে পারি?
হ্যাঁ। একটি API অনুরোধে send_at যোগ করুন, বা কনসোলে একটি সময় নির্বাচন করুন, 2 মিনিট থেকে 45 দিন আগে। একটি সময়সূচীযুক্ত ব্যাচ শুরু হওয়ার আগে পর্যন্ত বাতিল করা যেতে পারে, এবং এর সম্পূর্ণ খরচ ব্যালেন্সে ফেরত আসে।
প্রতিটি প্রাপক কি একটি ভিন্ন টেক্সট পেতে পারে?
হ্যাঁ। API এর মাধ্যমে, বার্তাগুলির সাথে একটি ব্যাচ পাঠান, প্রতি প্রাপকের জন্য একটি {to, text}। কনসোলে, অতিরিক্ত কলাম সহ একটি তালিকা পেস্ট বা আপলোড করুন এবং টেক্সটে {{1}} থেকে {{9}} পর্যন্ত মার্জ ফিল্ড ব্যবহার করুন।
আমার বার্তাগুলিতে কি একটি অপ্ট-আউট লাইন যোগ করা হয়?
সেটিংসে একবার আপনার অপ্ট-আউট শব্দ সেট করুন, উদাহরণস্বরূপ একটি লিঙ্ক বা ইমেল ঠিকানা, এবং আপনি বক্সটি টিক করলে কনসোল এটি ক্যাম্পেইন টেক্সটে যোগ করে। API এর মাধ্যমে আপনি সম্পূর্ণ টেক্সট নিয়ন্ত্রণ করেন, তাই মার্কেটিং বার্তাগুলিতে লাইনটি নিজেই যোগ করুন। আপনার ডু-নট-সেন্ড তালিকার নম্বরগুলি কনসোল এবং API দ্বারা এড়িয়ে যায় এবং চার্জ করা হয় না।
আমি কি প্রথমে একটি টেস্ট বার্তা পাঠাতে পারি?
হ্যাঁ। কনসোলে একটি ক্যাম্পেইনের আগে একটি নম্বরে একটি টেস্ট পাঠানো থাকে, এবং API এর মাধ্যমে আপনি POST /v1/messages এর মাধ্যমে আপনার নিজের ফোনে একটি একক বার্তা পাঠাতে পারেন।
মূল্য এবং পেমেন্ট
একটি SMS এর খরচ কত?
এটি নম্বরের দেশের উপর নির্ভর করে: প্রতিটি দেশের প্রতি সেগমেন্টের জন্য একটি মূল্য রয়েছে মার্কিন ডলারে, $0.00247 (ব্রাজিল) থেকে। মূল্য নির্ধারণ পৃষ্ঠা এবং GET /v1/pricing প্রতিটি দেশের তালিকা করে।
একটি ব্যাচের খরচ কিভাবে গণনা করা হয়?
প্রতিটি প্রাপকের জন্য: তার দেশের প্রতি সেগমেন্টের মূল্য তার টেক্সটের সেগমেন্টের সংখ্যা দ্বারা গুণিত। অনুরোধ গৃহীত হলে যোগফল ব্যালেন্স থেকে নেওয়া হয়, এবং উত্তরটি খরচে এটি দেখায়।
সর্বনিম্ন টপ-আপ কত?
$40। টপ-আপ $40 থেকে $5,000 পর্যন্ত যেকোনো পরিমাণ হতে পারে। প্রথম টপ-আপে সর্বোচ্চ 40% বোনাস যোগ করা হয়, যা আপনি অর্থ প্রদানের আগে প্রতিটি পরিমাণে দেখানো হয়।
আমি কীভাবে অর্থ প্রদান করব?
কনসোলে, বিলিং পৃষ্ঠার উপরে একটি হোস্টেড চেকআউট উইন্ডো খোলে। আপনি পরিমাণ নির্বাচন করে ক্রিপ্টোকারেন্সিতে অর্থ প্রদান করেন, এবং অর্থ প্রদানের পৃষ্ঠাটি সঠিক পরিমাণ এবং ঠিকানা দেখায়। অর্থ প্রদানের পৃষ্ঠাটি প্রতিটি ধাপ তালিকাভুক্ত করে।
ব্যর্থ বার্তাগুলি ফেরত দেওয়া হয় কি?
হ্যাঁ। যখন একটি বার্তা ব্যর্থ হয়, তার মূল্য লেজারে ফেরত লাইন হিসাবে স্বয়ংক্রিয়ভাবে ব্যালেন্সে ফিরে আসে। একটি বাতিলকৃত নির্ধারিত ব্যাচ সম্পূর্ণরূপে ফেরত দেওয়া হয়।
আমি কি আমার ব্যালেন্স তুলে নিতে পারি?
ব্যালেন্স বার্তার জন্য অর্থ প্রদান করে এবং কোনো মেয়াদ শেষ হওয়ার তারিখ ছাড়াই আপনার অ্যাকাউন্টে থাকে। ব্যর্থ বা বাতিলকৃত বার্তার জন্য ফেরতও ব্যালেন্সে ফিরে যায়।
দাম পরিবর্তন হয় কি?
নেটওয়ার্ক খরচ পরিবর্তন হলে দাম পরিবর্তন হতে পারে। বর্তমান তালিকাটি তারিখযুক্ত, API প্রতিটি দামের সাথে তারিখ ফেরত দেয়, এবং ইতিমধ্যে গৃহীত বার্তাগুলি তাদের চার্জ করা দামে থাকে।
ডেলিভারি এবং রিপোর্ট
আমি কীভাবে জানব যে একটি বার্তা ডেলিভারি হয়েছে?
প্রতিটি বার্তা কিউড থেকে সেন্ট হয়ে ডেলিভার্ড বা ফেইল্ড অবস্থায় যায়। প্রতিটি চূড়ান্ত অবস্থার জন্য একটি স্বাক্ষরিত ইভেন্ট পেতে কনসোলে একটি webhook URL যোগ করুন, অথবা GET /v1/messages/{id} এবং GET /v1/batches/{id} পড়ুন।
Webhooks কীভাবে স্বাক্ষরিত হয়?
স্ট্যান্ডার্ড Webhooks ফরম্যাটে: হেডারগুলি webhook-id, webhook-timestamp এবং webhook-signature, যেখানে স্বাক্ষরটি আপনার whsec_ সিক্রেট সহ id, timestamp এবং raw body এর HMAC-SHA256। ডকুমেন্টেশনে Node.js, Python, PHP এবং Go এর জন্য যাচাইকরণ কোড রয়েছে।
যদি আমার webhook endpoint ডাউন থাকে তাহলে কী হবে?
প্রতিটি ইভেন্ট প্রায় 24 ঘন্টার মধ্যে 10 বার চেষ্টা করে, এবং প্রতিটি চেষ্টা তার HTTP অবস্থা সহ কনসোলে তালিকাভুক্ত হয়। আপনি যেকোনো সময় বার্তা endpoints পোল করতে পারেন।
কেন একটি বার্তা ব্যর্থ হতে পারে?
হ্যান্ডসেটটি দীর্ঘ সময়ের জন্য বন্ধ থাকতে পারে, নম্বরটি আর পরিষেবায় নাও থাকতে পারে, বা নেটওয়ার্কটি বার্তাটি প্রত্যাখ্যান করতে পারে। ব্যর্থ অবস্থাটি একটি ত্রুটি কোড বহন করে, এবং মূল্যটি ফেরত দেওয়া হয়।
বার্তা রেকর্ডগুলি কতদিন রাখা হয়?
ব্যাচ, বার্তা এবং ব্যালেন্স লেজার আপনার অ্যাকাউন্টে এবং API তে থাকে। অনুরোধ লগ আপনার শেষ 500 API কল এবং webhook লগ আপনার শেষ 500 ডেলিভারি রাখে।
ডেভেলপারদের জন্য
SDK আছে কি?
API টি HTTPS এর উপর plain JSON, তাই যেকোনো ভাষার স্ট্যান্ডার্ড লাইব্রেরিই যথেষ্ট। ডকুমেন্টেশনে curl, Node.js, Python, PHP এবং Go এর সম্পূর্ণ নমুনা রয়েছে, এবং /openapi.json এ OpenAPI স্পেসিফিকেশন বেশিরভাগ ভাষায় একটি টাইপড ক্লায়েন্ট তৈরি করে।
রেট লিমিটগুলি কী?
প্রতি API কী প্রতি মিনিটে 600 অনুরোধ। প্রতিটি উত্তরে X-RateLimit-Limit, X-RateLimit-Remaining এবং X-RateLimit-Reset হেডার থাকে, এবং একটি 429 উত্তরে Retry-After থাকে।
টাইমআউটের পরে আমি কীভাবে নিরাপদে পুনরায় চেষ্টা করব?
একটি Idempotency-Key হেডার সহ POST অনুরোধ পাঠান এবং একই কী দিয়ে পুনরায় চেষ্টা করুন। 24 ঘন্টার জন্য একই কী এবং বডি আবার পাঠানোর পরিবর্তে প্রথম উত্তর ফেরত দেয়।
আমি কি API কী ছাড়াই দাম পরীক্ষা করতে পারি?
হ্যাঁ। GET /v1/pricing এবং GET /v1/pricing/{country} পাবলিক, তাই একটি চেকআউট পৃষ্ঠা বা ড্যাশবোর্ড লাইভ দাম দেখাতে পারে।
আমার কোড কী পাঠিয়েছে তা আমি কোথায় দেখব?
কনসোলে আপনার শেষ 500 API কলের মেথড, পাথ, স্ট্যাটাস এবং সময় সহ একটি রিকোয়েস্ট লগ রয়েছে, ব্যাচ, মেসেজ এবং ওয়েবহুক লগের পাশে।
কনসোল
কোড লিখে না পাঠিয়ে কি পাঠানো সম্ভব?
হ্যাঁ। কনসোলে নম্বর পেস্ট করুন বা 50,000 সারি পর্যন্ত একটি CSV ফাইল আপলোড করুন, মার্জ ফিল্ড সহ টেক্সট লিখুন, প্রতিটি প্রাপকের জন্য প্রিভিউ এবং দেশ প্রতি খরচ পরীক্ষা করুন, এবং এখন বা নির্দিষ্ট সময়ে পাঠান।
কনসোল কী দেখায়?
ব্যালেন্স, লাইভ কাউন্ট সহ সাম্প্রতিক ব্যাচ, প্রতিটি ব্যাচের মেসেজ এবং স্ট্যাটাস, টপ-আপ এবং লেজার, API কী, ওয়েবহুক সেটিংস এবং ডেলিভারি, রিকোয়েস্ট লগ, প্রাইস লিস্ট, সাপোর্ট টিকেট এবং সেটিংস।
আমি কিভাবে সাপোর্টে যোগাযোগ করব?
কনসোলের সাপোর্ট পৃষ্ঠা থেকে। পেমেন্ট সম্পর্কিত প্রশ্ন প্রথম দিন থেকেই জিজ্ঞাসা করা যাবে; অন্যান্য বিষয়গুলি প্রথম টপ-আপ ক্রেডিট হওয়ার পরে খুলবে।
এখনও একটি প্রশ্ন আছে?
সাইন-ইন করা অ্যাকাউন্টগুলি কনসোল থেকে একটি সাপোর্ট টিকেট খুলতে পারে। পেমেন্ট সম্পর্কিত প্রশ্ন প্রথম দিন থেকেই জিজ্ঞাসা করা যাবে।