شرح أكواد WhatsApp CRM API من واتس360

أساسيات أكواد WhatsApp CRM API من واتس360: دليل برمجي شامل

مقدمة

في عصر التحول الرقمي، أصبحت منصات التواصل مثل واتساب أداة أساسية للتواصل مع العملاء. ومع تزايد الطلب على حلول إدارة علاقات العملاء (CRM) المتكاملة، تبرز واجهات برمجة التطبيقات (API) كحل مثالي لأتمتة التواصل وتحسين تجربة العملاء. في هذا المقال، سنتعرف على كيفية استخدام WhatsApp API من منصة واتس360 CRM لإرسال الرسائل النصية، والصور، والفيديوهات، والملفات الصوتية، والمستندات. سنقدم شرحًا تفصيليًا مدعومًا بالأمثلة العملية والأكواد البرمجية.

ما هو WhatsApp API؟

واجهة برمجة التطبيقات (API) الخاصة بواتساب تتيح للمطورين والشركات التفاعل مع واتساب برمجيًا. من خلالها، يمكنك إرسال رسائل تلقائية، وإدارة المحادثات، وإنشاء روبوتات محادثة (Chatbots)، وأتمتة العمليات التسويقية والخدمية.

لماذا نستخدم WhatsApp API من واتس360 CRM؟

إدارة مركزية: يمكنك إدارة عدة حسابات واتساب من خلال واجهة واحدة.
أتمتة العمليات: إرسال رسائل تلقائية وإدارة المحادثات دون تدخل يدوي.
تكامل سهل: دمج واتساب مع المواقع والتطبيقات الأخرى باستخدام API.
قابلية التوسع: إرسال رسائل إلى عدد كبير من العملاء بسهولة.

متطلبات البدء

حساب على واتس360 CRM: قم بالتسجيل في المنصة واختيار الباقة المناسبة.
Token API: احصل على الـ Token الخاص بحسابك من لوحة التحكم.
Instance ID: معرف الحساب الذي ستستخدمه لإرسال الرسائل.
أدوات برمجية: مثل Postman لاختبار الـ API، أو أي لغة برمجة تدعم طلبات HTTP (مثل Python، PHP، أو JavaScript).

أكواد WhatsApp API من واتس360 CRM

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

لإرسال رسالة نصية، نستخدم نقطة النهاية (Endpoint) التالية:

https://crm.whats360.live/api/v1/send-text

المعلمات المطلوبة:

Token: مفتاح API الخاص بحسابك.
Instance_id: معرف الحساب الذي ستستخدمه.
Jid: رقم الهاتف المستلم بتنسيق دولي (مثال: 919999999999@s.whatsapp.net).
Msg: النص الذي تريد إرساله.

مثال برمجي:

import requests


url = "https://crm.whats360.live/api/v1/send-text"

params = {

    "token": "YOUR_TOKEN_HERE",

    "instance_id": "YOUR_INSTANCE_ID",

    "jid": "919999999999@s.whatsapp.net",

    "msg": "مرحبًا، كيف يمكنني مساعدتك؟"

}

response = requests.get(url, params=params) print(response.json())

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

{ "Success": true, "Message": "Message sent successfully!", "Response": "<RESPONSE>" }

2. إرسال صورة

لإرسال صورة، نستخدم نقطة النهاية التالية:

https://crm.whats360.live/api/v1/send-image

المعلمات المطلوبة:

Token: مفتاح API.
Instance_id: معرف الحساب.
Jid: رقم الهاتف المستلم.
Caption: نص وصفي للصورة.
Imageurl: رابط الصورة.

مثال برمجي:

url = "https://crm.whats360.live/api/v1/send-image" params = { "token": "YOUR_TOKEN_HERE", "instance_id": "YOUR_INSTANCE_ID", "jid": "919999999999@s.whatsapp.net", "caption": "هذه صورة توضيحية", "imageurl": "https://example.com/image.jpg" }

response = requests.get(url, params=params) print(response.json())

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

{ "Success": true, "Message": "Image sent successfully!", "Response": "<RESPONSE>" }

3. إرسال فيديو

لإرسال فيديو، نستخدم نقطة النهاية التالية:

https://crm.whats360.live/api/v1/send-video

المعلمات المطلوبة:

Token: مفتاح API.
Instance_id: معرف الحساب.
Jid: رقم الهاتف المستلم.
Caption: نص وصفي للفيديو.
Videourl: رابط الفيديو.

مثال برمجي:

url = "https://crm.whats360.live/api/v1/send-video" params = { "token": "YOUR_TOKEN_HERE", "instance_id": "YOUR_INSTANCE_ID", "jid": "919999999999@s.whatsapp.net", "caption": "شاهد هذا الفيديو التوضيحي", "videourl": "https://example.com/video.mp4" }

response = requests.get(url, params=params) print(response.json())

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

{ "Success": true, "Message": "Video sent successfully!", "Response": "<RESPONSE>" }

4. إرسال ملف صوتي

لإرسال ملف صوتي، نستخدم نقطة النهاية التالية:

https://crm.whats360.live/api/v1/send-audio

المعلمات المطلوبة:

Token: مفتاح API.
Instance_id: معرف الحساب.
Jid: رقم الهاتف المستلم.
Audiourl: رابط الملف الصوتي.

مثال برمجي:

url = "https://crm.whats360.live/api/v1/send-audio" params = { "token": "YOUR_TOKEN_HERE", "instance_id": "YOUR_INSTANCE_ID", "jid": "919999999999@s.whatsapp.net", "audiourl": "https://example.com/audio.mp3" }

response = requests.get(url, params=params) print(response.json())

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

{ "Success": true, "Message": "Audio sent successfully!", "Response": "<RESPONSE>" }

5. إرسال مستند

لإرسال مستند، نستخدم نقطة النهاية التالية:

https://crm.whats360.live/api/v1/send-doc

المعلمات المطلوبة:

Token: مفتاح API.
Instance_id: معرف الحساب.
Jid: رقم الهاتف المستلم.
Caption: نص وصفي للمستند.
Docurl: رابط المستند.

مثال برمجي:

url = "https://crm.whats360.live/api/v1/send-doc" params = { "token": "YOUR_TOKEN_HERE", "instance_id": "YOUR_INSTANCE_ID", "jid": "919999999999@s.whatsapp.net", "caption": "هذا مستند مهم", "docurl": "https://example.com/document.pdf" }

response = requests.get(url, params=params) print(response.json())

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

{ "Success": true, "Message": "Document sent successfully!", "Response": "<RESPONSE>" }

نصائح لاستخدام WhatsApp API بشكل فعال

اختبار الطلبات: استخدم أدوات مثل Postman لاختبار الطلبات قبل تنفيذها في الكود.
إدارة الأخطاء: تأكد من معالجة الأخطاء بشكل صحيح، مثل فشل الإرسال أو انتهاء صلاحية الـ Token.
تحسين الأداء: استخدم طلبات غير متزامنة (Async) لتحسين أداء التطبيق.
تحديث الـ Token: احرص على تحديث الـ Token بانتظام لتجنب انقطاع الخدمة.

الخلاصة

WhatsApp API من واتس360 CRM يوفر حلاً قويًا لأتمتة التواصل مع العملاء عبر واتساب. من خلال هذا الدليل، تعلمنا كيفية إرسال الرسائل النصية، والصور، والفيديوهات، والملفات الصوتية، والمستندات باستخدام أكواد برمجية بسيطة. يمكنك الآن تطبيق هذه الأكواد في مشاريعك لتحسين تجربة العملاء وزيادة كفاءة عمليات التواصل.

كلمات مفتاحية

WhatsApp API، واتس360 CRM، إرسال رسائل واتساب، أكواد واتساب API، إدارة علاقات العملاء، Chatbot واتساب، أتمتة واتساب.