🏢 طبيعة العمل (يفهمها الوكلاء) ؟
اكتب نبذة عن شركتك ومجال عملها: شو بتبيعوا، السوق، الأسلوب، أي قواعد خاصة. الوكلاء (عدي/فهد/حمدي) بيقرأوها كـسياق ليفهموا طبيعة عملكم — وأي شركة ثانية تستخدم الوكيل بتكتب نبذتها هون. (لا تُكتب فيها أسرار/كلمات سر؛ تُعامَل كمعلومات خلفية فقط ولا تتجاوز قواعد الأمان.)
📱 رقم واتساب المشتريات (جسر الموردين) ؟
الرقم المخصّص اللي فهد بيستقبل منه ردود الموردين على واتساب. لتغييره: اكتب الرقم الجديد (دولي بدون +) واضغط «حفظ وإعادة ربط» — بيطلع رمز ربط جديد تكتبه بواتساب الرقم الجديد: الإعدادات ← الأجهزة المرتبطة ← ربط جهاز ← الربط برقم الهاتف.
الربط بالـ QR (الأنجح): افتح الصفحة، وامسح المربع من واتساب الرقم: الإعدادات ← الأجهزة المرتبطة ← ربط جهاز.
🛒 كلمات إرسال طلب التسعير + القناة ؟
لما المشتريات تكتب وحدة من هالكلمات على مهمة التسعير مع منشن @فهد، فهد بيبعت طلب التسعير (RFQ) للموردين. عدّلوها زي ما تحبوا (عربي + إنجليزي، افصلوا بفاصلة).
• كتبت «واتساب» ← يبعت واتساب فقط
• كتبت «ايميل» ← يبعت إيميل فقط
• ما حدّدت قناة ← يبعت إيميل + واتساب (الاثنين)
• كتبت رقم واتساب (+966…) ← يبعت لهاد الرقم مباشرة عبر الجسر
🪪 الوكلاء الذكيون — الأسماء والحسابات ؟
غيّر اسم كل وكيل واربطه بحساب أودو اللي بيتصرّف باسمه (كل ملاحظاته وكتاباته بأودو بتظهر بهالحساب). الاسم الجديد بيظهر بملاحظات الوكلاء وتنبيهات التلجرام. التاج (@) بأودو بيضل يشتغل لأنه مربوط بالحساب نفسه — لتغيير اسم التاج، غيّر اسم حساب أودو من إعدادات أودو.
Default salesperson ؟
Used as the final routing fallback when no recipient/owner matches.
Salespeople accounts ؟
Create a login for each salesperson. They sign in at /portal with their email and see/act on ONLY their own AI-drafted replies. The email must match their Odoo account so replies route to them.
🌴 البدلاء عند الغياب ؟
النظام بيقرأ إجازات أودو لحاله. حدّد لكل شخص مين بيغطّيه — وأي تاغ بينحوّل للبديل طول فترة الإجازة. بدون بديل، التاغ بيضل على الغايب مع تحذير.
Administrators & password ؟
Admins sign in here and can approve everything. Change any account's password, or add more admins.
Mailboxes to read ؟
Pick which company inboxes the agent reads. None selected = the single default mailbox only.
👥 قسم المتابعة (شخصيات المتابعة) ؟
موظفو متابعة افتراضيون: عدي بيبعت متابعات العملاء (مش الفرص) من إيميلاتهم بالتناوب — وكل عميل بيثبت على موظف واحد فما بيصير تكرار. لازم الإيميل يكون صندوق حقيقي على نطاق الشركة (Microsoft 365) عشان الإرسال والقراءة يشتغلوا. الردود على هالإيميلات بتدخل النظام وبيرد عليها عدي بنفس الشخصية. ما إلهم حسابات أودو — مسؤول الحساب ما بيتغير.
العميل اللي تاريخه/طلباته بتلمس هالكلمات بينربط بهالموظف، ورسائله (المتابعة وأول تواصل بارد) بتميل لهالأصناف بشكل طبيعي. اكتب الكلمات بالعربي والإنجليزي — وهي نفسها اللي بتظهر بسطر التخصص بأول رسالة باردة.
لما يكون مفعّل: متابعات القسم وردودهم على العملاء تنبعت فوراً بدون طابور الموافقة. قاعدة التحويل للمسؤول + CC والحد بالساعة بيظلوا شغالين.
🧑💼 قسم المبيعات الافتراضي ؟
مندوبو مبيعات افتراضيون (Account Executives): لما عميل يتجاوب مع المتابعة بطلب حقيقي، بيتحوّل لمندوب مبيعات ثابت من هون (CC على إيميل التحويل)، وعدي بيكمّل معه الصفقة كتابياً بهوية هالمندوب — عروض أسعار وردود ومفاوضات. خط أحمر مبرمج: المندوب الافتراضي ما بياخد مكالمات ولا اجتماعات أبداً — أي طلب صوتي/لقاء بيتحوّل للمدير الحقيقي. ردودهم بتظل بموافقتك (ما بيتأثروا بسويتش الإرسال المباشر تبع المتابعة). لازم الإيميل يكون صندوق M365 حقيقي على نطاق الشركة.
العميل اللي بيسأل عن كلمة من تخصص مندوب، بينربط بهالمندوب تلقائياً — وبيتصرف كـPresales: أسئلة اكتشاف صح (كم مستخدم؟ طبيعة العمل؟ خبرة سابقة؟) قبل التسعير، ومعلوماته من مخزن المعرفة (الداتا شيت واللينكات المرفوعة). ولما الصفقة تصير جدّية أو يطلب العميل اجتماع/مكالمة — بيحوّل للشخص الحقيقي المكتوب هون.
AI model ؟
Choose the provider and model the agent uses for each task. Claude is the default; the agent falls back to Claude if a provider key is missing.
API keys ؟
Stored server-side, never shown back. A green check means a key is set.
Supplier domains ؟
Email domains the agent treats as SUPPLIERS (for price-list ingestion, quote/TASK replies). Built-in domains are always included; add your own extra supplier domains below — one per line (e.g. mysupplier.com). Takes effect immediately.
Built-in: …
Also treat as suppliers the email domains of any Odoo vendor (supplier_rank>0), so NEW suppliers already in Odoo are recognized without adding their domain by hand. Free/public domains (gmail, hotmail…) and any domain used by a customer are excluded automatically. Refreshed every ~8h.
—
🚫 قائمة التجاهل / Ignore-list ؟
إيميلات من هذه الجهات يتجاهلها النظام تماماً — بدون رد، بدون فرصة، بدون معالجة. للنشرات، الإشعارات الآلية، والمرسِلين غير المرغوبين. (المرسِلون بـ no-reply@ / noreply@ متجاهَلون تلقائياً.)
⚠️ الدومينات العامة (gmail, hotmail, outlook…) لا يمكن تجاهلها كدومين — أضف الإيميل الكامل فقط، حتى لا يُسكت عميل حقيقي.
Price freshness (per brand) ؟
How many DAYS a supplier cost stays "fresh" before the agent treats it as stale (and reconfirms instead of quoting it firm). Different brands refresh at different cadences (e.g. Xerox ~yearly, Lenovo ~quarterly, everything else ~monthly). default applies to any brand without its own row.
Supplier offers (price lists) ؟
Review supplier price-list offers and match them to catalog products (vendor cost only — never the sale price) on the dedicated page.
Accounting / Finance team ؟
Pick the Odoo users who handle payments. When a customer sends a payment receipt, the agent assigns each of them an activity to verify it (and tells the customer it's being verified — not "confirmed").
Procurement team ؟
Pick the Odoo users who handle sourcing/purchasing. They are assigned the pricing tasks and are CC'd on the vendor RFQ emails the agent drafts (the agent never sends to a vendor without your approval).
When ON, the agent prepares the RFQ email(s) to the suggested vendor(s) — subject = TASK# — and puts them in the approval queue for the procurement team. Nothing is sent to a vendor until the team approves. Off by default.
When ON, a vendor reply (subject = TASK#) is read by the agent: it extracts the quoted cost, computes the sell (cost × markup, within guardrails), fills the task, and when all items are priced moves the task to Done Price and notifies. Off by default.
Procurement accounts ؟
Create a login for each procurement team member. They sign in at /portal with their email and see/approve ONLY the vendor RFQ drafts (not customer replies). Email must match their Odoo login.
Finance accounts ؟
Create a login for each finance team member. They sign in at /portal and see/approve ONLY the collections reply drafts (customer replies to payment reminders — promise to pay, already paid, disputes). Sales reps cannot approve these.
Markup & vendor channels ؟
Markup turns vendor COST into the customer SELL price: sell = cost × (1 + markup/100), kept within the pricing-policy guardrails (min margin / max discount).
📧 تصحيح إيميل المورد (يُحفَظ ويتعلّم) ؟
لو إيميل المورد غلط أو ناقص بأودو، صحّحه هون مرة وحدة — فهد بيستخدمه بكل طلبات الأسعار الجاية، وبيكتبه على بطاقة المورد بأودو كمان. (لِفهد، التصحيح يغلب إيميل أودو دايماً)
الإيميلات المصحّحة المحفوظة:
Approvals (human review per channel) ؟
When ON, the agent's drafts for that channel wait in the approval queue for a human to approve/edit before sending. When OFF, that channel auto-sends. Typical setup: Email ON (review before sending) and WhatsApp OFF (instant chat replies).
📱 رسائل واتساب (اللي الوكيل بيبعتها) ؟
الواتساب بيتبعت تلقائياً بدون موافقة. هون بتشوف آخر الرسائل الصادرة (من الوكيل) والواردة (من العميل) — مين، إيمتى، وشو الرسالة. مالها دخل بطابور الموافقات.
🎓 مركز التعلّم ؟
نظرة موحّدة على كل مخازن التعلّم. التحرير يتم داخل كل مركز — هون فقط الملخّص والروابط.
📈 جاهزية الاستقلالية ؟
تقدّم الوكلاء نحو العمل بدون موافقة بشرية. لكل فئة: الاستقلالية تنفتح عند ٩٥٪ موافقة-بلا-تعديل لـ١٤ يوم. «الظل» = الجودة الحقيقية لو الاستقلالية كانت مفعّلة؛ «الجودة» = إشارة أغنى تحسب حجم التعديل مش بس نسبته.
🛑 مفاتيح إيقاف الوكلاء ؟
تشغيل/إيقاف فوري لكل سلوك تلقائي للوكلاء (عدي/فهد/حمدي). لو وكيل تصرّف غلط، أطفئ مفتاحه من هون فوراً — بدون تعديل قاعدة بيانات. التغيير يسري مباشرة.
🧠 المدير — مراجعة وتعلّم ؟
المدير طبقة فوق وكلاء البيع والشراء: يصحّح كل مسودة قبل ما توصلك (فحص تسعير/سياسة/نبرة)، ويتعلّم منك — لما الوكيل ما يكون متأكد بسألك، وجوابك بصير قاعدة دائمة بيتبعها الوكلاء. ما بيتكرر السؤال إذا الجواب معروف. كله مطفّي افتراضياً.
لو ما رديت على سؤال المدير خلال المهلة، المجلس بيقرر ويعمل قاعدة مؤقتة (بتقدر تأكّدها أو تتراجع). الأسعار/الخصومات/الدفع/القانوني ما بتنفّذ تلقائياً — بتضل تنطر ردّك. والإرسال الخارجي بيضل يمر بالموافقة.
جلسة التأهيل (سؤال واحد كل مرة)
اضغط "السؤال الجاي" والمدير بيسألك عن تفاصيل الشغل، تجاوب، وكل جواب بصير قاعدة. اقعد براحتك — وقت ما بدك.
أسئلة المدير المفتوحة
أسئلة الوكيل صعّدها للمدير وما لقى لها جواب — جاوبها هون أو من Telegram (ابدأ ردّك بـ Q<رقم>:).
القواعد المتعلّمة — اضغط للعرض
🚀 Apollo — توليد Leads (عُدي) ؟
يولّد leads جديدة (صنّاع قرار/مشتريات بالسعودية) في CRM مُسنّدة لعُدي. عُدي يبعت أول تواصل بارد من OdaiAI (إيميل افتراضي)، والمندوبين يستلموا للمتابعة لما الليد يرد.
⚠️ بيبعت من OdaiAI. ابدأ بكمية صغيرة لحماية سمعة الإيميل. الإيميل افتراضي؛ واتساب البارد بدّه قالب Meta.
📁 وثائق الشركة (يرسلها الوكيل عند الطلب) ؟
ارفع الأوراق الرسمية اللي العملاء بيطلبوها. الوكيل بيعرف المتوفر ويرفقه تلقائياً لما العميل يطلبه. لو الوثيقة مش مرفوعة، الوكيل ما بيوعد فيها. (PDF أو صورة)
🏢 ملف الشركة (هوية المستأجر) ؟
القيم الفاضية = الافتراضي الحالي (Kangaroo Tools). أي تعديل بيسري خلال ~15 ثانية بدون إعادة تشغيل.
🌍 السوق والمنطقة ؟
أي تعديل بيسري خلال ~15 ثانية بدون إعادة تشغيل. القيم الفاضية = السعودية (الوضع الحالي).
🧠 تعلّم التجاوز (إيميلات بلا رد) ؟
وضع الظل 🌓 = بيقترح على الكرت بدون منع · فعالة 🟢 = بتمنع فعلياً · العدادات بتبين كم مرة انطبقت.
➕ إضافة قاعدة يدوية
⚖️ حوارس التسعير المتقدمة ؟
📬 صناديق المندوبين (لكل مستأجر) ؟
«فحص الاتصال» يدخل على الصندوق فعلياً (نفس طريقة الوكيل) ويقرأ رسالة — بيأكد إنه الربط شغّال قبل ما تعتمد عليه. احفظ الصندوق أولاً ثم افحص.
📱 جسر واتساب لكل مستأجر ؟
اختار المستأجر، حط رقمه، اضغط ربط — بيطلع كود ربط من 8 خانات يدخله بجوال الرقم: واتساب ← الإعدادات ← الأجهزة المرتبطة ← ربط برقم الهاتف.
🔌 ربط أودو (Odoo Mapping) ؟
📋 متطلبات الأودو للمستأجر الجديد — شو لازم تنشئ بأودوك قبل الربط
- مشروع "Price" بتطبيق Project مع 3 مراحل:
Requist(جديد) ←sent to vendor←done price— سجّل أرقام المراحل تحت. - على project.task (بـStudio): حقل many2one → crm.lead (ربط مهمة التسعير بالفرصة) + حقل Text باسم
x_studio_task_items_json(جدول الأصناف). - على crm.lead: حقل Boolean باسم
x_studio_crm_ai_follow_up("متابعة بشرية فقط" — لما يكون مفعّل الوكلاء ما بيلمسوا الفرصة). - على res.partner: حقل Boolean
x_studio_ai_follow_up(اشتراك العميل بالمتابعة الاستباقية) + حقل Selectionx_studio_kind_of_follow_upبقيم Email / WhatsApp / All. - على crm.lead (اختياري): حقل Char
x_studio_refrance(رقم الطلب المرجعي). - ضريبتان بأودوك: ضريبة بيع وضريبة شراء بنسبة بلدك — سجّل أرقامهم تحت.
- مستخدم أودو للوكيل الذكي (Internal) عشان الكتابة تكون باسمه — بتربطه من كرت هوية الوكلاء.
- مراحل الـCRM القياسية (Lead / Waiting Price / Quotation Sent / Won / Lost...) — أرقامها بتنضبط بمتغيرات البيئة STAGE_*.
بعد الإنشاء اضغط "افحص أودو" تحت — بيجيب لك أسماء الحقول والأرقام الموجودة فعلياً عشان تنسخها بدون ما تفتح أودو.
Pricing policy (margin & discount) ؟
Applies to every quote the agent makes — by email AND WhatsApp. The agent never lets the gross margin fall below the minimum margin, and never discounts more than the maximum discount. If the max discount would breach the margin floor, it applies the largest discount that still keeps the floor.
أوقات مراسلة الموردين (نوافذ ثابتة) ؟
فهد يراسل الموردين ويكشط أسعار المتاجر (Amazon/Noon/Extra/Jarir) فقط بهالأوقات الثابتة، كل الأيام. بكل نافذة يبعت رسالة وحدة لكل مورد كحد أقصى (الباقي للنافذة الجاية) فما ينغمر المورد، ويبقى إيميل واحد لكل مهمة فالرد يرجع للمهمة الصح. اكتب الساعات (٠–٢٣) مفصولة بفاصلة. الافتراضي: ٦ص، ١٠ص، ٢م، ٦م، ١٠م.
Store sourcing (auto-quote) ؟
When a requested product is NOT in the Odoo catalog, the agent scrapes the SAUDI stores below via Bright Data, picks the best real price, applies your markup, and adds it as a line on the DRAFT quote. The quote still needs human approval before sending. With this off or no key set, behavior is unchanged (manual procurement task only).
Stores searched (all Saudi): Amazon.sa · Noon (saudi-en) · Extra (en-sa) · Jarir (sa-en).
How to set up / change the Bright Data API key & zone
- Open brightdata.com and sign in (free trial available).
- Create a Web Unlocker product/zone and give it a name (e.g.
web_unlocker1) — put that exact name in the Bright Data zone box below. - Go to Account Settings → Users and API keys, create/copy an API key with Admin permission.
- Paste it in the Bright Data API key box below → Save key.
- Tick Enable auto-sourcing and set the Markup % → Save settings.
If the API key ever changes, just paste the new one here — nothing else needs redeploying. The service is paid (each product search costs Bright Data credits).
Outlook / Microsoft Graph (email) ؟
The credentials the agent uses to READ and SEND company email via Microsoft Graph. Leave blank to keep using the values from the server .env. Changing these takes effect without a restart.
Where to get these (Azure Portal)
- Azure Portal → Microsoft Entra ID → App registrations → your app.
- Application (client) ID and Directory (tenant) ID are on the Overview page.
- Client secret: Certificates & secrets → New client secret (copy the VALUE immediately).
- App-only mode (recommended): API permissions → add Application permissions
Mail.ReadWrite+Mail.Send→ Grant admin consent. Then set the mailbox below. - Delegated mode: leave the mailbox blank and provide a refresh token instead (advanced).
Current mode: —
🏢 الشركات — افتح/أضِف مستأجر (Tenants) ؟
سجّل كل شركة مرة وحدة، بعدين اختارها من القائمة لتعبّي إيميلها + Odoo + مفتاحها بالكروت تحت. الشركة تصير جاهزة 🟢 لما الثلاثة يكتملوا (✉️ + 🗄️ + 🔑).
🔑 مدراء المستأجرين (Tenant admins) ؟
أنت أدمن المنصة — فوق كل المستأجرين. كل مستأجر إله حساب أدمن خاص (اسم مستخدم + كلمة مرور) يدير شركته بمعزل. من هون تشوف مدراء الكل وتنشئ/تغيّر كلمة مرور أي واحد.
Email accounts (per-tenant: Gmail / Bluehost / IMAP) ؟
An agent mailbox for EACH tenant company. The Outlook/Graph card above is the legacy single mailbox; use this for tenants on Gmail (app password), Bluehost/cPanel, or any IMAP/SMTP host. Each tenant's inbox is read & replied to in isolation.
How to fill this (Gmail & Bluehost)
- Gmail: enable 2-Step Verification, then create an App Password (myaccount.google.com/apppasswords). Pick provider “Gmail”, enter the address, save, then paste the 16-char app password below.
- Bluehost / cPanel: pick “Bluehost”, enter the full email; host defaults to
mail.<domain>(override if your cPanel uses a different mail server). Save, then enter the mailbox password. - Use Test to confirm IMAP login + read before going live.
📮 صحة البريد (Deliverability) ؟
فحص حي: سجلات SPF/DKIM/DMARC للدومين، معدل الارتداد (٧ أيام) لكل شخصية إرسال، ومَن موقوف تلقائياً. الصحي أقل من 3%؛ فوق 5% = الشخصية بتتوقف لحالها لحماية سمعة الدومين.
Odoo accounts (per-tenant) ؟
Each tenant company points at its OWN Odoo database — full data separation. The live tenant (Kangaroo) keeps using the server .env Odoo and is NOT listed here. Add a row only for the NEW tenants.
What to enter
- Tenant ID: same key you used for that company's email account.
- URL: the tenant's Odoo JSON-RPC endpoint, e.g.
https://company.odoo.com/jsonrpc. - Database + login (email) + password (an Odoo API key is best). Test authenticates and reads their partner count — proving it hit THEIR Odoo, not Kangaroo's.
API keys (per-tenant) ؟
Each tenant uses its OWN LLM API key (BYOK). Set the tenant's key per provider here; the agent uses it for that tenant only. The global "API keys" card (under 🤖 الذكاء) is the fallback for the legacy Kangaroo tenant.
WhatsApp (Meta Cloud API) ؟
Lets the agent receive customer WhatsApp messages (processed like emails: classify, create lead, draft a reply for approval) and send replies / quotations / follow-ups. Uses Meta's official WhatsApp Cloud API.
Setup steps (Meta) & the 24-hour / template rule
- Open business.facebook.com → create/verify your Business.
- Add the WhatsApp product, connect a +966 number (or use the test number first).
- Copy the Phone Number ID and a permanent Access Token into the fields below.
- In Meta → WhatsApp → Configuration, set the webhook Callback URL to
/webhook/whatsappand the Verify Token to the value below, then subscribe to messages. - For proactive follow-ups (sent >24h after the customer's last message), create & get Meta to approve message templates — free-text only works within the 24h window.
Webhook Callback URL: /webhook/whatsapp
Email signature logo ؟
Shown ONLY in the fallback company signature (when a salesperson has no personal Odoo signature). Personal Odoo signatures keep their own logo. Use a public image URL (https). The company logo on quotation/invoice PDFs is set in Odoo (Settings → Companies).
Business-intelligence link (dashboard) ؟
Lets عدي/فهد pull RICH signals (customer pattern: growing/declining/stopped, etc.) from your BI dashboard. Optional — the agents still work without it (they use Odoo directly for credit, last price, vendor reliability). Point this at the dashboard and paste its per-tenant intel API key.
Telegram alerts (owner's phone) ؟
Get an instant push on your phone whenever something needs you — a customer reply ready for approval, a vendor RFQ, a payment to verify. Free, no app to install: just Telegram. Each alert links straight to the dashboard.
Setup steps (2 minutes)
- In Telegram, open @BotFather → send
/newbot→ pick a name. It replies with a bot token. - Paste the token below and click Save token.
- Open your new bot and send it any message (e.g. "hi"), then click Detect chat id below.
- Tick Enable, Save, then Send test. You're done.
Linked team members (salespeople + procurement link their own from /portal; each gets only their own alerts, you get all):