إرسال رسائل واتساب من نظامك عبر واجهة SendsBot البرمجية
باختصار: من «الإعدادات» تبويب «API & Webhook» ينشئ صاحب الحساب مفتاحاً يظهر مرة واحدة، وحتى 5 مفاتيح فعّالة. كل طلب يحمل المفتاح في ترويسة
Authorization. الواجهة فيها أربعة طلبات: قائمة الأجهزة، وإرسال رسالة (نص أو صورة أو مستند)، وجلب جهة اتصال، وإضافة جهة أو تحديثها. الحد 60 طلباً في الدقيقة لكل مفتاح. وافتراضياً لا ترسل إلا لمن راسل رقمك من قبل. الواجهة متاحة في الخطط التي تتضمنها.
متجر له نظام طلبات خاص به يريد أن يرسل للعميل «تم شحن طلبك» من النظام نفسه، لا أن ينسخ الرقم ويرسل يدوياً. الواجهة البرمجية تجعل رقمك المربوط في SendsBot قناة إرسال لنظامك.
قبل أول طلب
- أنشئ مفتاحاً: «إنشاء مفتاح» باسم يدلك على استخدامه، مثل «نظام المتجر». انسخه فوراً؛ لا يظهر مرة أخرى.
- احفظه في الخادم لا في المتصفح. من يملك المفتاح يرسل باسم رقمك.
- إلغاء المفتاح نهائي. أي نظام يستخدمه يتوقف فوراً، ولا يمكن إعادة تفعيله.
الطلبات الأربعة
مثال توضيحي: متجر افتراضي بنظام طلبات خاص، يرسل إشعار الشحن من نظامه.
| الطلب | ماذا يفعل |
|---|---|
GET /api/v1/devices | أجهزتك المربوطة وحالتها |
POST /api/v1/messages | رسالة نص (حتى 4096 حرفاً)، أو صورة برابط https مع تعليق، أو مستند |
GET /api/v1/contacts?phone= | جهة اتصال واحدة برقمها |
POST /api/v1/contacts | إضافة جهة أو تحديثها، مع وسوم تُضاف ولا تُحذف |
مثال إرسال نص «تم شحن طلبك»:
- الطلب:
POST https://www.sendsbot.com/api/v1/messages - الترويسة:
Authorization: Bearer sbk_... - الجسم:
{"device_id": "...", "to": "966501234567", "type": "text", "text": "..."}
الرد الناجح يعيد رقم الرسالة وحالتها sent. والتفاصيل الكاملة للحقول في صفحة «توثيق API» داخل لوحتك.
لمن تستطيع الإرسال؟
افتراضياً: فقط للأرقام التي راسلت هذا الجهاز من قبل. هذا يغطي أغلب استخدامات المتاجر: عميل طلب ثم تتابع معه.
«السماح بالإرسال لأي رقم»: يفعّله صاحب الحساب بعد تأكيد صريح بأن الإرسال لأرقام لم تراسلك أشهر أسباب حظر الأرقام. وحتى بعدها، يبقى الحد اليومي للرقم وقفل الرقم ووتيرة الحملات مطبّقة على هذه الأرقام.
والرقم الذي طلب إيقاف الرسائل التسويقية يُرفض دائماً.
جدول الأخطاء الأهم
| الرمز | المعنى |
|---|---|
RATE_LIMITED | تجاوزت 60 طلباً في الدقيقة لهذا المفتاح |
PLAN_FEATURE_LOCKED | الواجهة غير متاحة في خطتك |
RECIPIENT_NOT_ALLOWED | الرقم لم يراسلك، والإرسال لأي رقم غير مفعّل |
RECIPIENT_OPTED_OUT | الرقم طلب إيقاف الرسائل التسويقية |
DAILY_LIMIT_REACHED | وصل الرقم لحده اليومي |
NUMBER_LOCKED | الرقم مقفل بعد تقييد |
ما لا تفعله الواجهة
- لا ترسل صوتاً ولا فيديو.
- لا تنشئ حملات.
- لا تعرض قائمة كل جهات الاتصال ولا تحذفها.
- رسائلها تُحسب من رسائل باقتك كأي رد يدوي.
أسئلة شائعة
أين أجد مفتاح الواجهة البرمجية؟
في «الإعدادات»، تبويب «API & Webhook»، بطاقة «مفاتيح API». تظهر لصاحب الحساب فقط.
هل أستطيع الإرسال لأي رقم؟
افتراضياً لا، فقط لمن راسلك. يمكن لصاحب الحساب السماح بذلك بعد تأكيد التحذير، مع بقاء الحد اليومي مطبقاً.
هل أستطيع إنشاء حملة من الواجهة؟
لا. الواجهة ترسل رسائل فردية، والحملات من لوحة التحكم.
كم طلباً أستطيع في الدقيقة؟
60 طلباً لكل مفتاح، وبعدها يعود الرد بالرمز RATE_LIMITED.
الخلاصة
ابدأ بإشعار واحد لعملاء راسلوك فعلاً، مثل تأكيد الشحن، قبل أي استخدام أوسع. واحفظ المفتاح في خادمك، وأنشئ مفتاحاً لكل نظام حتى تلغيه وحده عند الحاجة.
اقرأ عن الحد اليومي لرقم واتساب، وعن صلاحيات الموظفين، وعن ميزة الواجهة البرمجية.