---
title: ডেভেলপারদের জন্য WhatsApp REST API আর ওয়েবহুক | SaleMag
description: SaleMag-এর REST API দিয়ে কন্টাক্ট সামলান, WhatsApp ও SMS পাঠান,
  ক্যাম্পেইন চালান, এআই বটের সাথে চ্যাট করুন, অটোমেশন চালু করুন। সাইন করা
  ওয়েবহুকও আছে।
url: https://salemag.net/bn/features/developer-api
language: bn
published: 2026-10-21
updated: 2026-10-21
author: সেলম্যাগ টিম
tags:
  - ডেভেলপার এপিআই
  - হোয়াটসঅ্যাপ এপিআই
  - rest api
  - ওয়েবহুক
---

# ডেভেলপারদের জন্য WhatsApp REST API আর ওয়েবহুক | SaleMag

> SaleMag-এর REST API আছে /api/v1-এ, বেয়ারার টোকেন আর ১২টা পারমিশন স্কোপসহ। কন্টাক্ট তৈরি ও আপডেট, সেগমেন্ট আর কথোপকথন পড়া, WhatsApp ও SMS পাঠানো, ক্যাম্পেইন চালু, এআই চ্যাটবটের সাথে চ্যাট, নলেজ বেসে ডকুমেন্ট যোগ, অটোমেশন চালু আর সোশ্যাল পোস্ট শিডিউল করা যায়। সাইন করা ওয়েবহুক আপনার সার্ভারে ইভেন্ট পাঠায়।

- /api/v1-এ বেয়ারার টোকেন API, OpenAPI 3.1 ডকুমেন্ট /api/v1/openapi.json-এ।
- টোকেনে contacts:write, messages:write এর মতো স্কোপ, মেয়াদ দেওয়া যায়, দেখায় শুধু একবার।
- এক এন্ডপয়েন্ট দিয়ে নিজের সিস্টেম থেকে WhatsApp (টেমপ্লেট বা টেক্সট) আর SMS পাঠান।
- ওয়েবহুক HMAC-SHA256 দিয়ে সাইন করা, পাঁচবার পর্যন্ত রিট্রাই।
- প্রতি ইউজারে মিনিটে ৬০টা রিকোয়েস্ট, 429-এ স্ট্যান্ডার্ড রেট-লিমিট হেডার।

বাড়তে থাকা ব্যবসা কখনো এক টুলে থাকে না। আপনার অর্ডার সিস্টেম, ERP, ওয়েবসাইটের ফর্ম বা নিজের অ্যাপকে কন্টাক্ট বানাতে, WhatsApp আপডেট পাঠাতে বা কাস্টমার মেসেজ দিলে জানতে হয়। API না থাকলে কাউকে এক স্ক্রিন থেকে আরেক স্ক্রিনে কপি করতে হয়।

SaleMag-এর ডেভেলপার API আপনার সিস্টেমকে টিমের ব্যবহার করা একই ইনবক্স, CRM, ক্যাম্পেইন আর এআই-এর সাথে যুক্ত করে।

## SaleMag API দিয়ে কী করা যায়?

সব এন্ডপয়েন্ট `/api/v1`-এর নিচে, JSON দেয়।

| বিষয় | এন্ডপয়েন্ট |
|---|---|
| অ্যাকাউন্ট | `GET /me`, টোকেন লিস্ট, তৈরি, ডিলিট |
| কন্টাক্ট | লিস্ট, তৈরি, পড়া, আপডেট, ডিলিট |
| সেগমেন্ট | লিস্ট, তৈরি, সেগমেন্টের কন্টাক্ট |
| ক্যাম্পেইন | লিস্ট, তৈরি, পড়া, launch, pause, রিসিপিয়েন্ট |
| মেসেজ | `POST /messages/send`: WhatsApp (টেমপ্লেট বা টেক্সট) আর SMS |
| কথোপকথন | কথোপকথনের লিস্ট আর মেসেজ |
| ওয়েবহুক | এন্ডপয়েন্ট লিস্ট, তৈরি, ডিলিট |
| এআই | চ্যাটবট লিস্ট, বটের সাথে চ্যাট, নলেজ বেস আর ডকুমেন্ট |
| অটোমেশন | লিস্ট, কোনো কন্টাক্টের জন্য চালু |
| সোশ্যাল | অ্যাকাউন্ট লিস্ট, পোস্ট পাবলিশ বা শিডিউল |

পূর্ণ তালিকা প্যারামিটার আর উদাহরণসহ আছে `/api/v1/openapi.json`-এ আর অ্যাপের API reference পেজে।

## অথেনটিকেশন কীভাবে কাজ করে?

API Tokens পেজে টোকেন বানিয়ে হেডারে পাঠান:

```
Authorization: Bearer {token}
```

- টোকেন হ্যাশ করে রাখা হয়, একবারই দেখায়।
- মেয়াদের তারিখ দেওয়া যায়।
- ১২টা স্কোপ: `contacts:read`, `contacts:write`, `campaigns:read`, `campaigns:write`, `messages:write`, `conversations:read`, `webhooks:write`, `ai:read`, `ai:write`, `automations:write`, `social:write`, `analytics:read`, আর পুরো অ্যাক্সেসের জন্য `*`।
- সদস্যের ওয়ার্কস্পেস রোলও খাটে, তাই টোকেন তার মালিকের চেয়ে বেশি কিছু করতে পারে না।

## নিজের সিস্টেম থেকে WhatsApp মেসেজ পাঠাব কীভাবে?

`messages:write` স্কোপসহ `POST /api/v1/messages/send` কল করুন। [WhatsApp Cloud API](https://salemag.net/bn/glossary/whatsapp-cloud-api)-র নিয়ম খাটে: [২৪ ঘণ্টার উইন্ডোর](https://salemag.net/bn/glossary/24-hour-window) বাইরে অনুমোদিত টেমপ্লেট লাগে। কাস্টমারের উত্তর আসে [শেয়ার্ড ইনবক্সে](https://salemag.net/bn/features/shared-inbox)। API দিয়ে ইমেইল পাঠানো এখনো নেই।

## ওয়েবহুক কীভাবে কাজ করে?

Webhooks পেজে HTTPS এন্ডপয়েন্ট যোগ করে ইভেন্ট বেছে নিন: `contact.created`, `message.received`, `campaign.completed` আর টেস্টের জন্য `test.ping`।

প্রতিটি ডেলিভারি JSON POST, সাথে `X-Webhook-Event` আর `X-Webhook-Signature` হেডার: `t={timestamp},v1={HMAC-SHA256}`, আপনার `whsec_` সিক্রেট দিয়ে সাইন করা। ১০ সেকেন্ডে টাইমআউট, পাঁচবার পর্যন্ত রিট্রাই (১ মিনিট, ৫ মিনিট, ১ ঘণ্টা, ১ দিন, ১ দিন পর)। সিক্রেট বদলানো, ডেলিভারি লগ দেখা আর এন্ডপয়েন্ট চালু-বন্ধ করা যায়।

অর্ডার বা কার্টের ইভেন্ট নিতে [অটোমেশন ফ্লো বিল্ডারের](https://salemag.net/bn/features/automation-flow-builder) HTTP রিকোয়েস্ট ধাপ ব্যবহার করুন।

## সীমা কত?

- প্রতি ইউজারে পুরো `/api/v1`-এ মিনিটে ৬০টা রিকোয়েস্ট।
- `/messages/send`-এ আলাদা মিনিটে ৬০টা।
- 429 রেসপন্সে `Retry-After`, `X-RateLimit-Limit` আর `X-RateLimit-Remaining`।

ইন্টিগ্রেশন প্ল্যান করতে সাহায্য লাগলে [যোগাযোগ করুন](https://salemag.net/bn/contact), অথবা দেখুন [ইন্টিগ্রেশন](https://salemag.net/bn/integrations) আর [দাম](https://salemag.net/bn/pricing)।

## FAQ

### SaleMag API-তে অথেনটিকেশন কীভাবে?

API Tokens পেজে পার্সোনাল অ্যাক্সেস টোকেন বানিয়ে Authorization: Bearer {token} হেডারে পাঠান। টোকেন হ্যাশ করে রাখা হয়, একবারই দেখায়, মেয়াদ আর স্কোপ ঠিক করা যায়। ওয়ার্কস্পেস রোলও প্রযোজ্য।

### OpenAPI বা Swagger স্পেক আছে?

হ্যাঁ। OpenAPI 3.1 ডকুমেন্ট পাবলিক /api/v1/openapi.json-এ, আর অ্যাপের API reference পেজে প্রতিটি এন্ডপয়েন্টের curl উদাহরণ আছে।

### API দিয়ে WhatsApp মেসেজ পাঠানো যায়?

হ্যাঁ। messages:write স্কোপসহ POST /api/v1/messages/send দিয়ে WhatsApp টেমপ্লেট বা টেক্সট, অথবা SMS পাঠান। WhatsApp-এর নিয়ম মেনে ২৪ ঘণ্টার বাইরে টেমপ্লেট লাগে।

### কোন কোন ওয়েবহুক ইভেন্ট আছে?

contact.created, message.received আর campaign.completed, সাথে ড্যাশবোর্ড থেকে test.ping। প্রতিটি ডেলিভারি X-Webhook-Signature হেডারে সাইন করা।

### রেট লিমিট কত?

প্রতি ইউজারে পুরো API-তে মিনিটে ৬০টা রিকোয়েস্ট, মেসেজ পাঠানোয় আলাদা মিনিটে ৬০টা। 429 রেসপন্সে Retry-After আর X-RateLimit হেডার থাকে।

### SDK আছে?

অফিশিয়াল SDK নেই। API হলো HTTPS-এ সাধারণ JSON, OpenAPI ডকুমেন্ট থেকে ক্লায়েন্ট জেনারেট করে নিতে পারেন।