إرسال الرسائل عبر API

يمكنك إرسال رسائل واتساب برمجيًا من تطبيقك أو موقعك باستخدام API رابط CRM.

تأكد أولًا من أن لديك مفتاح API صالح واتصال واتساب نشط.

---

إرسال رسالة نصية

الطلب:

POST https://rabtcrm.com/api/v1/messages/send
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

الجسم (Body):

{
  "instanceName": "اسم_الاتصال",
  "to": "201012345678",
  "message": "مرحبًا! هذه رسالة من رابط CRM."
}

الحقول:

الحقل	النوع	الوصف
instanceName	string	اسم اتصال واتساب (من صفحة الاتصالات)
to	string	رقم المستلم بالصيغة الدولية بدون +
message	string	نص الرسالة

الاستجابة عند النجاح:

{
  "success": true,
  "messageId": "3EB0C767D360",
  "status": "sent"
}

---

إرسال صورة

{
  "instanceName": "اسم_الاتصال",
  "to": "201012345678",
  "type": "image",
  "mediaUrl": "https://example.com/image.jpg",
  "caption": "صورة المنتج الجديد 📦"
}

---

إرسال مستند (PDF)

{
  "instanceName": "اسم_الاتصال",
  "to": "201012345678",
  "type": "document",
  "mediaUrl": "https://example.com/invoice.pdf",
  "filename": "الفاتورة.pdf"
}

---

إرسال رسالة بأزرار تفاعلية

{
  "instanceName": "اسم_الاتصال",
  "to": "201012345678",
  "type": "buttons",
  "message": "كيف يمكننا مساعدتك؟",
  "buttons": [
    { "id": "1", "text": "الدعم الفني" },
    { "id": "2", "text": "تتبع الطلب" },
    { "id": "3", "text": "التحدث مع وكيل" }
  ]
}

---

إرسال لقائمة من الأرقام (Bulk)

لإرسال رسائل لأكثر من شخص، كرر الطلب أو استخدم الحملات من واجهة المنصة — الـ API مصمم للإرسال الفردي وليس الجماعي.

تحذير: إرسال رسائل جماعية بسرعة عالية قد يؤدي إلى حظر رقمك من واتساب. استخدم الحملات للإرسال الجماعي الآمن.

---

تتبع حالة الرسالة

الاستجابة تحتوي على messageId. يمكنك متابعة حالة التسليم من عرض المحادثة داخل المنصة:

الحالة	المعنى
sent	الرسالة أُرسلت من الخادم
delivered	الرسالة وصلت لهاتف المستلم
read	المستلم قرأ الرسالة ✓✓
failed	فشل الإرسال — راجع تفاصيل الخطأ

---

أمثلة كاملة

Node.js

const axios = require('axios');

await axios.post('https://rabtcrm.com/api/v1/messages/send', {
  instanceName: 'my-instance',
  to: '201012345678',
  message: 'مرحبًا من تطبيقي!',
}, {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});

PHP

$ch = curl_init('https://rabtcrm.com/api/v1/messages/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  'instanceName' => 'my-instance',
  'to'           => '201012345678',
  'message'      => 'مرحبًا من PHP!',
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer YOUR_API_KEY',
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

---

الخطوة التالية

← مشاكل الاتصال وحلولها