Website, CRM, ecommerce বা internal software থেকে SMS পাঠাতে API integration দরকার। Production integration শুধু POST request নয়—secret storage, input validation, idempotency, rate control, async status এবং webhook verification একসঙ্গে design করতে হয়। Bartago-তের API dashboard-এর একই ownership rule ব্যবহার করে; external system named API key দিয়ে contact, campaign, device ও analytics workflow চালাতে পারে।
Authentication নিরাপদ করুন
এক integration, এক key
Named key তৈরি করে শুধু এক service-এ দিন, source control বা frontend bundle-এ রাখবেন না। expiration ও rotation plan করুন এবং usage শেষ হলে revoke করুন।
Request contract বুঝুন
Validation error actionable করুন
OpenAPI docs থেকে schema দেখুন। phone normalize, required field, device selection ও analytics flag validate করে request পাঠান। duplicate operation ঠেকাতে stable external reference বা idempotency key রাখুন।
- HTTPS only
- Bearer key on server
- Timeout + bounded retry
- Idempotent business ID
Async result handle করুন
Accepted মানে sent নয়
Campaign create/start response queue state জানায়। final sent/failed status webhook বা status API থেকে নিন। retryable ও permanent error আলাদা করে alert করুন।
ব্যবহারিক checklist
- Dedicated API key
- Secret manager
- Schema validation
- Idempotency
- Webhook/status handler
মূল takeaway
ভালো SMS API integration request পাঠানোর চেয়ে বেশি—result reconciliation পর্যন্ত complete।
শেষ কথা
প্রথমে sandbox-like test workspace ও test contacts দিয়ে happy path, validation error, timeout এবং duplicate retry পরীক্ষা করুন। OpenAPI version pin করুন এবং response contract বদলালে integration test চালান। API key কখনো browser বা mobile public code-এ embed করবেন না।
Campaign চালুর আগে consent, mobile operator policy এবং প্রযোজ্য current নিয়ম যাচাই করুন।
১০০ free automation credit দিয়ে শুরু করুন →সাধারণ প্রশ্ন
API response পেলেই SMS sent?
না। create/start সাধারণত queue acceptance জানায়; final radio result status callback বা webhook-এ আসে।
API key Flutter app-এ রাখব?
User-facing app bundle-এ long-lived workspace API key রাখা উচিত নয়; নিজের backend দিয়ে proxy করুন বা scoped device credential ব্যবহার করুন।
Sources ও editorial note
সর্বশেষ editorial review: ২৮ জুলাই, ২০২৬। Product behavior release অনুযায়ী বদলাতে পারে; current documentation দেখুন।