أرسل رسائل WhatsApp من أي أداة أتمتة

تحتوي معظم منصات الأتمتة على إجراء يرسل طلب HTTP، يُسمى غالبًا HTTP Request أو API request أو Outgoing webhook. وجّه هذا الإجراء إلى نقطة النهاية إرسال رسالة في Wbiztool، فيرسل كل تشغيل لمسار عملك رسالة WhatsApp من رقمك المتصل.

تشرح هذه الصفحة الإعداد مرة واحدة، ثم توضح أين تجد الإجراء في Pabbly Connect وAlbato وActivepieces وMake.

قبل أن تبدأ#

تحتاج إلى ثلاث قيم من حسابك في Wbiztool:

• Client ID (معرّف العميل) وAPI key (مفتاح API) من Settings → API keys (الإعدادات ← مفاتيح API).
• WhatsApp Client ID (معرّف عميل WhatsApp) للرقم الذي ترسل منه، ويظهر في WhatsApp settings (إعدادات WhatsApp). يجب أن يكون الرقم متصلًا؛ فالرسائل المرسلة أثناء انقطاع اتصاله تنتظر في قائمة الانتظار.

راجع المصادقة للتفاصيل.

اضبط إجراء HTTP#

1. أضف إجراء طلب HTTP

   بعد المشغّل (إدخال جديد في نموذج، أو صف جديد في جدول بيانات، أو طلب جديد)، أضف إجراء طلب HTTP أو API الخاص بمنصتك.

2. اضبط الطريقة والرابط

   الطريقة POST، والرابط https://wbiztool.com/api/v1/send_msg/. اترك المصادقة على «بلا» (none): بيانات الاعتماد تُرسل في جسم الطلب.

3. اختر نوع جسم الطلب

   اختر JSON إذا كانت أداتك توفره. يعمل Form data (حقول النموذج) أيضًا، لذا استخدم أيهما أسهل في أداتك. لا تحتاج إلى أي ترويسات إضافية.

4. أضف حقول جسم الطلب

   أضف الحقول الموجودة في الجدول أدناه. اكتب بيانات اعتمادك كقيم ثابتة واربط phone وmsg ببيانات المشغّل.

5. اختبر الخطوة

   شغّل الخطوة مرة واحدة ببيانات اختبار. الاستجابة التي تحتوي على "status": 1 تعني أن الرسالة أُضيفت إلى قائمة الانتظار.

حقول جسم الطلب#

للإرسال إلى مجموعة WhatsApp بدلًا من رقم، أرسل group_name مكان phone. راجع الإرسال إلى مجموعة. كل الخيارات الأخرى مذكورة في إرسال رسالة.

مثال على جسم JSON#

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

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

للإرسال إلى مجموعة، استبدل phone وcountry_code بـ group_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

لإرسال صورة، اضبط msg_type على 1 وأضف img_url؛ ويصبح msg تعليقًا عليها. لإرسال ملف، اضبط msg_type على 2 وأضف file_url وfile_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

الاستجابة#

يُرجع الطلب الناجح:

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

تعني "status": 1 أن الرسالة أُضيفت إلى قائمة الانتظار، ولم تُرسل بعد. إذا كان هناك خطأ، تُرجع API حالة HTTP ‏400 مع "status": 0 وmessage مثل Auth Error: invalid api key أو Invalid phone number. توقف بعض الأدوات مسار العمل عند استجابة 400؛ افتح مخرجات الخطوة لقراءة message. القائمة الكاملة موجودة في إرسال رسالة ← الأخطاء.

لمعرفة متى تُرسل الرسالة فعليًا، مرّر رابط webhook (مثل مشغّل webhook في الأداة نفسها). يتلقى طلب POST مرمّزًا كنموذج (form-encoded) يحتوي على msg_id وstatus بالقيمة SENT أو FAILED. راجع Webhook.

Pabbly Connect#

1. أضف إجراء API

   في مسار عملك، أضف خطوة إجراء، واختر التطبيق API (Pabbly) وحدث الإجراء Execute API Request.

   

2. اضبط الطلب

   اضبط Action Event Method على POST، وAPI Endpoint URL على https://wbiztool.com/api/v1/send_msg/، وPayload Type على Form Data أو JSON، وAuthentication على No Auth.

   

3. اضبط المعاملات

   حدّد Set Parameters وأضف صفًا لكل حقل من حقول جسم الطلب: client_id وapi_key وwhatsapp_client وphone وcountry_code وmsg وmsg_type. اربط phone وmsg ببيانات المشغّل.

   

   لا تتضمن لقطة الشاشة country_code لأن رقم الاختبار يتضمنه بالفعل.

4. احفظ وأرسل طلبًا تجريبيًا

   تحقق من أن الاستجابة تحتوي على "status": 1.

Albato#

1. أضف إجراء HTTP

   في عملية الأتمتة، أضف إجراءً واختر HTTP Request/Outgoing webhook، ثم إجراءه Send request. مثلًا، استخدم مشغّل Google Sheets ‏New row created لمراسلة كل صف جديد.

   

2. أنشئ الاتصال

   أعطِ الاتصال اسمًا مثل "Wbiztool". يمكنك إدخال https://wbiztool.com/api/v1/send_msg/ كرابط له وضبط نوع المحتوى على JSON.

3. اربط حقولك

   اضبط URL على https://wbiztool.com/api/v1/send_msg/ (إذا تُرك فارغًا، يُستخدم رابط الاتصال) وRequest method على POST. تحت Request parameters، أضف client_id وapi_key وwhatsapp_client وmsg_type وcountry_code وphone وmsg، واختر phone وmsg من حقول المشغّل.

   

   

   تستخدم لقطة الشاشة message، الذي يعمل مكان msg. ولا تتضمن country_code لأن رقم الاختبار يتضمنه بالفعل.

4. اختبر وابدأ

   شغّل اختبارًا، وتأكد من أن الاستجابة تحتوي على "status": 1، ثم ابدأ عملية الأتمتة.

   

Activepieces#

1. أضف قطعة HTTP

   انقر على + بعد المشغّل واختر HTTP ← Send HTTP request.

2. اضبط الطلب

   اضبط Method على POST وURL على https://wbiztool.com/api/v1/send_msg/. اختر JSON أو Form Data كـ Body Type.

   

3. أضف حقول جسم الطلب

   أضف عنصرًا لكل حقل. استخدم Data Selector لإدراج قيم من المشغّل في phone وmsg. إذا كان phone يتضمن رمز الدولة بالفعل (مثل 919876543210)، فيمكنك حذف country_code.

4. اختبر الخطوة

   انقر على Test Step وتحقق من أن الاستجابة تحتوي على "status": 1، ثم انشر التدفق.

Make#

استخدم وحدة HTTP في Make مع الإجراء Make a request. اضبط الطريقة على POST، والرابط على https://wbiztool.com/api/v1/send_msg/، ونوع جسم الطلب على JSON (raw، بنوع المحتوى application/json) أو Form data، واملأ حقول جسم الطلب المذكورة أعلاه.

استكشاف الأخطاء وإصلاحها#