بوت خدمة عملاء بالعربي بـ OpenAI API
بوت دعم عربي يجيب من ملف معرفة عندك ولا يؤكد الدفع؛ عندما ينقص الجواب يحوّل لموظف.
صاحب متجر بحلب كان يجاوب كل مساء على الأسئلة نفسها: متى يصل الطلب إلى حلب؟ كيف أدفع بسيريتل كاش؟ وين رقم العملية؟ وما حالة الطلب 1240؟ الرسائل تأتي على واتساب وعلى تيليغرام وعلى نموذج الموقع، والجواب موجود أصلًا في صفحة الأسئلة أو في لوحة الطلبات. دمج الذكاء الاصطناعي بموقعك يفيد هنا إذا بقي البوت مقيدًا بمعرفة المتجر، لا إذا صار يحزر الشحن أو يؤكّد دفعًا لم يره. في هذا المقال أبني بوت خدمة عملاء بالعربي بـ OpenAI API: يجيب من ملف معرفة عندك، يقدر يسأل نظامك عن حالة طلب، ويحوّل للموظف حين لا يكفي النص.
البوت ليس موظفًا بديلًا، ولا يؤكد تحويل محفظة. تأكيد سيريتل كاش وشام كاش يبقى على رقم العملية والبوابة، كما في مقال ربط سيريتل كاش. وظيفة البوت أن يختصر الأسئلة المتكررة، وأن يمنع الإجابة المختلقة عن سعر أو حالة طلب.
ماذا يستطيع البوت، وما الذي أمنعه عنه
يستطيع أن يشرح طريقة الدفع، ومدة التجهيز التي نشرتها أنت، وسياسة الاستبدال كما كتبتها، ورابط تتبع إن كان عندك تتبع. ويستطيع، إذا صمّمت أداة برمجية لذلك، أن يستعلم عن حالة طلب برقمه بعد أن يعرّف الزبون نفسه بطريقة تقبلها (رقم طلب مع رقم هاتف مثلًا).
أمنعه من اختراع رقم محفظة غير الرقم المنشور، ومن قول «تم الدفع» اعتمادًا على كلام الزبون، ومن تخمين موعد وصول غير مكتوب في المعرفة. إذا سُئل عن نزاع أو مبلغ ناقص أو طلب لا يجده النظام، يرد بأنه سيحوّل المحادثة لشخص. هذا أهم من صياغة أنيقة.
في مطعم بدمشق الأسئلة تختلف قليلًا: وقت التوصيل لهذا الحي، وهل التوصيل متاح بعد الساعة العاشرة، وكيف يُدفع الطلب. المصدر يبقى ملفًا عندك تُحدّثه عندما يتغيّر وقت الإغلاق، لا نموذجًا «يعلم كل شيء».
ما الذي تحتاجه قبل كتابة الكود
مفتاح OpenAI من حسابك، يُحفظ في متغير بيئة OPENAI_API_KEY ولا يُوضع في المتصفح ولا في المستودع. اسم النموذج أتركه في OPENAI_MODEL حتى تبدّله من لوحة OpenAI من غير تعديل منطق البوت. الأسعار والحدود تتغيّر؛ راجعها في حسابك قبل أن تفتح الدردشة للزوار، وضع حدًا يوميًا للطلبات حتى لا تُفاجأ بفاتورة.
وتحتاج ملف معرفة للمتجر: ساعات العمل، مناطق الشحن، طريقة الدفع بسيريتل كاش أو شام كاش، سياسة الإرجاع، وروابط مفيدة. اكتبه بالعربي كما تجيب الزبون اليوم، في فقرات قصيرة. البوت يسترجع أقرب الفقرات للسؤال ثم يجيب منها. من غير هذا الملف، النموذج سيملأ الفراغ من عنده.
وتحتاج واجهة تظهر فيها الدردشة: صفحة في الموقع، أو ويب هوك لتيليغرام، أو الاثنان على نفس السيرفر. المنطق واحد. إذا كان البيع أصلًا داخل تيليغرام أو واتساب، البوت يقف بجانب مسار الطلب لا مكانه؛ أخذ الطلب وتأكيد الدفع مساران منفصلان في بوت تيليغرام ودفع سيريتل كاش وبوت واتساب وشام كاش.
أخيرًا، مسار تحويل لإنسان: بريد، أو مجموعة تيليغرام للدعم، أو تذكرة في لوحتك. بوت بلا هذا المسار يحاصر الزبون حين يفشل.
المعرفة أولًا، ثم النموذج
أحفظ المعرفة في ملف نصي، كل موضوع في فقرة مستقلة يفصلها سطر ---. عند إقلاع السيرفر أقسّم الملف، وأحسب متجهًا لكل فقرة مرة واحدة، وأبقي المتجهات في الذاكرة. عند كل سؤال أحسب متجه السؤال، وآخذ أقرب فقرتين أو ثلاث، وأمرّرها للنموذج كسياق. هذا أبسط شكل عملي لما يُسمى الاسترجاع، ويكفي لمتجر صغير قبل أن تبني قاعدة متجهات منفصلة.
إذا كانت المعرفة قصيرة جدًا (صفحة واحدة مثلًا)، يمكن وضعها كلها في تعليمات النظام وتجاوز المتجهات. الفائدة من الاسترجاع تظهر عندما يطول الملف وتصير التعليمات أكبر مما تريد إرساله في كل طلب.
مثال على ملف store-knowledge.txt:
```text طريقة الدفع: نقبل سيريتل كاش وشام كاش. بعد إتمام الطلب يظهر رقم التحويل والمبلغ كما هو. حوّل المبلغ ثم اكتب رقم العملية في صفحة الطلب. التحويل لا يحتاج ملاحظة، لأن حقل الملاحظة غير موجود في التحويل.
الشحن إلى حلب: الطلب يُجهّز خلال يوم عمل بعد تأكيد الدفع، ثم يُسلَّم حسب شركة الشحن التي نستخدمها في ذلك الأسبوع. نرسل رقم التتبع في رسالة عندما تخرج الشحنة. لا نحدد ساعة وصول داخل المدينة.
الاستبدال: يمكن استبدال القطعة غير المستخدمة خلال ثلاثة أيام من الاستلام، على أن ترجع بحالتها وبطاقتها. الاسترجاع المالي يُناقش مع الدعم ولا يؤكده البوت.
ساعات العمل للدعم: من السبت إلى الخميس، 10 صباحًا حتى 8 مساءً بتوقيت دمشق. خارج هذا الوقت يمكن ترك رسالة، ويرد موظف في صباح اليوم التالي. ```
حدّث الملف عندما يتغيّر رقم المحفظة أو سياسة الشحن، ثم أعد تشغيل الخدمة حتى تُحسب المتجهات من جديد. معرفة قديمة أخطر من غياب البوت، لأن الزبون يثق بالجواب الظاهر في الدردشة.
بناء بوت خدمة عملاء بالعربي على سيرفرك
المثال التالي يعمل على Node.js. ثبّت الحزم openai وexpress وdotenv، وضع المفتاح في .env. النموذج ومتجه النصوص قابلان للتبديل من البيئة. الكود يحسب تشابه جيب التمام، ويستدعي النموذج مع أدوات: واحدة لجلب حالة طلب، وواحدة لتحويل المحادثة إلى موظف.
```javascript import "dotenv/config"; import fs from "node:fs"; import express from "express"; import OpenAI from "openai";
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY }); const CHAT_MODEL = process.env.OPENAI_MODEL || "gpt-4o-mini"; const EMBED_MODEL = process.env.OPENAI_EMBED_MODEL || "text-embedding-3-small"; const MAX_HISTORY = 8;
const SYSTEM_PROMPT = أنت موظف دعم لمتجر سوري. تجيب بالعربي الفصحى المبسطة. تعتمد فقط على المعرفة المرفقة وعلى نتيجة الأدوات. إذا لم تجد الجواب في المعرفة، قل ذلك بوضوح واعرض تحويل المحادثة لموظف. لا تؤكد أن دفعة وصلت، ولا تخمّن حالة طلب، ولا تختلق رقم محفظة أو سعر شحن. تأكيد الدفع يتم عبر رقم العملية في صفحة الطلب أو عبر موظف، لا عبر هذه الدردشة.;
function cosine(a, b) { let dot = 0; let na = 0; let nb = 0; for (let i = 0; i < a.length; i++) { dot += a[i] * b[i]; na += a[i] * a[i]; nb += b[i] * b[i]; } return dot / (Math.sqrt(na) * Math.sqrt(nb) || 1); }
function loadChunks(path) { return fs.readFileSync(path, "utf8") .split(/\n---\n/) .map((part) => part.trim()) .filter(Boolean); }
async function embed(texts) { const result = await openai.embeddings.create({ model: EMBED_MODEL, input: texts, }); return result.data.map((row) => row.embedding); }
const chunks = loadChunks("./store-knowledge.txt"); const chunkVectors = await embed(chunks);
async function retrieve(question, k = 3) { const [query] = await embed([question]); return chunks .map((text, i) => ({ text, score: cosine(query, chunkVectors[i]) })) .sort((a, b) => b.score - a.score) .slice(0, k) .filter((row) => row.score > 0.25) .map((row) => row.text); }
// استبدل هذا الاستعلام بجدول طلباتك. لا تُرجع طلبًا إلا بعد تطابق رقم الطلب والهاتف. async function findOrder({ orderId, phone }) { const order = await orders.findByIdAndPhone(orderId, phone); if (!order) return { found: false }; return { found: true, orderId: order.id, status: order.status, amount: order.amount, paid: order.status === "paid", }; }
const tools = [ { type: "function", function: { name: "get_order_status", description: "جلب حالة طلب بعد رقم الطلب ورقم الهاتف المسجّل مع الطلب", parameters: { type: "object", additionalProperties: false, properties: { orderId: { type: "string" }, phone: { type: "string" }, }, required: ["orderId", "phone"], }, }, }, { type: "function", function: { name: "handoff_to_human", description: "تحويل المحادثة لموظف دعم عندما لا يكفي الجواب الآلي", parameters: { type: "object", additionalProperties: false, properties: { reason: { type: "string" }, summary: { type: "string" }, }, required: ["reason", "summary"], }, }, }, ];
const sessions = new Map();
const app = express(); app.use(express.json({ limit: "32kb" }));
app.post("/support/chat", async (req, res) => { const { sessionId, message } = req.body || {}; if (!sessionId || typeof message !== "string" || message.trim().length < 2) { return res.status(400).json({ ok: false, error: "bad_request" }); }
const history = sessions.get(sessionId) || []; const knowledge = await retrieve(message); const knowledgeBlock = knowledge.length ? knowledge.map((t, i) => (${i + 1}) ${t}).join("\n\n") : "لا توجد فقرات قريبة في ملف المعرفة.";
const messages = [ { role: "system", content: SYSTEM_PROMPT }, { role: "system", content: معرفة المتجر:\n${knowledgeBlock} }, ...history, { role: "user", content: message.trim() }, ];
let reply = await openai.chat.completions.create({ model: CHAT_MODEL, messages, tools, tool_choice: "auto", temperature: 0.2, });
let choice = reply.choices[0]; const handoff = { needed: false, reason: null };
while (choice.finish_reason === "tool_calls") { const toolMessages = []; for (const call of choice.message.tool_calls) { const args = JSON.parse(call.function.arguments || "{}"); let output; if (call.function.name === "get_order_status") { output = await findOrder(args); } else if (call.function.name === "handoff_to_human") { handoff.needed = true; handoff.reason = args.reason; await notifySupportStaff({ sessionId, ...args, lastUserMessage: message }); output = { queued: true }; } else { output = { error: "unknown_tool" }; } toolMessages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify(output), }); } messages.push(choice.message, ...toolMessages); reply = await openai.chat.completions.create({ model: CHAT_MODEL, messages, tools, temperature: 0.2, }); choice = reply.choices[0]; }
const answer = choice.message.content?.trim() || "ما قدرت أجهز جوابًا الآن. اترك رسالتك أو راسل الدعم."; const nextHistory = [ ...history, { role: "user", content: message.trim() }, { role: "assistant", content: answer }, ].slice(-MAX_HISTORY); sessions.set(sessionId, nextHistory);
return res.json({ ok: true, answer, handoff }); });
app.listen(process.env.PORT || 3000); ```
orders.findByIdAndPhone وnotifySupportStaff تكتبهما أنت على جدولك ومجموعة تيليغرام الدعم. لا تُرجع قائمة طلبات بالهاتف وحده، حتى لا يطّلع أحد على طلبات غيره. احفظ الجلسات في Redis أو في قاعدة إن كان عندك أكثر من عملية سيرفر، لأن Map في الذاكرة تضيع عند إعادة التشغيل ولا تُشارك بين الحاويات.
قبل الإنتاج أضف حدًا للمعدل على /support/chat، واقطع الرسائل الأطول من حدك، ولا تمرّر تاريخًا مفتوحًا بلا سقف. كل رسالة تستهلك رموزًا من معرفتك ومن التاريخ ومن الجواب.
أين يظهر البوت للزبون
في الموقع، نموذج صغير يرسل sessionId ثابتًا في المتصفح (معرّف عشوائي يُحفظ في sessionStorage) ونص الرسالة إلى /support/chat. لا تستدعِ OpenAI من المتصفح بالمفتاح.
في تيليغرام، ويب هوك يستخرج نص الرسالة ومعرّف المحادثة، ويستعمل معرّف المحادثة كـsessionId، ثم يرد بـsendMessage. المنطق نفسه. لا تخلط أوامر الطلب والدفع مع أسئلة الدعم في مفسّر واحد من غير حالات واضحة؛ الزبون الذي يرسل رقم عملية يجب أن يدخل مسار التأكيد، لا مسار «اشرح لي كيف أدفع».
إذا كانت المواعيد تُحجز عندك على واتساب، البوت يجيب على الأسئلة العامة، لكن الحجز نفسه أوضح بصفحة مواعيد. كتبت هذه المقارنة في نظام حجز أونلاين مقابل مواعيد واتساب.
انشر الخدمة خلف HTTPS. الدليل العملي في نشر مشروع Node.js على VPS بـ Docker وNginx.
كيف تحدّث المعرفة وتحصر التكلفة
بعد الأسبوع الأول ستظهر أسئلة لم تكتبها في الملف: شركة شحن تغيّرت، أو منطقة لا توصلون إليها، أو صياغة مثل «سيرياتيل» و«سيريتيل» يقصد بها الزبون سيريتل كاش. أضف هذه الصيغ في فقرة الدفع حتى يسترجعها البحث بالمتجهات، واكتب الاسم الرسمي سيريتل في الجواب الذي تريد أن يكرره البوت.
يمكنك إضافة مسار داخلي محمي يعيد تحميل الملف وحساب المتجهات من دون إعادة بناء الصورة، إذا كنت تحدّث المعرفة كثيرًا. إلى أن تحتاج ذلك، إعادة التشغيل بعد تعديل الملف أوضح وأقل مفاجآت.
ضع حدًا لعدد الطلبات لكل sessionId ولكل عنوان IP في الدقيقة، وحدًا لطول الرسالة. اضبط max_tokens على جواب قصير يكفي للدعم (بضع مئات من الرموز تكفي في العادة). راقب التكلفة يوميًا في الأسبوع الأول، لا في نهاية الشهر. إذا ربطت البوت بتيليغرام عام، أي شخص يقدر يفتح محادثة ويستهلك رصيدك. لا تتركه مفتوحًا بلا قيد.
الجلسات في المثال مخزّنة في الذاكرة. هذا يكفي للتجربة. في الإنتاج، خزن آخر ثماني رسائل في Redis مع مهلة انتهاء، حتى لا تبقى محادثة أسبوع كامل تُرسل في كل طلب إلى النموذج. التاريخ الطويل يرفع التكلفة.
إذا كان عندك أتمتة لطلبات جديدة وإشعارات للمطبخ أو للمحاسب، أبقِ ذلك خارج هذا البوت. مسار أتمتة شغل متجرك بـ n8n ينقل الحدث للفريق. بوت الدعم يجيب الزبون. خلط الاثنين في محادثة واحدة يجعل رسالة «طلب جديد» تُعامل كسؤال، أو يجعل الزبون يظن أن إشعار المطبخ تأكيد دفع.
اختبارات قبل فتح الدردشة للزوار
اسأل: «كيف أدفع؟» يجب أن يذكر سيريتل كاش أو شام كاش كما في ملفك، ويطلب رقم العملية في الصفحة، ولا يخترع حقل ملاحظة في التحويل.
اسأل عن حالة طلب برقم صحيح وهاتف صحيح، ثم برقم صحيح وهاتف غلط. الحالة الثانية يجب أن تفشل من دون تسريب بيانات.
اسأل: «وصلكم التحويل؟ دفعت هلق.» الجواب المقبول: لا يؤكد البوت الدفع، ويشرح أين يُدخل رقم العملية، أو يحوّل لموظف.
غيّر فقرة الشحن في الملف وأعد التشغيل، ثم اسأل السؤال نفسه. إذا بقي الجواب القديم، المتجهات لم تُحدَّث.
راجِع تكلفة عشر محادثات تجريبية من لوحة OpenAI قبل الإعلان عن البوت في المتجر.
اسأل باللهجة كما يكتب الزبون: «الطلب لوين وصل»، «كيف حول سيرياتيل». إذا رد بإنكليزية، أو أعاد صياغة العنوان من غير جواب، راجع تعليمات النظام ودفء النموذج (temperature عند 0.2 كما في المثال يقلل الإنشاء الحر). إذا استرجع فقرة غلطًا (الشحن بدل الدفع)، أعد صياغة عناوين الفقرات في الملف لتصير أوضح، أو ارفع عتبة التشابه قليلًا فوق 0.25 وجرّب من جديد على الأسئلة الحقيقية لا على أسئلة مختارة بعناية. بعد أسبوع، اقرأ أسباب التحويل إلى الموظف التي سجّلتها handoff_to_human. كل سبب يتكرر هو فقرة ناقصة في الملف. أضفها، وأعد تحميل المعرفة، وأعد السؤال نفسه.
أسئلة تتكرر
هل يجب أن يكون الجواب فصحى أم لهجة؟
أنا أضبط التعليمات على فصحى مبسطة، وأترك للزبون أن يسأل كما يكتب. إذا أجبت باللهجة في المعرفة نفسها، البوت سيميل إلى نقلها. المهم الاتساق، لا استعراض اللهجة.
هل أستخدم هذا البوت لتأكيد سيريتل كاش؟
لا. التأكيد يتم في صفحة الطلب أو في بوت الدفع عبر رقم العملية والبوابة. هذا البوت يشرح الخطوة، ولا يعلّم الطلب مدفوعًا.
ماذا عن خصوصية الرسائل؟
نصوص الزبائن تُرسل إلى OpenAI حسب عقدك معهم. لا تضع في المعرفة بيانات زبائن حقيقيين، ولا ترسل في السياق رقم بطاقة أو سرًا. إن احتجت إبقاء النصوص داخل بنيتك فقط، هذا قرار منتج مختلف ولا تغطيه هذه المقالة.
كم يكلف التشغيل؟
تدفع لمزوّد النموذج حسب الاستهلاك، وتدفع استضافة السيرفر. لا أضع هنا رقمًا ثابتًا لأن التسعير يتغيّر حسب النموذج وحجم المعرفة وعدد المحادثات. راقب الاستخدام من اليوم الأول وضع حدًا.
إذا بدك أركّب البوت داخل موقعك أو داخل تيليغرام، من صفحة البوتات والأتمتة أو من صفحة التواصل. خدمة بوت تيليغرام أو واتساب تبدأ من 60 دولارًا مرة واحدة. اذكر نوع المتجر، وأين تريد الدردشة، وهل عندك ملف أسئلة جاهز.