خلف الكواليس: الواجهة و كيفية استخدام JavaScript API

تتيح لك JavaScript API إنشاء عمليات تلقائية وتخصيصات غير محدودة لواجهة tawk.to. في هذه المقابلة مع Mārtiņš، مهندس الرئيسي للواجهة الخلفية الرئيسي في tawk.to، ستكتشف حالات الاستخدام الأكثر شيوعاً لواجهة برمجة تطبيقات JS وستتعلم كيفية تجنب الأخطاء. ستحصل أيضاً على لمحة بسيطة عن ما هو جديد على tawk.to.

١- ما هي API وماذا يمكنها أن تفعل؟

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

٢- ما هي بعض فوائد استخدام tawk.to JavaScript API؟

باستخدام JavaScript API، هناك أشياء يمكنك القيام بها لم يكن لتستطيع فعلها بسهولة عند الرد على محادثة من لوحة التحكم أو الرد على الأحداث على موقع الويب الخاص بك. على سبيل المثال، يمكنك تكبير الواجهة من JavaScript لموقع الويب الخاص بك  أو تصغيرها إذا لزم الأمر.

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

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

٣- هل يمكننا استبدال معرف المستخدم الافتراضي باسم الزائر والبريد الإلكتروني؟

هذه بالتأكيد واحدة من حالات الاستخدام الشائعة. هناك طريقتان يمكن القيام بهما.

لذلك لنفترض أن لديك CRM وأن لديك هذه البيانات متاحة. ما يمكنك فعله هو إضافة خاصيات للاسم والبريد الإلكتروني إلى موضوع الزائر. مع بدء تشغيل الواجهة، ستقوم تلقائياً باختيار هذه المعلومات وإرسالها إلى tawk.to. ويمكنك أن ترى على الفور اسم الزائر والبريد الإلكتروني.

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

٤- هل يمكننا إضافة رقم هاتف باستخدام JavaScript API؟

يمكنك تعيين سمة بعنوان "الهاتف". حالياً، ليس لدينا دعم للهاتف. لذلك، يمكنك تعيينها كسمة نص. لدينا شيء جديد رائع قادم - CRM جديد - حيث ستتمكن من ضبط الهاتف. ستتمكن من تعيين عدة رسائل بريد إلكتروني وأرقام هواتف، وهناك العديد من الميزات الرائعة. لا أرغب في عرض جميع بطاقاتنا على الطاولة، ولكنها قريبة جدًا ونحن متحمسون جدًا لها، مما سيجعل ميزة السمات أكثر فائدة وقوة.

٥- ما هي الأخطاء الشائعة التي يرتكبها الأشخاص عند استخدام JavaScript API؟

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

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

الخطأ الثاني الذي أراه في أغلب الأحيان هو تمكين الوضع الآمن دون فهم فعلياً ما يفعله الوضع الآمن والمتطلبات الأساسية اللازمة لعمل الوضع الآمن.

٦- هل واجهة برمجة تطبيقات REST متوفرة على tawk.to؟

لدينا بالفعل بيتا Rest API خاص وهو متاح حالياً لشركائنا. إذا كنت شريكاً وتريد الحصول على REST API، فما عليك سوى التواصل مع أقرب ممثل لك.

تم توجيه Rest API بشكل أكبر نحو تنفيذ الإجراءات نيابة عن الوكيل. إذا كانت واجهة برمجة تطبيقات JavaScript API مخصصة فقط للتحكم بالواجهة على موقع الويب الخاص بك، فإن Rest API موجهة نحو تنفيذ الإجراءات كوكيل. لدينا الكثير من الأشياء المفيدة هناك الآن. نستمر في توسيعها. ولكن في الوقت الحالي، فإن حالات الاستخدام الشائعة التي نراها هي إنشاء خاصيات لعملائك، ودعوتهم تلقائياً، وقراءة محفوظات المحادثات.

يمكنك أيضاً القيام بأشياء مثل إدارة خطافات الويب وقاعدة المعرفة الخاصة بك من خلال REST API. لنفترض أنك أنشأت الخاصية لعميلك وتريد إنشاء بعض إدخالات قاعدة المعرفة الأساسية من البداية. هذا شيء يمكنك أتمتته باستخدام REST API.

وفي حال لديك حالات أخرى أو تساؤلات، أخبرنا بها، وسنرى ما إذا كانت Rest API مناسبة لك.

الق نظرة على وثائق JavaScript API الخاصة بنا في منصة مطوري tawk.to.

اطلب الحصول  على REST API هنا: احصل على  REST API بيتا

هل كان هذا المقال مفيداً؟

127 من 164 أعجب بهذا المقال