خلف الكواليس: واجهتك بالطريقة التي تريدها باستخدام JavaScript
تتيح لك واجهة برمجة التطبيقات (API) إنشاء عدد غير محدود من الأتمتة والتخصيصات لواجهة tawk.to الخاصة بك باستخدام JavaScript. في هذا الحوار مع مارتينش، المهندس الرئيسي للواجهة الخلفية في tawk.to، ستتعرف على بعض أكثر حالات الاستخدام شيوعًا لواجهة برمجة JavaScript API وتتعلم كيفية تجنب الأخطاء الأكثر شيوعًا. ستتمكن أيضًا من الحصول على لمحة عن ما هو قادم للواجهة في tawk.to وفرصة الوصول إليها الآن.
١ — ما هي واجهة برمجة التطبيقات (API) وماذا يمكن أن تفعل؟
API تعني واجهة برمجة التطبيقات. وهي وسيلة لتواصل برنامجين مختلفين مع بعضهما البعض. في هذه الحالة، بالنسبة لواجهة JavaScript API على وجه الخصوص، ستُستخدم على الموقع الذي توجد عليه الواجهة حاليًا للتأثير على سلوك الواجهة والتحكم في مختلف جوانبها.
٢ — ما هي بعض فوائد استخدام JavaScript API الخاصة بـ tawk.to؟
مع JavaScript API، هناك أشياء يمكنك القيام بها قد يكون من الصعب تنفيذها عند الرد على محادثة في لوحة التحكم أو الاستجابة للأحداث على موقعك. على سبيل المثال، يمكنك تكبير الواجهة من خلال JavaScript على موقعك أو تصغيرها إذا لزم الأمر.
أحد حالات الاستخدام الشائعة هو وجود زر "اتصل بنا" مع إخفاء الواجهة بالكامل حتى يتم النقر على الزر. للقيام بذلك، ستقوم بتعيين الواجهة لتكون مخفية عند التحميل الأولي. ثم، ببساطة، ستقوم بتكبير الواجهة وجعلها مرئية عند النقر على زر "اتصل بنا".
يمكنك أيضًا التفاعل مع الواجهة بطرق مختلفة. يمكننا إعداد أحداث، على سبيل المثال، عند تحميل الواجهة، أو عند تكبيرها أو تصغيرها. يمكنك تعديل محتوى موقعك بناءً على حالة الواجهة. حقًا، خيالك هو الحد لما يمكنك القيام به.
٣ — هل يمكننا استبدال معرف المستخدم الافتراضي باسم الزائر وبريده الإلكتروني؟
هذا بالتأكيد أحد حالات الاستخدام الشائعة. هناك عدة طرق يمكن القيام بذلك.
فلنقل أنك تمتلك CRM ولديك هذه البيانات متاحة بالفعل. ما يمكنك فعله هو إضافة خصائص للاسم والبريد الإلكتروني إلى كائن الزائر. عند بدء تشغيل الواجهة، ستلتقط هذه المعلومات تلقائيًا وترسلها إلى tawk.to. وستتمكن فورًا من رؤية اسم الزائر وبريده الإلكتروني.
إذا كانت الواجهة تعمل بالفعل، أي أنها قد تم تحميلها مسبقًا، ما يمكنك القيام به، وهذا يقودنا إلى ميزة رائعة أخرى، هو أنه يمكنك تعيين اسم الزائر وبريده الإلكتروني كسمات. ولن تقتصر على الاسم والبريد الإلكتروني فقط، بل يمكنك تعيين العديد من السمات الأخرى. لنفترض أنك تريد تحديد الخطة التي يستخدمها عميلك حاليًا، فهذا يمكن أن يكون سمة مخصصة. ستُعرض هذه السمات المخصصة في شريط جانبي للدردشة ضمن علامة تبويب التفاصيل.
٤ — هل يمكننا إضافة رقم هاتف باستخدام JavaScript API؟
ستقوم بتعيين سمة بعنوان "phone". حاليًا، لا يوجد دعم صريح للهاتف. لذلك، يمكنك تعيينه كعنصر نصي. لدينا شيء جديد ومثير قادم — وهو CRM الجديد لدينا — حيث ستتمكن من تعيين الهاتف. ستتمكن من تعيين عدة عناوين بريد إلكتروني وأرقام هاتف، وهناك العديد من الميزات الرائعة الأخرى. لا أرغب في كشف الكثير بعد، لكنه قريب جدًا ونحن متحمسون جدًا له، وسيجعل ميزة السمات أكثر فائدة وقوة.
٥ — ما هي الأخطاء الشائعة التي يقع فيها الأشخاص عند استخدام JavaScript API؟
أحد أكثر الأخطاء الشائعة التي نراها هو أن الأشخاص يحاولون جعل API تقوم بأشياء قبل أن تكون جاهزة حتى لتلقي الأوامر وإرسال الأحداث.
لذلك، لدينا حدث يُسمى onLoad. الخطأ الشائع هو أن الأشخاص يحاولون إرسال الأوامر فورًا لإخبار الواجهة بالتصغير أو التكبير، ثم يتساءلون لماذا لا تعمل هذه الأوامر عندما لم يتم بعد تحميل الواجهة نفسها وواجهة API الأساسية.
الخطأ الثاني الذي أراه غالبًا هو تمكين الوضع الآمن دون فهم فعلي لما يفعله الوضع الآمن والمتطلبات الأساسية اللازمة لعمله.
٦ — هل تتوفر REST API في tawk.to؟
لدينا بالفعل REST API في مرحلة بيتا خاصة وهي متاحة حاليًا لشركائنا. إذا كنت شريكًا وترغب في الوصول إلى REST API، فقط تواصل مع أقرب ممثل لك.
تم تصميم REST API بشكل أكبر لأداء الإجراءات نيابة عن وكيل. إذا كانت JavaScript API مخصصة فقط للتحكم في الواجهة على موقعك، فإن REST API موجهة لأداء الإجراءات كوكيل. لدينا الآن العديد من الميزات المفيدة هناك، ونحن نستمر في توسيعها. ولكن حاليًا، حالات الاستخدام الشائعة التي نراها هي إنشاء خصائص لعملائك، ودعوتهم تلقائيًا، وقراءة سجل المحادثات.
يمكنك أيضًا القيام بأشياء مثل إدارة webhooks وقاعدة المعرفة الخاصة بك عبر REST API. على سبيل المثال، لنفترض أنك أنشأت الخاصية لعميلك وتريد إنشاء بعض مقالات Knowledge Base الأساسية منذ البداية. هذا شيء يمكنك أتمتته باستخدام REST API.
وإذا كان لديك حالة استخدام رائعة حقًا، فأخبرنا بها، وسنرى ما إذا كانت REST API الخاصة بنا مناسبة لك.
اطلع على وثائق JavaScript API الخاصة بنا في منصة مطوري tawk.to.
اطلب الوصول إلى REST API هنا: الحصول على وصول بيتا إلى REST API