Botassium - REST API

واجهة برمجة التطبيقات API

المراسلة الآمنة من التطبيقات الخارجية

كيفية استخدام ميزة واجهة API في بوتاسيوم

توفر لك واجهة Botassium API إمكانية إرسال رسائل واتساب مباشرة من أنظمتك الخاصة باستخدام طلب HTTP POST بسيط. كل بوت في Botassium يمتلك نقطة نهاية (Endpoint) خاصة به، ويمكنك العثور عليها داخل تبويب "API" في إعدادات البوت.

باستخدام بضع أسطر فقط من JSON، يمكنك إرسال رسائل نصية، وسائط، مواقع جغرافية، بطاقات جهات اتصال، استطلاعات، ورسائل تفاعلية من موقعك الإلكتروني أو الـCRM أو نظامك الخلفي أو أي منصة خارجية أخرى.

ما الذي يمكنك فعله باستخدام API؟

إرسال رسائل فورية مثل تأكيد الطلب أو إشعارات الشحن
إطلاق تنبيهات وتذكيرات من أنظمتك الداخلية
إرسال محتوى غني مثل الصور والمستندات والموقع
أتمتة تامة لتواصل واتساب من أي تطبيق خارجي

أنواع الرسائل المدعومة مع أمثلة

رسالة نصية

{
  "action": "send-message",
  "type": "text",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288"
}

رسالة وسائط (صور، فيديو، مستندات...)

{
  "action": "send-message",
  "type": "media",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288",
  "attachments": [
    "https://example.com/file.jpg"
  ]
}

يتم جلب أسماء وأنواع الملفات المرفقة تلقائيًا من رابط المرفق، ولكن إذا كنت ترغب في تخصيصها، فقم بتحويل رابط المرفق إلى object يحتوي على القيم "url" و"type" و"name"، حيث أن "type" يمكن أن تكون (image، video، audio، أو document):

{
  "action": "send-message",
  "type": "media",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288",
  "attachments": [
    {
      "url": "https://example.com/drive/12EF765HD235LKD.pdf",
      "type": "image",
      "name": "Porfolio.pdf"
    }
  ]
}

رسالة بطاقة جهة اتصال

لإرسال بطاقة جهة اتصال. يجب أن يكون حقل رقم الهاتف بتنسيق دولي.

{
  "action": "send-message",
  "type": "contact",
  "name": "Technical Support",
  "number": "905523909010",
  "organization": "Elbruz Technologies",
  "phone": "905366365288"
}

رسالة موقع جغرافي

يمكنك استخدام \n في حقل الاسم لإدراج فاصل سطر أو وصف.

{
  "action": "send-message",
  "type": "location",
  "name": "Elbruz Technologies\nBuilding A2 IFZA Business Park, Dubai Silicon Oasis, UAE.",
  "lat": "25.119869",
  "lng": "55.386700",
  "phone": "905366365288"
}

رسالة استطلاع (تصويت)

يمكنك السماح بتحديد خيار واحد أو عدة خيارات من خلال حقل "multiple".

{
  "action": "send-message",
  "type": "poll",
  "content": "Please rate our company services.",
  "multiple": false,
  "options": ["Bad", "Good", "Perfect"],
  "phone": "905366365288"
}

رسالة قائمة تفاعلية (Button List)

إنشاء قائمة قابلة للتوسيع من الخيارات مع أوصاف مختصرة.

{
  "action": "send-message",
  "type": "list",
  "button": "Select Service",
  "header": "Welcome to Elbruz Technologies",
  "content": "Please choose which one of our products are you interested in.",
  "options": [
    {"title": "Botassium", "text": "Our cloud-based WhatsApp automation platform"},
    {"title": "WA Web Plus", "text": "#1 WhatsApp extension"},
    {"title": "WA Toolbox", "text": "Your best WhastApp business partner"},
    {"title": "Triplo AI", "text": "The only AI assistant you'll ever need!"}
  ],
  "phone": "905366365288"
}

التوثيق ونقطة النهاية (Authentication & Endpoint)

كل بوت في Botassium لديه عنوان API خاص به، يظهر داخل تبويب "API" ضمن إعدادات البوت.

التوثيق إلزامي، ويجب إرسال الطلبات بشكل آمن
استخدم دائمًا الطريقة HTTP POST مع ترويسة Content-Type: application/json

ملخص

واجهة Botassium API هي وسيلة قوية ومرنة لدمج واتساب في أنظمة أعمالك. من الرسائل النصية البسيطة إلى المحتوى التفاعلي الغني، يمكنك إرسال الرسائل لحظيًا وبشكل آلي باستخدام JSON فقط.

استخدمها في تحسين عمليات المبيعات، دعم العملاء، الحملات التسويقية، أو حتى إرسال التنبيهات الداخلية.

يتكامل بسلاسة مع أدواتك المفضلة

قم بإنشاء روبوتات محادثة قوية لـ واتساب بنقرات قليلة فقط.

ابدأ الآن