إتقان العلاقات: إدارة جهات الاتصال

في بروتوكول واتساب، "جهة الاتصال" هي أكثر من مجرد رقم هاتف. إنها هوية تشفيرية مع إعدادات خصوصية، وبيانات ملف شخصي وصفية، وحالة جلسة مستمرة. تمنحك واجهة برمجة تطبيقات جهات الاتصال الأدوات لإدارة هذه العلاقات برمجياً.

🆔 تشريح الهوية

للعمل مع واتساب، يجب أن تفهم نوعي المعرفات:

1. JID (معرف جابر) - المعيار

هذا هو المفهوم الأهم في الواجهة بأكملها.

• الصيغة: [كود_الدولة][رقم_الهاتف]@c.us
• مثال: 966500000000@c.us
• الاستخدام: يستخدم لـ 99% من العمليات (إرسال الرسائل، التحقق من التواجد، الحظر).
• الاستمرارية: إذا قام المستخدم بتغيير رقم هاتفه، يتغير JID الخاص به.

2. LID (معرف البحث) - المستقبل

تم إدخاله مؤخراً لدعم الخصوصية القائمة على اسم المستخدم.

• الصيغة: [رقم_عشوائي]@lid
• الاستمرارية: إذا قام المستخدم بتغيير رقم هاتفه، يظل LID الخاص به كما هو. هذا يسمح بتتبع هوية المستخدم على المدى الطويل حتى لو تغير الرقم.

🔍 الاكتشاف والتحقق

واحدة من أقوى الميزات هي التحقق من وجود الحساب.

مشكلة "هل هذا الرقم مسجل في واتساب؟"

قواعد بيانات التسويق مليئة بالأرقام الأرضية والميتة. إرسال رسائل إليها سيقلل من درجة جودة حسابك وقد يؤدي لحظره.

• الحل: استخدم /v2/contacts/check-exists.
• المنطق: يقوم النظام بالاستعلام من خوادم واتساب عما إذا كان الرقم يمتلك حساباً نشطاً.
• الاستراتيجية: لا تقم بمسح أعداد كبيرة من الأرقام دفعة واحدة؛ فهذا قد يؤدي لحظر الحساب. تحقق من الأرقام "بشكل كسول" (قبيل إرسال الرسالة الأولى مباشرة).

🛡️ الخصوصية والحظر

الحظر هو أداة وظيفية، وليس مجرد أداة عاطفية.

• الدفاع ضد السبام: إذا قام مستخدم بإزعاج البوت الخاص بك، فاستدعِ /v2/contacts/block.
• الامتثال لطلب التوقف: إذا كتب المستخدم "STOP" أو "توقف"، يجب عليك التوقف عن مراسلته. حظرهم يضمن أن نظامك مادياً لا يمكنه مراسلتهم مرة أخرى، مما يوفر صمام أمان ضد أخطاء المنطق البرمجي.

ظهور الملف الشخصي

عند جلب معلومات جهة اتصال، قد تجد قيم null للصور أو "حول" (About). هذا ليس خطأ برمجي، بل يعني أن المستخدم ضبط إعدادات خصوصيته على "لا أحد" أو "جهات اتصالي فقط". احترم هذه الخصوصية دائماً.

🔮 سيناريوهات استراتيجية

سيناريو أ: مزامنة CRM

حافظ على تحديث قاعدة بيانات Salesforce أو HubSpot.

1. يرسل المستخدم رسالة للبوت.
2. يستدعي البوت GET /v2/contacts/[id].
3. يستخرج الاسم (pushName) وصورة الملف الشخصي.
4. يحدّث سجل العميل في نظامك، مما يجعل موظفي الدعم يشعرون أنهم يتحدثون مع شخص حقيقي وليس مجرد رقم.

⚠️ القيود والحصص

• 15 ميجابايت: الحجم الأقصى لصور جهات الاتصال التي يمكنك تحميلها.
• تواتر المزامنة: قد يستغرق ظهور جهة اتصال جديدة أضفتها على هاتفك حوالي 30 ثانية لتظهر في واجهة برمجة التطبيقات.