Your AI Connector Docs

LINE

قم بتوصيل حساب LINE الرسمي (LINE Official Account) الخاص بك حتى تتدفق محادثات LINE إلى التطبيق ويتمكن وكيل الذكاء الاصطناعي من الرد عليها. يمكنك التوصيل عن طريق لصق بيانات اعتماد LINE Messaging API الخاصة بك (سر القناة + رمز الوصول) وتعيين عنوان URL واحد لخطاف الويب (webhook) — دون الحاجة إلى برمجة.


ما هو تكامل LINE؟

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

على عكس Telegram أو WhatsApp Web، يعد هذا تكاملاً رسمياً — فهو يستخدم واجهة برمجة تطبيقات المراسلة الخاصة بـ LINE، لذا فهو مستقر وضمن قواعد LINE. نظراً لأن LINE لا يحتوي على زر “اتصال” بنقرة واحدة لأدوات الطرف الثالث، فإنك تقوم بلصق بيانات اعتماد حسابك الرسمي مرة واحدة أثناء الإعداد.

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


قبل البدء

ستقوم بإنشاء (أو استخدام) ثلاثة أشياء في لوحات تحكم LINE الخاصة. هذا إعداد لمرة واحدة يستغرق حوالي 5 دقائق.

  1. حساب LINE رسمي (LINE Official Account) (تم إنشاؤه في مدير حسابات LINE الرسمية). إذا لم يكن لديك حساب بعد، قم بتسجيل الدخول باستخدام معرف LINE Business الخاص بك وأنشئ حسابًا جديدًا — امنحه اسمًا واملأ النموذج القصير.
  2. قناة Messaging API لهذا الحساب الرسمي. أسهل طريقة هي تفعيلها من داخل مدير الحساب الرسمي (انظر الخطوة 1 أدناه) — لست مضطرًا لإنشاء القناة يدويًا في وحدة تحكم المطورين أولاً. عند مطالبتك بذلك، اختر مزودًا (provider) موجودًا أو أنشئ واحدًا جديدًا.
  3. من تلك القناة، ستحتاج إلى ثلاث قيم ستلصقها في التطبيق:
    • معرف القناة (Channel ID) (علامة تبويب الإعدادات الأساسية) — اختياري، للمعلومات فقط
    • سر القناة (Channel secret) (علامة تبويب الإعدادات الأساسية)
    • رمز وصول القناة (Channel access token) — رمز طويل الأمد تصدره من علامة تبويب Messaging API

لا يلزم تقديم مستندات تجارية للحساب الرسمي القياسي (غير الموثق) — يكفي فقط معرف عمل LINE (LINE Business ID). التحقق (الشارة الزرقاء) اختياري ويتم تقديمه فقط في بعض المناطق.


إعداد LINE

الخطوة 1: تفعيل Messaging API لحسابك الرسمي

  1. قم بتسجيل الدخول إلى مدير حسابات LINE الرسمية (أو أنشئ حسابًا رسميًا جديدًا أولاً).
  2. افتح حسابك الرسمي (OA).
  3. انقر على الإعدادات (Settings) (الزاوية العلوية اليمنى).
  4. في قائمة الإعدادات، انقر على Messaging API.
  5. تبدأ الحالة كـ معطل (Disabled) — انقر لتفعيلها.
  6. اختر المزود (provider) لهذه القناة (الشركة/المطور الذي يمتلكها). إذا لم يكن لديك واحد بعد، أنشئ مزودًا جديدًا، ثم قم بالتأكيد.

الخطوة 2: الحصول على بيانات الاعتماد من وحدة تحكم المطورين

يؤدي تفعيل Messaging API إلى إنشاء قناة تحت اسم المزود الخاص بك في وحدة تحكم مطوري LINE.

  1. افتح حساب المطور / المزود.
  2. انقر للدخول إلى قناة Messaging API.
  3. افتح علامة تبويب الإعدادات الأساسية (Basic settings) وانسخ معرف القناة (Channel ID) وسر القناة (Channel secret).
  4. افتح علامة تبويب Messaging API، وأصدر (أو أعد إنشاء) رمز وصول قناة (Channel access token) طويل الأمد، وانسخه.

احتفظ بهذه القيم في متناول يدك — ستقوم بلصقها في التطبيق لاحقًا.

الخطوة 3: ربط LINE في التطبيق

  1. في الشريط الجانبي الأيسر، انقر على Settings (الإعدادات) بالقرب من الأسفل.
  2. في القائمة الجانبية اليسرى للإعدادات، تحت Channels (القنوات)، انقر على Channels (القنوات).
  3. ابحث عن بطاقة LINE وانقر على Connect (اتصال).
  4. اختياريًا، الصق Channel ID (معرف القناة) الخاص بك — للمعلومات فقط.
  5. الصق Channel secret (سر القناة) الخاص بك.
  6. الصق Channel access token (رمز وصول القناة) الخاص بك.
  7. انقر على Connect (اتصال).
  8. سيقوم التطبيق بالتحقق من بيانات الاعتماد مع LINE وسيعرض “Connected to: <your OA name>” (متصل بـ: <اسم حسابك الرسمي>). إذا كانت بيانات الاعتماد غير صحيحة، فستتلقى خطأ — أعد إصدار رمز الوصول من وحدة تحكم مطوري LINE (LINE Developers Console) وحاول مرة أخرى.

الخطوة 4: تعيين رابط الويب (Webhook URL) في LINE

بعد التوصيل، يعرض التطبيق قسم إنهاء الإعداد في LINE مع عنوان URL لخطاف الويب (webhook URL) — انسخه. (عنوان URL لخطاف الويب هو مجرد عنوان ويب؛ لصقه في LINE يخبر LINE بمكان إرسال الرسائل الجديدة تلقائيًا.) ثم في وحدة تحكم مطوري LINE لقناة Messaging API الخاصة بك:

  1. افتح علامة تبويب Messaging API.
  2. الصق عنوان URL في Webhook URL.
  3. انقر على تحديث (Update).
  4. قم بتشغيل استخدام خطاف الويب (Use webhook) إلى وضع التشغيل (ON).

الخطوة 5: إصلاح إعدادات مدير الحسابات الرسمية (هام)

افتراضيًا، يتعامل حساب LINE الرسمي مع المحادثات والردود التلقائية بنفسه، مما يمنع الرسائل من الوصول إلى الذكاء الاصطناعي. بالعودة إلى مدير حسابات LINE الرسمية، افتح إعدادات حسابك الرسمي واضبط ما يلي:

الإعداد القيمة المطلوبة السبب
المحادثة (Chat) تشغيل (On) تفعيل المحادثة لتدفق الرسائل (تتيح لك استخدام فلتر المحادثة).
وضع الاستجابة (Response mode) بوت (Bot) السماح لواجهة برمجة التطبيقات (وكيل الذكاء الاصطناعي الخاص بك) بمعالجة الرسائل. وضع “المحادثة” فقط يقوم بحجبها.
ساعات الاستجابة / رسائل الرد التلقائي إيقاف (Off) تعطيل الردود التلقائية الخاصة بـ LINE حتى يتولى الذكاء الاصطناعي معالجة الردود (السبب الأول لـ “الردود المزدوجة”).
رسائل الترحيب إيقاف (Off) منع رسائل الترحيب التلقائية الخاصة بـ LINE من التداخل مع الذكاء الاصطناعي.
خطافات الويب (Webhooks) تشغيل (On) لكي يقوم LINE بإعادة توجيه الرسائل إلى التطبيق.

إذا حذرك التطبيق من أن حسابك في وضع الدردشة (Chat mode)، فقم بتحويله إلى وضع البوت (Bot mode) من هنا — لن يتمكن البوت من تلقي الرسائل أو إرسالها حتى تقوم بذلك.

الخطوة 6: اختبار الروبوت

  1. من هاتف مختلف (على سبيل المثال، تطبيق LINE الخاص بك)، أضف حسابك الرسمي كصديق وأرسل له رسالة.
  2. افتح التطبيق وانتقل إلى المحادثات (Chats) — ستظهر الرسالة الواردة في قائمة المحادثات.
  3. إذا كان وكيل الذكاء الاصطناعي يتعامل مع هذه القناة، فسترى أنه يرد تلقائيًا على الرسالة الاختبارية.

بمجرد الاتصال مع ضبط خطاف الويب والتأكد من صحة المفاتيح أعلاه، سيظهر حساب LINE الخاص بك كـ متصل (Connected) في صفحة القنوات وسيقوم الذكاء الاصطناعي بالرد على الرسائل الواردة.


التكلفة

LINE هي قناة مجانية في التطبيق — لا توجد رسوم لكل رسالة ولا توجد رسوم اتصال شهرية منا. لاحظ أن خطط LINE الخاصة لها حدود شهرية خاصة بها على رسائل الدفع (push) (الإرسال الاستباقي)، والتي تختلف حسب المنطقة ونوع الحساب. الردود المرسلة بعد وقت قصير من مراسلة العميل لك تكون مجانية على LINE؛ أما الإرسال الاستباقي/البث فيتم احتسابه ضمن حصة خطة LINE الخاصة بك.


رسائل الوسائط

يتم التعرف على الصور ومقاطع الفيديو والملاحظات الصوتية والملفات والملصقات والمواقع الواردة حتى يعرف الذكاء الاصطناعي أنه تم إرسال وسائط (تتم إضافة ملاحظة قصيرة إلى المحادثة). ردود الذكاء الاصطناعي الصادرة في هذا الإصدار هي نصوص وصور. يتم تقصير الردود الطويلة تلقائيًا لتتوافق مع حد LINE البالغ 5000 حرف.


إدارة الجلسة

التحقق من حالة الاتصال

تظهر حالة اتصال LINE الخاص بك على بطاقة LINE في صفحة القنوات (Channels):

الحالة المعنى
متصل حساب LINE الرسمي مرتبط بهذا الحساب
غير متصل لم يتم إعداد أي اتصال

تعيد البطاقة أيضًا التحقق من إعداد وضع الدردشة (Chat mode) الخاص بحسابك في كل مرة تفتح فيها صفحة القنوات. إذا تم تبديل حساب LINE الخاص بك مرة أخرى إلى وضع الدردشة (مما يمنع البوت من تلقي الرسائل أو إرسالها)، سيظهر تحذير باللون الكهرماني على البطاقة يطلب منك تبديله مرة أخرى إلى وضع البوت (Bot mode) في مدير حساب LINE الرسمي — أعد التحقق من مفاتيح التبديل في الخطوة 5 هناك وسيختفي التحذير عند الزيارة التالية.

قطع الاتصال

افتح بطاقة LINE وانقر على إدارة (Manage)، ثم انقر على قطع الاتصال (Disconnect) في اللوحة التي تفتح وأكّد خيار إزالة LINE؟ (Remove LINE?). يؤدي هذا إلى إزالة الاتصال من جانبنا. لإيقاف LINE تماماً عن إرسال الأحداث، قم أيضاً بإيقاف تشغيل استخدام خطاف الويب (Use webhook) (أو احذف عنوان URL الخاص بخطاف الويب) في وحدة تحكم مطوري LINE (LINE Developers Console).


القيود

  • حساب رسمي واحد لكل اتصال. قم بتوصيل كل حساب رسمي (OA) بشكل منفصل؛ يمكن ربط الحساب الرسمي بحساب واحد فقط.
  • إرسال النصوص + الصور. يرد الذكاء الاصطناعي بالنصوص والصور؛ لا يتم إرسال رسائل “Flex” أو القوالب أو رسائل العرض الدوار في هذا الإصدار.
  • المنطقة. حسابات LINE الرسمية غير متوفرة في الاتحاد الأوروبي؛ تحتاج إلى حساب رسمي في منطقة مدعومة (مثل اليابان، تايوان، تايلاند، إندونيسيا).
  • توقيت الرد. تتمتع ردود LINE الفورية المجانية بنافذة زمنية قصيرة؛ يتم تسليم الرسائل المرسلة لاحقًا تلقائيًا كرسائل دفع (يتم احتسابها ضمن الحصة).

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

رفض بيانات الاعتماد عند الاتصال

  • تأكد من أنك أنشأت قناة Messaging API (وليس “LINE Login”).
  • أعد إصدار رمز وصول للقناة طويل الأمد (long-lived channel access token) من علامة تبويب Messaging API والصق القيمة الجديدة.
  • تأكد من أنك نسخت سر القناة (Channel secret) من علامة تبويب الإعدادات الأساسية (وليس معرف القناة).

البوت لا يرد

  • تأكد من تفعيل Webhooks في كل من وحدة تحكم المطورين (Developers Console) ومدير الحساب الرسمي (OA Manager).
  • تأكد من تطابق رابط الويب هوك (Webhook URL) مع الرابط المعروض في التطبيق.
  • تأكد من ضبط وضع الرد (Response mode) على بوت (وليس دردشة) في مدير الحساب الرسمي.

العميل يتلقى ردين

  • قم بإيقاف رسائل الرد التلقائي و رسائل الترحيب في مدير الحساب الرسمي — حيث يتم إرسال الردود التلقائية المدمجة في LINE بجانب ردود الذكاء الاصطناعي.

الرسائل لا تصل إلى التطبيق

  • تحقق من أن جهة الاتصال قد أضافت حسابك الرسمي كصديق (LINE يوصل الرسائل من الأصدقاء فقط).
  • أعد التحقق من رابط الويب هوك ومن تفعيل خيار استخدام الويب هوك (Use webhook).

أفضل الممارسات

  • أكمل إعدادات مدير الحساب الرسمي (وضع البوت، تفعيل الويب هوك، إيقاف الترحيب + الرد التلقائي) — فمعظم مشاكل الإعداد تنبع من هذه الخيارات.
  • رد بسرعة للحفاظ على الردود ضمن نافذة LINE المجانية وللحفاظ على حصة الإرسال الخاصة بك.
  • حافظ على أمان رمز الوصول الخاص بك — يمكن لأي شخص يمتلكه الإرسال باسم حسابك الرسمي. أعد إصداره في وحدة تحكم المطورين إذا تم تسريبه.