LINQ (لينك)

اربط PRX بمراسلة iMessage وRCS وSMS عبر Linq Partner V3 API لدعم المراسلة متعددة البروتوكولات على الهواتف.

المتطلبات المسبقة

• حساب شراكة Linq مع وصول API
• Linq API token
• رقم هاتف مُجهّز عبر Linq لإرسال الرسائل

الإعداد السريع

1. الحصول على بيانات اعتماد API

1. سجّل في حساب Linq Partner عبر linqapp.com
2. احصل على API Token من لوحة الشركاء
3. دوّن رقم الهاتف المخصص لحسابك للإرسال

2. التهيئة

[channels_config.linq]
api_token = "your-linq-api-token"
from_phone = "+15551234567"
allowed_senders = ["+1987654321"]

3. إعداد Webhooks

هيّئ Linq لإرسال أحداث webhook إلى نقطة بوابة PRX:

POST https://your-prx-domain.com/linq

4. التحقق

prx channel doctor linq

مرجع الإعدادات

الحقل	النوع	الافتراضي	الوصف
api_token	String	required	Linq Partner API token (يُستخدم كمصادقة Bearer)
from_phone	String	required	رقم الهاتف المستخدم للإرسال (صيغة E.164، مثل "+15551234567")
signing_secret	String	null	سر توقيع webhook للتحقق من توقيع HMAC
allowed_senders	[String]	[]	أرقام المرسلين المسموح بها بصيغة E.164. "*" = السماح للجميع

الميزات

• مراسلة متعددة البروتوكولات -- إرسال واستقبال عبر iMessage وRCS وSMS من تكامل واحد
• تسليم عبر Webhook -- استلام الرسائل عبر HTTP webhook push من Linq
• دعم الصور -- معالجة مرفقات الصور الواردة وتمثيلها كعلامات صور
• تمييز الوارد/الصادر -- تصفية تلقائية للرسائل الصادرة من حسابك نفسه
• التحقق من التوقيع -- تحقق اختياري من توقيع HMAC للويبهوك عبر signing_secret
• تصفية أرقام E.164 -- تقييد الوصول على أرقام مرسلين محددة

القيود

• يتطلب نقطة نهاية HTTPS عامة لتسليم webhook
• وصول Linq Partner API يتطلب حساب شريك (وليس حسابًا استهلاكيًا)
• تسليم الرسائل يعتمد على بروتوكول المستلم (iMessage أو RCS أو SMS كخيار بديل)
• تُعالج أنواع MIME الخاصة بالصور فقط للمرفقات المضمنة؛ أنواع الوسائط الأخرى تُتخطى
• حدود معدل API تعتمد على فئة Linq Partner الخاصة بك

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

لا يتم استلام أحداث webhook

• تأكد أن رابط webhook متاح للعامة ويشير إلى https://your-domain/linq
• تحقق من سجلات تسليم webhook والأخطاء في لوحة Linq Partner
• تأكد أن بوابة PRX تعمل وتستمع على المنفذ الصحيح

الرسائل تُرسل لكن الردود تفشل

• تحقق من أن api_token صالح ولم تنتهِ صلاحيته
• تأكد أن from_phone رقم صحيح ومجهّز ضمن حساب Linq
• راجع استجابة Linq API لتفاصيل الخطأ

البوت يرد على رسائله الخاصة

• هذا لا ينبغي أن يحدث؛ يقوم PRX تلقائيًا بتصفية الرسائل الصادرة باستخدام الحقول is_from_me وdirection
• إذا حدث ذلك، تحقق أن تنسيق payload في webhook يطابق بنية Linq V3 المتوقعة