Wise
اربط Wise برمز API للقراءة فقط ليتمكّن وكيلك من تسعير أسعار الصرف وقراءة الأرصدة والمستفيدين والمعاملات, دون أن يحرّك أي أموال أبدًا.
اربط Wise برمز API واحد للقراءة فقط، فيكتسب وكيلك سبع أدوات مالية: خمس أدوات خاصة بالمالك تقرأ ملفات التعريف والأرصدة والمستفيدين وسجل المعاملات لديك، إضافةً إلى أداتين آمنتين للعموم تعرضان سعر صرف مباشرًا وتقدّران تكلفة تحويل. قاعدة واحدة تحدّد التكامل بأكمله: Wise هنا يقرأ ويسعّر, ولا يحرّك أي أموال أبدًا.
الربط
- في Wise، أنشئ رمز API (Settings ← API tokens) للبيئة التي تستخدمها, production أو sandbox.
- افتح التكاملات في AnyBot واختر Wise.
- الصق الرمز، واختر البيئة المطابقة، ثم اربط. تتحقّق AnyBot من الرمز مقابل ملفات تعريف Wise لديك وتلتقط ملف تعريفك الأساسي.
المزلق التمكيني: يجب أن تطابق البيئة المكان الذي صدر منه الرمز. فرمز production مُختار على أنه sandbox (أو العكس) يفشل في التحقّق, إذ تستطلع AnyBot GET /v2/profiles عند الربط وترفض في الحال أي رمز غير صالح أو من بيئة خاطئة. والرمز ثابت: فلا يوجد OAuth ولا تجديد تلقائي، لذا إن ألغيته أو دوّرته في Wise، فأعِد الربط هنا.
ويمكنك اختياريًا ضبط عملة افتراضية (رمز من ثلاثة أحرف) على التكامل, فهي تملأ مرشّح العملة مسبقًا حين يبحث الوكيل عن المستفيدين.
ما الذي يمكن للوكيل فعله
| الأداة | الوصول | النوع | ما تفعله |
|---|---|---|---|
wise_list_profiles | خاصة بالمالك | Read | Lists the personal and business profiles on the connected account with each profile's id and type. |
wise_list_balances | خاصة بالمالك | Read | Lists the multi-currency balances in a profile with each balance's id, currency, and available amount. |
wise_get_balance | خاصة بالمالك | Read | Reads one balance by id, currency, available and reserved amounts. |
wise_list_recipients | خاصة بالمالك | Read | Lists the saved recipient (payout) accounts on a profile, optionally filtered by currency. |
wise_list_transactions | خاصة بالمالك | Read | Lists recent account activity, transfers, card spend, conversions, fees, with status and paging. |
wise_get_rate | آمنة للعموم | Read | Returns the live Wise mid-market exchange rate between two currencies. |
wise_create_quote | آمنة للعموم | Read | Estimates a transfer's rate, fees, and amounts. An unauthenticated estimate. It never moves money. |
الآمنة للعموم مقابل الخاصة بالمالك
أداتا الأسعار آمنتان للعموم: يستطيع زائر الموقع أن يسأل «كم يساوي اليورو بالدولار؟» أو «كم ستكلّف حوالة 500 يورو؟» فيجيبه الوكيل. أمّا أدوات الحساب الخمس, ملفات التعريف والأرصدة والمستفيدون والمعاملات, فهي خاصة بالمالك وموسومة على أنها حسّاسة، لذا تبقى استدعاءاتها مخفيّة عن تدفّق الدردشة ولا يمكن لزائر أن يصل إلى حساب Wise لديك عبر وكيل أبدًا. ضَع أدوات الحساب على وكيل داخلي يتحدّث إليه فريقك، لا على وكيل يواجه العملاء.
مثال عملي
يسأل زائر في صفحة التسعير لديك: «أنا في المملكة المتحدة, كم ستصبح 2,000 جنيه إسترليني بالدولار بعد رسومكم؟» يشغّل الوكيل wise_get_rate للحصول على سعر GBP→USD المباشر، ثم wise_create_quote لإدخال رسوم Wise في الحساب، فيردّ بمبلغَي الإرسال والاستلام الحقيقيين, بلا إنشاء أي دفعة وبلا المساس بأي تسجيل دخول. أمّا فريقك المالي، على وكيل داخلي، فيستطيع إضافةً إلى ذلك أن يسأل «ما رصيدنا باليورو؟» فيحصل على نتيجة wise_list_balances.
الحدود والصراحة
- قراءة وتسعير فقط. كل أداة هي للقراءة فقط. ولا توجد أداة كتابة على الإطلاق, لا شيء يحرّك أموالًا أو ينشئ تحويلًا أو يغيّر مستفيدًا.
- رمز ثابت. لا OAuth ولا تجديد تلقائي. دوّره أو ألغِه في Wise، ثم أعِد الربط.
- قد تحتاج المعاملات إلى موافقة. بالنسبة إلى الرموز الشخصية، قد يقيّد Wise سجل المعاملات خلف مصادقة قوية للعميل بخطوتين؛ وتتدهور
wise_list_transactionsبلطف بدل أن تُخفق بخطأ.
استكشاف الأخطاء
- رُفض الاتصال عند الإعداد, الرمز غير صالح أو منتهي الصلاحية، أو أنّ البيئة لا تطابق. أعِد إصدار الرمز في Wise وأعِد الربط، مع مطابقة sandbox مقابل production.
- لا معاملات تُعاد, طلب Wise موافقة مصادقة ثنائية (SCA) لا يستطيع رمز API تلبيتها. وهذا حدّ يفرضه Wise على الرموز الشخصية، لا خلل.
- زائر لا يستطيع رؤية الأرصدة, بحكم التصميم. أدوات الحساب خاصة بالمالك؛ ولا يواجه الزوّار سوى السعر وعرض السعر.
الأسئلة الشائعة
هل يستطيع الوكيل إرسال أموال أو الدفع لشخص؟ لا. Wise للقراءة والتسعير فقط, ولا توجد أداة تحويل أو صرف.
هل يستطيع زائر الموقع رؤية أرصدتي؟ لا. الأرصدة والمستفيدون والمعاملات وملفات التعريف كلها خاصة بالمالك.
حساب شخصي أم تجاري؟ كلا الرمزين يعمل. وحين يوجد النوعان من ملفات التعريف، يُفضَّل ملف التعريف التجاري افتراضيًا.
التالي
- التجارة, زامِن كتالوجًا للتوصية بالمنتجات
- البحث على الويب, عمليات بحث مباشرة آمنة للعموم
- أدوات API المخصّصة, اربط أي شيء آخر
- قدرات الوكيل, كيف تُرفَق الأدوات بوكيل
- نظرة عامة على التكاملات
Slack (أدوات للقراءة فقط)
عائلة أدوات Slack للقراءة فقط, سرد القنوات، وقراءة السجل والسلاسل، والبحث عن المستخدمين، والبحث في الرسائل. خاصّة بالمالك، ولا تنشر أبدًا.
التجارة (WooCommerce وزحف الموقع)
زامِن كتالوج WooCommerce أو ازحف موقعك الإلكتروني ليوصي الوكيل بمنتجات حقيقية متوفّرة في المخزون ويسعّرها داخل محادثة. مزامنة، لا معاملات. وتُربط واجهات متاجر Shopify من متجر التكاملات.