শিডিউল নয়, ঘটনাই এটি চালু করে
আপনার চেকআউট, আপনার ডিসপ্যাচ জব, আপনার পেমেন্ট হ্যান্ডলার — ঘটনাটি ঘটার মুহূর্তেই একটি কল করে। কোনো তালিকা বানাতে হয় না, কোনো ক্যাম্পেইন সাজাতে হয় না, আর সেন্ড চাপার কথা কারও মনে রাখতে হয় না।
অর্ডার আপডেট, রসিদ & অ্যালার্ট
যে মেসেজটির জন্য তাঁরা সত্যিই অপেক্ষা করছেন।
অর্ডার নিশ্চিত হয়েছে। ডেলিভারির পথে। পেমেন্ট পাওয়া গেছে। কার্ড বাতিল হয়েছে। নিউজলেটারের পেছনে কেউ ছোটে না, কিন্তু অর্ডারের পেছনে সবাই ছোটে — তাই ঘটনাটি ঘটার মুহূর্তেই এই মেসেজগুলো যেতে হবে, গ্রাহকের উপযোগী চ্যানেলে, ঠিক একবার, আর এমন রেকর্ডসহ যা পরে আপনি পড়ে দেখতে পারেন।
একটি এন্ডপয়েন্ট, তিনটি চ্যানেলপ্রতিটি মেসেজের ডেলিভারি অবস্থাপ্রতিটি ফলাফলে স্বাক্ষরিত ওয়েবহুক
Sending login codes or two-factor prompts? Those have their own page — ওয়ান-টাইম কোড ও যাচাইকরণ.
01সমস্যাটি
রসিদ নিউজলেটার নয়।
ক্যাম্পেইন টুল তৈরি হয় একসঙ্গে অনেক মানুষের কাছে অনেক মেসেজ পাঠানোর জন্য, আর পুরো ব্যাচটি কেমন করল তা জানানোর জন্য। ট্রানজেকশনাল মেসেজ ঠিক উল্টো ধরনের: একজন মানুষ, একটি ঘটনা, আর গুরুত্বপূর্ণ সংখ্যা একটিই — সেই একটি মেসেজ পৌঁছেছে কি না। QuickGrow বিষয়টিকে সেভাবেই দেখে।
পৌঁছেছে, তা আপনি দেখাতে পারবেন
প্রতিটি পাঠানোর সঙ্গে সেই একটি মেসেজের আইডি ফেরত আসে। পরে সেটি পড়ে জেনে নিন মেসেজটি কোন অবস্থায় পৌঁছেছে, কখন পৌঁছেছে, আর ব্যর্থ হলে তার কারণ ও কোড কী — ফলে “রসিদটি কি আমার কাছে পৌঁছেছে?” প্রশ্নের উত্তর সাপোর্ট টিম অনুমান না করে রেকর্ড থেকেই দিতে পারে।
আপনার রিট্রাই মানে তাঁর কাছে দ্বিতীয় মেসেজ নয়
রিকোয়েস্টের মাঝপথে সংযোগ বিচ্ছিন্ন হয়ে যায়। একই রিট্রাই কী দিয়ে আবার একই কল পাঠালে QuickGrow ২৪ ঘণ্টা পর্যন্ত নতুন করে না পাঠিয়ে আগের রেসপন্সটিই ফিরিয়ে দেয়। ফলে খারাপ নেটওয়ার্ক কখনও দুটি নিশ্চিতকরণ আর দুটি চার্জে পরিণত হয় না।
02কীভাবে কাজ করে
আপনার ঘটনা থেকে তাঁর ফোন পর্যন্ত।
চারটি ধাপ, আর তার মধ্যে কেবল প্রথমটিই সেটআপ। এরপর একটি মেসেজ মানে একটি কল, আর সেটি সম্পর্কে যা জানার দরকার তার সবই একটি রিড।
কী তৈরি করুন, সীমা বেঁধে দিন
একটি এপিআই কী তৈরি করুন এবং কাজের জন্য যতটুকু দরকার ঠিক ততটুকুই অনুমতি দিন। পাঠানো, মেসেজের স্ট্যাটাস পড়া আর ওয়েবহুক ব্যবস্থাপনা — এই তিনটি আলাদা অনুমতি। ফলে যে সার্ভিস অর্ডার নিশ্চিতকরণ পাঠায়, সেটি কখনও আপনার কন্টাক্ট এক্সপোর্ট করার অধিকার বহন করে না।
একটি এন্ডপয়েন্টে কল করুন
চ্যানেল, প্রাপক, আর হয় লেখাটি সরাসরি অথবা টেমপ্লেট আইডির সঙ্গে বসানোর মানগুলো পোস্ট করুন। ইমেইল পাঠানোর সঙ্গে ফাইলও যেতে পারে — সর্বোচ্চ দশটি, সব মিলিয়ে সাত মেগাবাইট — ফলে ইনভয়েসটি আলাদা মেসেজে না গিয়ে নিশ্চিতকরণের সঙ্গেই যায়।
ফলাফল বুঝে নিন
রেসপন্সে থাকে মেসেজ আইডি আর মেসেজটি কোন অবস্থায় আছে। এরপর দরকারমতো সেই আইডি পড়ুন, অথবা ওয়েবহুক সাবস্ক্রাইব করুন — মেসেজটি sent, delivered, failed বা bounced হওয়ার মুহূর্তেই QuickGrow আপনাকে জানিয়ে দেবে।
যখন খুশি মিলিয়ে নিন
চ্যানেল, অবস্থা ও তারিখ দিয়ে ফিল্টার করে আপনার ইতিহাস দেখুন, অথবা একটি নির্দিষ্ট সময়ের জন্য চ্যানেলভিত্তিক মোট হিসাব চান। কিছুই আপনার এন্ডপয়েন্ট সচল থাকার উপর নির্ভর করে না: কোনো ওয়েবহুক আপনার কাছে না পৌঁছালেও রেকর্ডটি পড়ার জন্য সেখানেই থাকে।
03একটি কল
পাঠান। তারপর খুঁজে দেখুন।
একটি কী হেডার প্রতিটি রিকোয়েস্ট অথেনটিকেট করে। পাঠানোটি একটিই কল; এরপর যা কিছু, সবই সেই কলের দেওয়া আইডির বিপরীতে একটি রিড।
POST /api/v1/messages
X-API-Key: mk_… { "channel": "email", "to": "[email protected]", "templateId": "order_confirmed", "variables": { "name": "Rumana", "orderId": "A-4471", "eta": "Tue 27 Aug" }, "attachments": [ { "filename": "receipt.pdf", "content": "JVBERi0xLjQK…" } ], "metadata": { "orderId": "A-4471" } } # same shape for "sms" and "whatsapp"
GET /api/v1/messages/:id
{ "data": {
"id": "msg_9fA2",
"channel": "email",
"status": "delivered",
"createdAt": "2026-08-24T11:02:04Z",
"sentAt": "2026-08-24T11:02:07Z",
"deliveredAt": "2026-08-24T11:02:11Z",
"failedAt": null,
"failureReason": null,
"failureCode": null,
"metadata": { "orderId": "A-4471" }
} }
# list: GET /api/v1/messages?status=failedপ্রতি কী-তে মিনিটে 1,000 রিকোয়েস্টপ্রতিটি রেসপন্সে সীমা, কতটা বাকি আর রিসেটের সময়আপনার নিজের অর্ডার আইডি ফেরত আসেনামযুক্ত এরর কোড, প্রতিটি ডকুমেন্টেশনের সঙ্গে লিঙ্ক করা
টেমপ্লেট ও ডকুমেন্টেশন
লেখাটি আপনার কোডের ভেতরে থাকে না।
নিশ্চিতকরণের লেখাটি একবার QuickGrow-এ টেমপ্লেট হিসেবে লিখুন, তারপর মান বসিয়ে আইডি দিয়ে পাঠান। কেউ যখন ডেলিভারি মেসেজের ভাষা বদলাতে চান বা রিটার্ন নিয়ে একটি লাইন যোগ করতে চান, তিনি টেমপ্লেটটিই সম্পাদনা করেন — কাউকে রিলিজের জন্য অপেক্ষা করতে হয় না। প্রতিটি এন্ডপয়েন্ট, ফিল্ড ও এরর প্রোডাক্টের ভেতরেই লেখা আছে এবং মেশিন-পাঠযোগ্য স্পেসিফিকেশন হিসেবে প্রকাশিত, যা আপনি নিজের টুলিংয়ে ইমপোর্ট করতে পারেন।
- আইডি দিয়ে টেমপ্লেট রেফারেন্স করুন আর তার প্লেসহোল্ডারগুলোর জন্য মান পাঠান; কোনো প্লেসহোল্ডার বাদ দিলে সেটি ফাঁকা হিসেবে ছাপা না হয়ে যেমন আছে তেমনই থাকে।
- লেখাটি নিজের রিপোজিটরিতে রাখতে চাইলে এপিআই দিয়েও টেমপ্লেট তৈরি ও তালিকাভুক্ত করতে পারেন।
- ইমেইল পাঠানোর সময় প্রেরকের নাম আর reply-to ঠিকানা ঠিক করে দিন, যাতে রসিদটি দেখতে আপনার কাছ থেকেই আসা মনে হয় এবং উত্তরটি একজন মানুষের কাছে পৌঁছায়।
04Failures
কোনো কিছুই চুপচাপ ব্যর্থ হয় না।
QuickGrow আপনার অজান্তে চ্যানেল বদলাবে না, কিংবা গ্রাফ সুন্দর দেখাতে কোনো সমস্যা চেপে যাবে না। পাঠানো ব্যর্থ হলে তা স্পষ্টভাবেই ব্যর্থ হয়: মেসেজটির সঙ্গে কারণ ও কোড থেকে যায়, আর আপনার এন্ডপয়েন্টে একটি স্বাক্ষরিত ওয়েবহুক পৌঁছায় — এরপর কী হবে তা আপনার সিস্টেম ঠিক করতে পারে।
চারটি ইভেন্ট, কেবল আপনারগুলোই
Sent, delivered, failed আর bounced। কেবল এপিআই দিয়ে পাঠানো মেসেজগুলোই এই ইভেন্টগুলো তৈরি করে, তাই আপনার এন্ডপয়েন্ট কখনও ক্যাম্পেইনের ট্রাফিকে চাপা পড়ে না।
স্বাক্ষরিত, তাই ভরসা করতে পারেন
প্রতিটি ডেলিভারি এমন একটি সিক্রেট দিয়ে স্বাক্ষরিত যা কেবল আপনি আর QuickGrow জানেন, আর সেই সিক্রেট যখন খুশি বদলে নিতে পারেন। নতুন কোনো এন্ডপয়েন্টের উপর নির্ভর করার আগে সেখানে একটি টেস্ট ইভেন্ট পাঠিয়ে দেখুন।
আপনি ডাউন থাকলে আবার চেষ্টা করা হয়
যে এন্ডপয়েন্ট সাড়া দেয় না, পরবর্তী আধা ঘণ্টা জুড়ে সেটিতে আরও চারবার চেষ্টা করা হয়, আর প্রতিটি চেষ্টার রেকর্ড আপনার দেখার জন্য রাখা থাকে।
আবার পাঠানোর সিদ্ধান্ত আপনার
ব্যর্থ মেসেজ সেখানেই থেমে যায়। একই আপডেট অন্য চ্যানেলে পাঠাতে চাইলে সেই কলটি আপনার কোড করবে — অর্থাৎ লেখা, সময় আর আদৌ পাঠানো হবে কি না, সবই আপনি ঠিক করবেন।
POST https://yourshop.example/hooks
{
"id": "evt_7c1e…",
"event": "message.failed",
"createdAt": "2026-08-24T11:03:02Z",
"data": { "message": {
"id": "msg_9fA2",
"channel": "sms",
"status": "failed",
"failedAt": "2026-08-24T11:03:01Z",
"failureReason": "…",
"failureCode": "…",
"metadata": { "orderId": "A-4471" }
} }
}
# message.sent · delivered · failed · bounced
যা আপনি পড়ে দেখতে পারবেন
প্রতিটি পাঠানো এমন একটি সারি, যা আপনি কোয়েরি করতে পারেন।
মেসেজের অবস্থা এমন কোনো রিপোর্ট নয় যার জন্য সারারাত অপেক্ষা করতে হয় — এটি মেসেজের নিজেরই একটি ফিল্ড। আইডি দিয়ে একটি মেসেজ পড়ুন, চ্যানেল, অবস্থা ও তারিখ দিয়ে ফিল্টার করে তালিকা দেখুন, অথবা একটি সময়ের জন্য চ্যানেলভিত্তিক মোট হিসাব চান — একটি রেসপন্সেই sent, delivered, opened, clicked, bounced ও failed সংখ্যা পেয়ে যাবেন।
- প্রতিটি মেসেজে তৈরি, পাঠানো, ডেলিভারি ও ব্যর্থতার সময়, আর ব্যর্থতার পেছনের কারণ ও কোড।
- চ্যানেল, অবস্থা ও তারিখের সীমা দিয়ে আপনার ইতিহাস ফিল্টার করুন, আর কার্সর দিয়ে একবারে একশোটি পর্যন্ত পেজ করে দেখুন।
- আপনার নিজের রেফারেন্স মেসেজের সঙ্গেই যায় এবং প্রতিটি স্ট্যাটাস রিড ও প্রতিটি ওয়েবহুকে ফিরে আসে — অর্ডার আইডি জুড়ে দিন, তাহলে ফোন নম্বর মিলিয়ে কিছু খুঁজতে হবে না।
05কোন চ্যানেল
প্রতিটি মেসেজের জন্য চ্যানেল বেছে নিন।
তিনটিই একই এন্ডপয়েন্ট থেকে যায় এবং একইভাবে রিপোর্ট করে, তাই চ্যানেল বাছাই মানে আপনার রিকোয়েস্টের একটি ফিল্ড, আলাদা কোনো ইন্টিগ্রেশন নয়। আসল পার্থক্য হলো, মেসেজ বহন করার আগে প্রতিটি চ্যানেল আপনার কাছ থেকে কী চায়।
| SMS | |||
|---|---|---|---|
| Suits | নিশ্চিতকরণ, রসিদ, ইনভয়েস, স্টেটমেন্ট | ফোনে ছোট, জরুরি আপডেট | গ্রাহকের শুরু করা কথোপকথনের ভেতরে উত্তর |
| ফাইল বহন করতে পারে, যেমন ইনভয়েস | Yes | No | No |
| রাতের যেকোনো সময় পাঠানো যায় | Yes | No | No |
| আগে ওই কন্টাক্টের বিপরীতে সম্মতি রেকর্ড থাকা দরকার | No | Yes | No |
| কন্টাক্টপ্রতি সীমা ও কুলডাউন প্রযোজ্য | No | Yes | Yes |
| কেবল আপনাকে পাঠানো তাঁর শেষ মেসেজের ২৪ ঘণ্টার মধ্যে | No | No | Yes |
| দেখে মনে হয় কার কাছ থেকে এসেছে | আপনার যাচাই করা ডোমেইন, নিজের প্রেরক নাম ও reply-to সহ | অনুমোদন পাওয়ার পর আপনার নিজস্ব প্রেরক নাম — তার আগ পর্যন্ত ডিফল্ট প্রেরক | আপনার যুক্ত করা হোয়াটসঅ্যাপ বিজনেস নম্বর |
| প্রতিটি মেসেজের জন্য পড়ে দেখা যায় এমন স্ট্যাটাস | Yes | Yes | Yes |
| ডেলিভারি ওয়েবহুক | Yes | Yes | Yes |
| নিজের প্রোভাইডার আনুন, অথবা ম্যানেজড প্রোভাইডার ব্যবহার করুন | Yes | Yes | Yes |
রাতের বেলা পাঠানো আটকে রাখা আর কন্টাক্টপ্রতি সীমা রাখা হয়েছে, কারণ রাত ২টায় ফোনে মেসেজ মানে অভিযোগ ডেকে আনা। এ কারণেই অর্ডার নিশ্চিতকরণের জায়গা ইমেইল, আর ডেলিভারি পৌঁছে গেছে ধরনের অ্যালার্টের জায়গা দিনের বেলার এসএমএস — আর কোনো মেসেজ আটকে রাখা হলে QuickGrow তা স্পষ্ট করে জানিয়ে দেয়, পাঠানো হয়েছে বলে ভান করে না।
06আপনি কী পাচ্ছেন
প্যাকেজের ভেতরে যা যা আছে।
Sending
- ইমেইল, এসএমএস ও হোয়াটসঅ্যাপের জন্য একটিই এন্ডপয়েন্ট — একই রিকোয়েস্ট, চ্যানেলটি সেখানে একটি ফিল্ড।
- লেখা সরাসরি দিন, অথবা আইডি দিয়ে টেমপ্লেট রেফারেন্স করে নিজের ভেরিয়েবলগুলো বসিয়ে দিন।
- একটি ইমেইলে সর্বোচ্চ দশটি ফাইল ও সাত মেগাবাইট, যাতে ইনভয়েসটি নিশ্চিতকরণের সঙ্গেই যায়।
কী ঘটেছে তা জানা
- প্রতিটি মেসেজে স্ট্যাটাসের সঙ্গে পাঠানো, ডেলিভারি ও ব্যর্থতার সময়।
- ব্যর্থতার পেছনে একটি কারণ ও একটি কোড, যাতে ভুল নম্বর আর অচল গেটওয়ে একরকম দেখতে না লাগে।
- চ্যানেল, অবস্থা ও তারিখ দিয়ে ফিল্টার করা আপনার পুরো মেসেজ ইতিহাস।
সবকিছু গোছানো রাখা
- সীমিত অনুমতির কী — পাঠানো, স্ট্যাটাস পড়া আর ওয়েবহুক ব্যবস্থাপনা আলাদা আলাদা অনুমতি।
- ডিফল্টভাবে প্রতি কী-তে মিনিটে 1,000 রিকোয়েস্ট, আর প্রতিটি রেসপন্সে সীমা, কতটা বাকি আছে ও রিসেটের সময়।
- প্রতিটি প্রত্যাখ্যানের সঙ্গে একটি নামযুক্ত কোড, প্রতিটির সঙ্গে সেই পেজের লিঙ্ক যেখানে তার ব্যাখ্যা আছে।
07Questions
যুক্ত করার আগে।
ক্যাম্পেইন পাঠানোর সঙ্গে এর পার্থক্য কোথায়?
ক্যাম্পেইন একটি তালিকায় শিডিউল অনুযায়ী যায় এবং ব্যাচ হিসেবে মাপা হয়। ট্রানজেকশনাল সেন্ড হলো একটি ঘটনা নিয়ে একটি কল, যা আপনার সিস্টেম ঘটনার মুহূর্তেই করে এবং যা একটি মেসেজ হিসেবেই মাপা হয়। দুটোই একই মেসেজ ইতিহাসে জমা হয়, তাই পুরো ছবিটা আপনি দেখতে পান — তবে কেবল এপিআই সেন্ডই ওয়েবহুক তৈরি করে, তাই মার্কেটিং ট্রাফিকে আপনার এন্ডপয়েন্ট ভেসে যায় না।
আমার রিকোয়েস্ট টাইম আউট হলে গ্রাহক কি দুটি নিশ্চিতকরণ পাবেন?
সঙ্গে রিট্রাই কী পাঠালে পাবেন না। ২৪ ঘণ্টার মধ্যে একই কী দিয়ে একই রিকোয়েস্ট আবার পাঠান, QuickGrow নতুন করে না পাঠিয়ে আগের রেসপন্সটিই ফিরিয়ে দেবে — ফলে সংযোগ বিচ্ছিন্ন হলে আপনার কিছুই খরচ হয় না। একই কী অন্য কোনো এন্ডপয়েন্টে ব্যবহার করলে, কিংবা প্রথম রিকোয়েস্ট চলার সময়েই আবার ব্যবহার করলে, অপ্রত্যাশিত কিছুর বদলে আপনি স্পষ্ট একটি কনফ্লিক্ট ফেরত পাবেন।
রসিদটি কি PDF হিসেবে অ্যাটাচ করা যাবে?
হ্যাঁ, ইমেইলে যাবে। মেসেজের সঙ্গে ফাইল পাঠান — ডিকোড করার পর সর্বোচ্চ দশটি ফাইল ও সব মিলিয়ে সাত মেগাবাইট। এর বেশি হলে কলটি সঙ্গে সঙ্গেই এমন একটি এররসহ ফেরত আসে যেখানে সীমাটি বলা থাকে; গ্রহণ করে নিয়ে পরে এমন কোথাও ব্যর্থ হয় না যেদিকে আপনি কখনও তাকান না। এসএমএস ও হোয়াটসঅ্যাপ সেন্ড ফাইল বহন করতে পারে না, তাই সেখানে ডকুমেন্টের লিঙ্ক দিন।
তাঁরা যে মেসেজটির জন্য অপেক্ষা করছেন, সেটি পাঠান।
একটি অ্যাকাউন্ট তৈরি করুন, সীমিত অনুমতির একটি কী বানান, আর আপনার প্রথম অর্ডার নিশ্চিতকরণ পোস্ট করুন। তিনটি চ্যানেলের জন্য একটি এন্ডপয়েন্ট, আর প্রতিটি মেসেজের এমন রেকর্ড যা আপনি পড়ে দেখতে পারবেন।