توثيق واتساب بنقرة واحدة لأودو 19
دليل مصوّر قصير: ثبّت الوحدة وانقر زر واتساب في جهات الاتصال والطلبات والفواتير واكتب رسائلك. وللمطورين فصل صغير عن الواجهة البرمجية.
يشرح الإصدار 1.0.0حُدّث في 22 أكتوبر 2026
ابدأ من هنا
ببساطة: تضع هذه الوحدة زر واتساب بجانب رقم هاتف العميل في جهات الاتصال وأوامر البيع والفواتير. نقرة واحدة تفتح واتساب برسالة مكتوبة مسبقًا. لا شيء تربطه: لا حساب Meta ولا توثيق أعمال ولا مفاتيح API ولا رسوم شهرية.
| تنقر | ماذا يحدث |
|---|---|
| زر واتساب | يفتح واتساب (تطبيق الهاتف أو واتساب للكمبيوتر أو واتساب ويب) على محادثة مع العميل. |
| لا شيء آخر | الرسالة مكتوبة مسبقًا من قالبك أنت. تقرؤها وتعدّلها إن أردت ثم تضغط إرسال في واتساب. |
نصيحة: لأن الرسالة تُرسل من حسابك أنت على واتساب فهي ليست بثًّا آليًا. استخدم الوحدة للمحادثات الفردية: أسئلة الطلبات وتذكير الدفع وتحديثات التسليم.
ماذا تضيف إلى أودو
| المكان | ما تراه |
|---|---|
| جهات الاتصال | زر واتساب تحت رقم الهاتف. |
| أوامر البيع | سطر الهاتف تحت العميل مع زر واتساب. |
| الفواتير والإشعارات الدائنة | السطر نفسه تحت العميل أو المورّد. |
| الإعدادات ← واتساب | ثلاثة قوالب رسائل (جهة اتصال وأمر بيع وفاتورة) وخيار واحد. |
| سجل الرسائل (Chatter) | ملاحظة خاصة اختيارية في كل مرة تُفتح فيها محادثة (من فتحها وأي رقم). |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | المبيعات والفوترة (تعتمد الوحدة على sale وaccount) |
| على حاسوب المستخدم أو هاتفه | واتساب مثبّت أو متصفح لاستخدام واتساب ويب |
| حساب واتساب | أي حساب عادي أو أعمال لمن ينقر. دون API. |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_whatsapp_click_to_chat.zip؛ فُكّه لتحصل على المجلدtaqnix_whatsapp_click_to_chat. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن WhatsApp Click-to-Chat واضغط تثبيت.
# أو من سطر الأوامر ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_whatsapp_click_to_chat --stop-after-init
نصيحة: بعد التثبيت اضغط
Ctrl+Shift+R (أو Cmd+Shift+R) مرة واحدة لتحميل الأزرار الجديدة.الاستخدام
ببساطة: افتح جهة اتصال أو أمر بيع أو فاتورة. إن كان للعميل رقم هاتف فسترى زر واتساب بجانبه. انقر عليه.
- افتح السجل: جهة اتصال أو أمر بيع أو فاتورة.
- انقر واتساب تحت رقم الهاتف.
- يفتح واتساب على محادثة العميل مع رسالتك مكتوبة.
- راجع الرسالة وعدّلها إن أردت وأرسلها من واتساب.
ببساطة: تُبنى الرسالة الأولى من قوالبك (الفصل 6). مثال لفاتورة: «مرحبًا Deco Addict، معك My Company بخصوص الفاتورة INV/2026/00002 بمبلغ $48,012.50، تاريخ الاستحقاق 2026-11-30. شكرًا لك!»
الرسائل والإعدادات
ببساطة: افتح الإعدادات ← واتساب. يمكنك كتابة رسالة لكل نوع مستند، ولكل شركة رسائلها.
| العنصر البديل | يُستبدل بـ | أين يعمل |
|---|---|---|
{partner_name} | اسم العميل | الكل |
{company_name} | اسم شركتك | الكل |
{user_name} | مستخدم أودو الذي ينقر | الكل |
{document_name} | S00012 أو INV/2026/00002 | الطلبات والفواتير |
{amount} | إجمالي الطلب أو المبلغ المتبقي من الفاتورة | الطلبات والفواتير |
{due_date} | تاريخ استحقاق الفاتورة (فارغ عند السداد) | الفواتير |
{due_date_part} | «، تاريخ الاستحقاق 2026-11-30» أو لا شيء إذا سُدّدت الفاتورة | الفواتير |
نصيحة: اكتب الرسائل بلغة عملائك. وإن كانت لديك عدة لغات مثبّتة فيمكنك ترجمة كل رسالة (افتح الحقل واستخدم أيقونة الترجمة).
أرقام هواتف تعمل
ببساطة: يحتاج واتساب الرقم مع رمز الدولة ولا شيء غيره. تنظّف الوحدة الرقم عنك فيستمر الموظفون بكتابة الأرقام كما اعتادوا.
| المكتوب في أودو | المُرسل إلى واتساب | السبب |
|---|---|---|
| +971 50 123 4567 | 971501234567 | حُذفت المسافات والعلامة + |
| 00971 50 123 4567 | 971501234567 | 00 في البداية تعني دوليًا |
| (+971) 50-123-4567 | 971501234567 | حُذفت الأقواس والشرطات |
| 050 123 4567 | 971501234567 | رقم محلي: يُضاف رمز دولة جهة الاتصال (أو دولة شركتك) ويُحذف الصفر |
| (415) 555-0132 والدولة الولايات المتحدة | 14155550132 | رمز الدولة من دولة جهة الاتصال |
مهم: الرقم المحلي مثل 050… يحتاج دولة على جهة الاتصال (أو على شركتك) ليصير رقمًا كاملًا. وإن تعذّر على الوحدة تكوين رقم صحيح فستخبرك ولن يُفتح شيء.
ملاحظة سجل الرسائل
في كل مرة يفتح أحدهم محادثة يمكن للوحدة أن تترك ملاحظة خاصة على السجل: «قام Mitchell Admin بفتح محادثة واتساب مع +971501234567.» تساعد الفريق على معرفة من تواصل مع العميل ومتى. أوقفها من الإعدادات ← واتساب ← تسجيل المحادثات في سجل الرسائل.
للمطورين
ببساطة: تجاوز هذا الفصل إن كنت تستخدم الوحدة فقط.
| البند | التفاصيل |
|---|---|
| النموذج | taqnix.whatsapp.chat (مجرّد). لا تُحفظ بيانات. |
chat_url(res_model, res_id, number) | استدعاء RPC يعيد رابط https://wa.me/…?text=… ويسجّل المحادثة إن كان ذلك مفعّلًا. |
normalize_number(number, country) | يعيد الأرقام فقط أو يرفع UserError. |
render_message(record) | يملأ قالب الشركة للسجل. |
| الأداة | widget="wa_phone": استخدمها على أي حقل Char لتحصل على الزر. |
<!-- أظهر الزر بجانب حقل هاتف آخر، مثلًا في الموظفين -->
<field name="mobile_phone" widget="wa_phone"/>
# Python
url = self.env['taqnix.whatsapp.chat'].chat_url('res.partner', partner.id, partner.phone)استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لا يوجد زر واتساب | ليس للعميل رقم هاتف، أو تحتاج إلى تحديث قوي (Ctrl+Shift+R) بعد التثبيت. |
| «لا يبدو رقم هاتف صحيحًا» | أضف رمز الدولة (+971…) أو حدّد الدولة على جهة الاتصال. |
| يقول واتساب إن الرقم ليس على واتساب | الرقم صحيح لكن صاحبه لا يستخدم واتساب، أو أنه رقم أرضي. |
| المتصفح يمنع النافذة الجديدة | اسمح بالنوافذ المنبثقة لعنوان أودو. |
| ما زالت الرسالة تحوي كلمات بين { } | عنصر بديل مكتوب خطأ. استخدم فقط ما ورد في الفصل 6. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_whatsapp_click_to_chat. تبقى رسائلك محفوظة. للإزالة ألغِ التثبيت من التطبيقات: تختفي الأزرار ولا تبقى بيانات على جهات الاتصال أو الطلبات أو الفواتير (وتبقى ملاحظات سجل الرسائل كملاحظات عادية).
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.