كيفية إنشاء روبوت محادثة بالذكاء الاصطناعي باستخدام OpenAI في WOZTELL

كيفية إنشاء روبوت محادثة بالذكاء الاصطناعي باستخدام OpenAI في WOZTELL


كيفية إنشاء روبوت محادثة بالذكاء الاصطناعي باستخدام OpenAI في WOZTELL

اربط مساعدًا مدعومًا من OpenAI بقنوات WhatsApp وInstagram وFacebook Messenger وWebchat.

إصدار الدليل: GPT Assistant v1.3.0 · Responses API · User Guide

يشرح هذا الدليل كيفية إعداد روبوت محادثة مدعوم بالذكاء الاصطناعي في WOZTELL باستخدام إضافة GPT Assistant وواجهة Responses API من OpenAI.

باستخدام هذه الإضافة، يمكنك إنشاء مساعد يرد تلقائيًا عبر WhatsApp Business Platform وInstagram وFacebook Messenger وWebchat. يمكنك أيضًا تفعيل اقتراحات الرد المدعومة بالذكاء الاصطناعي داخل WOZTELL Inbox لمساعدة الوكلاء البشريين أثناء المحادثات المباشرة.

خطوة الإعدادما الذي ستقوم بإعداده
1إضافة OpenAI API Key الخاصة بك.
2إعداد AI Chatbot وAI Inbox Replies وKnowledge Base والأدوات.
3ربط المساعد بقناة واحدة أو أكثر داخل حساب WOZTELL.
مهم: قبل البدء، تأكد من أن لديك قناة واحدة على الأقل متصلة في حساب WOZTELL. تشمل القنوات المدعومة WhatsApp Business Platform / WhatsApp Cloud API وInstagram وFacebook Messenger وWebchat.

الخطوة 1 — تثبيت إضافة GPT Assistant

1.1 الوصول إلى Marketplace

انتقل إلى Marketplace → + New Extension.

الشكل 1 - فتح Marketplace من شريط التنقل في WOZTELL.
الشكل 1 - فتح Marketplace من شريط التنقل في WOZTELL.

في Marketplace، ابحث عن بطاقة إضافة ChatGPT: Artificial Intelligence · OpenAI | WOZTELL. ثم اضغط على Learn More.

الشكل 2 - اختيار إضافة ChatGPT من Marketplace.
الشكل 2 - اختيار إضافة ChatGPT من Marketplace.

1.2 إعداد التثبيت

في لوحة التثبيت، أكمل الحقول التالية:

الحقلما الذي يجب فعله
Extension Versionاختر v1.3.0.
Aliasأدخل اسمًا فريدًا بأحرف صغيرة وبدون مسافات، مثل: my-gpt-assistant.
Descriptionاختياري. أضف وصفًا قصيرًا لما سيقوم به هذا المساعد.

بعد ذلك، اضغط على Install.

ملاحظة: إذا ظهر الخطأ “App Integration with alias already exists”، اختر Alias مختلفًا.

بعد التثبيت، اضغط على اسم الإضافة ضمن Installed Extensions لفتح نافذة الإعداد. ستظهر لك ثلاثة أقسام رئيسية:

  1. API Key Setup
  2. Configuration
  3. Connect to Channel

الخطوة 2 — إضافة OpenAI API Key

تُعد OpenAI API Key مطلوبة قبل أن تتمكن من الوصول إلى أقسام الإعداد وربط القنوات. تسمح هذه المفتاح لـ WOZTELL بإرسال الطلبات إلى حسابك في OpenAI.

2.1 إنشاء API Key في OpenAI

في قسم API Key Setup، اضغط على generate one here. سيؤدي ذلك إلى فتح platform.openai.com في تبويب جديد.

الشكل 3 - حقل إعداد API Key داخل إضافة GPT Assistant.
الشكل 3 - حقل إعداد API Key داخل إضافة GPT Assistant.

داخل OpenAI:

  1. انتقل إلى API Keys.
  2. اضغط على + Create new secret key.
  3. أضف اسمًا وصفيًا، مثل: woztell-gpt-assistant.
  4. اترك المشروع على Default، إلا إذا كان حساب OpenAI الخاص بك يستخدم بنية مشاريع محددة.
  5. اضغط على Create secret key.
  6. انسخ المفتاح فورًا.
الشكل 4 - إنشاء secret key جديدة في OpenAI.
الشكل 4 - إنشاء secret key جديدة في OpenAI.
الشكل 5 - تأكيد وإنشاء secret key.
الشكل 5 - تأكيد وإنشاء secret key.
مهم: يعرض OpenAI المفتاح الكامل مرة واحدة فقط. بعد إغلاق النافذة، لن تتمكن من عرضه مرة أخرى.
تحذير: لا تشارك API Key مع أي شخص. هذا المفتاح مرتبط بفوترة حسابك في OpenAI. إذا تم كشفه، قم بإلغائه فورًا من OpenAI وأنشئ مفتاحًا جديدًا.

2.2 لصق المفتاح في WOZTELL

ارجع إلى WOZTELL والصق المفتاح في حقل API Key.

اضغط على Save.

الشكل 6 - حفظ OpenAI API Key داخل WOZTELL.
الشكل 6 - حفظ OpenAI API Key داخل WOZTELL.

تؤكد علامة صح خضراء أن المفتاح صالح. بعد حفظه، تصبح أقسام Configuration وConnect to Channel متاحة.

الخطوة 3 — إعداد مساعد الذكاء الاصطناعي

يحدد قسم Configuration كيفية تصرف المساعد. يتضمن هذا القسم ثلاث مناطق رئيسية:

القسمالغرض
AI Chatbotإعداد الردود التلقائية لروبوت المحادثة عبر القنوات المتصلة.
AI Inbox Repliesإنشاء اقتراحات رد مدعومة بالذكاء الاصطناعي للوكلاء البشريين داخل WOZTELL Inbox.
Knowledge Baseتحميل المستندات التي يمكن للمساعد البحث فيها عند الإجابة على الأسئلة.
مهم: احفظ كل تبويب قبل الانتقال إلى تبويب آخر. قد تُفقد التغييرات غير المحفوظة.

3.1 AI Chatbot — الإعداد الأساسي

يتحكم قسم AI Chatbot في سلوك المساعد عندما يرد تلقائيًا على المستخدمين.

لإعداد روبوت محادثة أساسي، تحتاج فقط إلى ضبط:

  • Model
  • Instructions

الحقول المطلوبة

الحقلما الذي يجب فعله
Modelاختر نموذج OpenAI الذي سيولّد الردود. يتم جلب القائمة مباشرة من حساب OpenAI الخاص بك. نقطة بداية موصى بها: gpt-4o mini لأنه سريع، منخفض التكلفة، وموثوق لمعظم حالات استخدام روبوتات المحادثة.
Transcription Modelيُستخدم لتحويل الرسائل الصوتية إلى نص. النموذج الافتراضي عادة هو whisper-1. اتركه كما هو إلا إذا كان لديك سبب محدد لتغييره.
Instructionsالـ system prompt الذي يحدد دور المساعد ونبرته وقواعده وسلوكه. يتم إرسال هذه التعليمات إلى النموذج قبل كل محادثة.

توفر WOZTELL أيضًا أداة لتوليد الـ prompt لمساعدتك في إنشاء تعليمات أقوى للمساعد:

https://woztell.com/perfect-prompt-generator/

كيفية كتابة Instructions فعالة

يجب أن تحدد التعليمات بوضوح دور المساعد، ونبرته، ونطاقه، والمهام التي يجب أن ينفذها.

مثال:

You are a presales assistant for WOZTELL.

Your goal is to help companies understand how WOZTELL can help them automate conversations across WhatsApp, Instagram, Facebook Messenger, and Webchat.

Be friendly, concise, and professional.

Only answer questions related to WOZTELL, WhatsApp Business Platform, AI chatbots, integrations, automation, and conversational channels.

If the user asks about something unrelated, politely explain that you can only help with WOZTELL-related topics.

Before qualifying the lead, ask for their name, company, website, and main use case.
العنصرمثال
Role“You are a presales assistant for WOZTELL.”
Tone“Be friendly, concise, and professional.”
Scope“Only answer questions about our products and services.”
Tasks“Ask for the user’s name, company, website, and use case before qualifying the lead.”
Escalation“If the user asks for pricing, complex integrations, or technical support, recommend speaking with the WOZTELL team.”

3.2 الإعدادات المتقدمة

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

الحقلما الذي يفعلهالتوصية
Temperatureيتحكم في مدى إبداع الردود أو اتساقها. القيم الأقل تجعل الإجابات أكثر قابلية للتوقع، والقيم الأعلى تجعلها أكثر تنوعًا.القيمة الموصى بها: 0.5. قد لا تدعم بعض النماذج هذا الإعداد. إذا لم يكن متوافقًا، سيظهر خطأ في السجلات.
Top Pطريقة بديلة للتحكم في تنوع الردود.استخدم إما Temperature أو Top P، ولكن ليس الاثنين في الوقت نفسه.
Number of chat history messages used to provide contextيحدد عدد الرسائل السابقة التي تُرسل كسياق عند توليد رد جديد.القيمة الافتراضية: 10. القيم الأعلى قد تحسن السياق لكنها تزيد استهلاك الـ tokens. الحد التقريبي الأقصى: 20 رسالة.
Max Chat Session Durationيحدد عدد الأيام التي تبقى فيها الجلسة نشطة. عند انتهاء الجلسة، يتم إنشاء thread جديد وإعادة تحميل السياق السابق.القيمة الافتراضية: 3 أيام. الجلسات الأطول قد تزيد استهلاك الـ tokens.
Formatيحدد بنية الإخراج المتوقعة.استخدم Text لروبوتات المحادثة العادية. استخدم JSON Schema أو JSON Object فقط للتكاملات التقنية.

3.3 الأدوات

تسمح الأدوات للمساعد بالوصول إلى معلومات إضافية أو تنفيذ إجراءات خارجية.

لإضافة أداة، اضغط على أيقونة + بجانب Tools.

الشكل 7 - إضافة أدوات مثل File Search إلى المساعد.
الشكل 7 - إضافة أدوات مثل File Search إلى المساعد.

تسمح هذه الأداة للمساعد بالبحث في الويب في الوقت الفعلي. استخدمها عندما يحتاج المساعد إلى الإجابة بمعلومات محدثة.

يمكنك أيضًا استخدام Domain Filtering لتقييد المساعد بمواقع محددة.

مثال:

woztell.com
support.woztell.com

لا تُدخل الرابط الكامل مع https://.

صحيحغير صحيح
woztell.comhttps://woztell.com/

تسمح هذه الأداة للمساعد بالبحث في الملفات المخزنة داخل Knowledge Base / Vector Store.

استخدمها عندما يحتاج المساعد إلى الإجابة بناءً على مستندات مرفوعة، أو FAQs، أو وثائق المنتج، أو الأدلة الداخلية، أو المواد التجارية.

قبل استخدام File Search، يجب أولًا إنشاء Knowledge Base ورفع الملفات. بعد ذلك، اختر Vector Store المناسب داخل أداة File Search.

Function Call

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

يتطلب هذا الخيار تكاملًا تقنيًا مخصصًا. معظم المستخدمين لا يحتاجون إلى إعداد Function Call أثناء الإعداد الأساسي.

مهم: اضغط على Save قبل الانتقال إلى تبويب آخر.

3.4 AI Inbox Replies

تساعد ميزة AI Inbox Replies الوكلاء البشريين على الرد بسرعة أكبر من داخل WOZTELL Inbox.

على عكس AI Chatbot، لا ترد هذه الميزة تلقائيًا على العميل. بدلًا من ذلك، تنشئ اقتراحات رد يمكن للوكلاء مراجعتها وتعديلها وإرسالها يدويًا.

هذه الميزة مفيدة عندما:

  • يتولى وكيل محادثة مباشرة.
  • يحتاج الوكيل إلى مساعدة في كتابة رد واضح.
  • يريد الفريق تسريع الردود مع الحفاظ على التحكم البشري.
  • تتطلب المحادثة سياقًا أو تعاطفًا أو تحققًا يدويًا.

بعد تفعيل الإضافة، تصبح الاقتراحات المدعومة بالذكاء الاصطناعي متاحة من WOZTELL Inbox عبر منطقة Power Apps.

كيفية إعداد AI Inbox Replies

أكمل الحقول التالية:

الحقلما الذي يجب فعله
Modelاختر نموذج OpenAI الذي سيولّد اقتراحات الرد.
Instructionsحدد كيف يجب أن يكتب المساعد اقتراحات الرد للوكلاء. يجب أن يكون هذا الـ prompt عامًا، لأنه ينطبق على WOZTELL Inbox بشكل عام.

مثال موصى به للتعليمات:

You are an AI assistant helping WOZTELL agents write better replies inside the Inbox.

Generate clear, concise, and professional suggestions based on the conversation context.

Do not make promises about pricing, delivery times, technical feasibility, or contract conditions unless they are explicitly confirmed in the conversation.

Keep the tone friendly and helpful.

If the customer asks for something that requires human validation, suggest escalating the conversation to the appropriate team.

الإعدادات المتقدمة لـ AI Inbox Replies

الحقلما الذي يفعلهالتوصية
Temperatureيتحكم في مدى إبداع الاقتراحات.القيمة الموصى بها: 0.5.
Max Tokensيحدد الطول الأقصى لكل اقتراح. القيم الأعلى تسمح بردود أطول.استخدم قيمة متوسطة للحفاظ على ردود مختصرة.
Number of Suggestionsيحدد عدد خيارات الرد التي يتم إنشاؤها لكل رسالة.القيمة الموصى بها: 2 أو 3 اقتراحات.
Previous messages used as contextيحدد عدد الرسائل السابقة المستخدمة لتوليد الاقتراح.القيمة الموصى بها: 5. المزيد من السياق قد يحسن الدقة لكنه يزيد التكلفة.

اضغط على Save قبل الانتقال إلى تبويب آخر.

3.5 Knowledge Base — Vector Stores

تسمح لك Knowledge Base برفع المستندات التي يمكن للمساعد البحث فيها عند الإجابة على الأسئلة.

يعمل Vector Store مثل مجلد. يمكنك رفع عدة ملفات داخل Knowledge Base نفسها، ويمكنك حذف ملفات فردية أو حذف المجلد بالكامل عند الحاجة.

الشكل 8 - إنشاء وإدارة Knowledge Bases / Vector Stores داخل WOZTELL.

استخدم Knowledge Base عندما تريد أن يجيب المساعد بناءً على:

  • وثائق المنتج
  • الأسئلة الشائعة
  • شروحات الأسعار
  • أدلة onboarding
  • العمليات الداخلية
  • المواد التجارية
  • الوثائق التقنية

كيفية إنشاء Knowledge Base

  1. اضغط على + New Knowledge Base.
  2. أدخل اسمًا وصفيًا، مثل: woztell-faq.
  3. اضغط على أيقونة الرفع.
  4. اسحب الملفات وأفلتها، أو اخترها من جهازك.
  5. انتظر حتى تتم معالجة المستندات.
  6. ارجع إلى إعداد AI Chatbot.
  7. أضف أداة File Search.
  8. اختر Knowledge Base / Vector Store الذي أنشأته.

تشمل الصيغ المدعومة:

  • PDF
  • DOCX
  • TXT
توصية: استخدم مستندات واضحة ومنظمة جيدًا. كلما كانت مستنداتك أوضح، كان استرجاع المساعد للمعلومات الدقيقة أفضل.

الخطوة 4 — ربط المساعد بقناة

يسمح لك قسم Connect to Channel باختيار المكان الذي سيكون فيه المساعد نشطًا.

يمكنك ربط نفس المساعد بقناة واحدة أو أكثر داخل حساب WOZTELL.

على سبيل المثال، يمكنك استخدام نفس المساعد على:

  • WhatsApp
  • Instagram
  • Facebook Messenger
  • Webchat

أو يمكنك إنشاء مساعدين مختلفين لحالات استخدام مختلفة.

أمثلة:

  • مساعد مبيعات أولية لقناة WhatsApp
  • مساعد دعم لقناة Webchat
  • مساعد منتج لقناة Instagram
  • مساعد اقتراحات داخلي للردود داخل Inbox

فهم القنوات والبيئات

Channel هي قناة التواصل المتصلة بـ WOZTELL، مثل WhatsApp أو Instagram أو Facebook Messenger أو Webchat.

Environment هي مساحة عمل داخل القناة يمكن استخدامها لفصل إعدادات الاختبار أو التطوير أو الإنتاج.

إذا لم تقم بإنشاء بيئات إضافية، فسيستخدم المساعد بيئة default.

تكون البيئات مفيدة عندما تريد:

  • اختبار روبوت المحادثة قبل إطلاقه.
  • السماح لمستخدمين محددين فقط بالاختبار.
  • فصل إعدادات التطوير عن الإنتاج.
  • تشغيل مساعدين مختلفين في سياقات مختلفة.

كيفية ربط المساعد

  1. انتقل إلى Section 3 — Connect to Channel.
  2. ابحث عن القناة والبيئة التي تريد تفعيل المساعد فيها.
  3. اضغط على Connect.
  4. أدخل Prefix Name إذا كان مطلوبًا.
  5. اضغط على Confirm.
  6. اضغط على Connect مرة أخرى.
الشكل 9 - ربط GPT Assistant بقناة وبيئة.
الشكل 9 - ربط GPT Assistant بقناة وبيئة.

بعد الربط، يتغير الزر إلى Disconnect. هذا يعني أن روبوت المحادثة أصبح مباشرًا لهذه القناة وهذه البيئة.

ما هو Prefix Name؟

يساعد Prefix Name في تحديد المساعد المرتبط بتلك القناة أو البيئة المحددة.

استخدم اسمًا واضحًا يشرح حالة الاستخدام.

أمثلة:

AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS
توصية: استخدم اصطلاح تسمية يتضمن القناة وحالة الاستخدام. مثال:
AI-CHATBOT-[CHANNEL]-[USE-CASE]

الخطوة 5 — اختبار روبوت المحادثة

بعد ربط المساعد، اختبره قبل استخدامه مع العملاء الحقيقيين.

عملية الاختبار الموصى بها

  1. انتقل إلى القناة المتصلة في WOZTELL.
  2. أرسل رسالة من جهاز أو حساب أو رقم منفصل.
  3. تحقق مما إذا كان المساعد يرد بشكل صحيح.
  4. تأكد من أن الرد يتطابق مع Instructions.
  5. اختبر أنواعًا مختلفة من الأسئلة.
  6. اختبر حالات خاصة، مثل الأسئلة خارج نطاق المساعد.
  7. راجع السجلات إذا لم يعمل شيء كما هو متوقع.

أسئلة اختبار مقترحة

استخدم أسئلة مرتبطة بحالة الاستخدام الخاصة بك.

لمساعد مبيعات أولية:

Hi, I want to automate WhatsApp for my company.

Can WOZTELL connect WhatsApp with Instagram?

Can I use this for customer support?

How much does it cost?

Can I speak with a human?

لمساعد دعم:

How can I connect my WhatsApp number?

Why is my template not approved?

Where can I see my conversations?

How do I upload contacts?

أفضل الممارسات قبل الإطلاق

1. مراجعة Instructions

تأكد من أن المساعد لديه قواعد واضحة حول:

  • دوره
  • نبرته
  • ما الذي يمكنه الإجابة عنه
  • ما الذي يجب ألا يجيب عنه
  • متى يجب أن يصعّد المحادثة إلى وكيل بشري
  • ما المعلومات التي يجب أن يجمعها من المستخدم

2. رفع Knowledge Base نظيفة

إذا كان المساعد يستخدم File Search، تأكد من أن مستنداتك:

  • محدثة
  • واضحة
  • منظمة جيدًا
  • خالية من المعلومات المكررة أو المتعارضة
  • مكتوبة باللغة التي يستخدمها عملاؤك

3. الاختبار بسيناريوهات حقيقية

لا تختبر فقط بالأسئلة البسيطة. جرّب محادثات عملاء حقيقية، واعتراضات، ورسائل غير واضحة، وحالات خاصة.

4. مراقبة استهلاك الـ tokens

قد تؤدي قيم السياق الأعلى، والجلسات الطويلة، وKnowledge Bases الكبيرة، والردود الطويلة إلى زيادة استهلاك tokens في OpenAI.

5. إتاحة التصعيد إلى وكيل بشري

في حالات المبيعات، والدعم، والأسعار، والفوترة، والمشكلات التقنية، يُنصح بالسماح للمساعد بالتصعيد إلى وكيل بشري عند الحاجة.

6. مراجعة السجلات بانتظام

تساعدك السجلات في تحديد:

  • أخطاء API Key
  • أخطاء النموذج
  • أخطاء الأدوات
  • مشكلات الـ prompt
  • مشكلات File Search
  • مشكلات ربط القنوات

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

إذا لم يكن المساعد يرد كما هو متوقع، تحقق أولًا من قسم السجلات. تأتي معظم رسائل الخطأ مباشرة من OpenAI وتوضح عادةً سبب المشكلة.

المشكلةالسبب المحتملكيفية إصلاحها
API Key غير مقبولةتم نسخ المفتاح بشكل غير صحيح، أو تم إلغاؤه، أو أنه غير صالح.أنشئ مفتاحًا جديدًا في OpenAI والصقه مرة أخرى في WOZTELL.
خطأ Alias أثناء التثبيتالـ Alias مستخدم بالفعل داخل حساب WOZTELL.اختر Alias مختلفًا.
الأقسام 2 أو 3 غير متاحةلم يتم حفظ API Key بعد.احفظ API Key في الخطوة 1 أولًا.
النموذج لا يظهر في القائمةحساب OpenAI الخاص بك لا يملك صلاحية الوصول إلى ذلك النموذج.تحقق من حساب OpenAI والمشروع وصلاحيات النماذج.
المساعد لا يردالقناة غير متصلة أو API Key غير صالحة.تحقق من ربط القناة وتأكد من أن API Key ما زالت صالحة.
ظهور خطأ Temperature أو Top P في السجلاتالنموذج المختار لا يدعم هذا الإعداد.عطّل الإعداد أو انتقل إلى نموذج متوافق.
File Search لا يعمللم يتم رفع ملفات، أو تم اختيار Vector Store غير صحيح، أو لم تتم إضافة File Search كأداة.ارفع الملفات، واختر Knowledge Base الصحيحة، وتأكد من أن File Search مفعلة.
المساعد يجيب بمعلومات غير صحيحةInstructions غير واضحة، أو Knowledge Base تحتوي على معلومات ناقصة أو متعارضة.حسّن الـ prompt وراجع المستندات المرفوعة.
حسابان من OpenAI متصلان بنفس القناةإضافة GPT Assistant أخرى مفعلة بالفعل على تلك القناة.افصل الإضافة الحالية قبل ربط الإضافة الجديدة.

التوصية النهائية

بعد إعداد روبوت المحادثة واختباره، استمر في تحسينه بناءً على المحادثات الحقيقية.

راجع أسئلة العملاء، وحدّث Knowledge Base، وعدّل Instructions، وراقب أداء المساعد بانتظام.

يمكن لمساعد ذكاء اصطناعي مُعد بشكل جيد أن يساعد فريقك في أتمتة المحادثات المتكررة، ودعم الوكلاء داخل Inbox، وتأهيل العملاء المحتملين بشكل أسرع، وتقديم إجابات متسقة عبر WhatsApp وInstagram وFacebook Messenger وWebchat.