يقوم نظامك باستدعاء Whatsplaid للتحقق من الحسابات وإدارة جهات الاتصال والعلامات والحقول والمحادثات والسلة والرسائل والدعم البشري.
واجهة برمجة تطبيقات عامة والوثائق
قم بربط أنظمتك بـ Whatsplaid عبر واجهات برمجة التطبيقات (API) والموصلات وwebhooks.
استخدم واجهة برمجة التطبيقات العامة عندما يحتاج نظام آخر إلى تشغيل Whatsplaid. استخدم الموصل الخارجي عندما يحتاج المساعد إلى استعلام عن منتجات أو طلبات أو بيانات من نظامك أثناء المحادثة. استخدم webhooks لتلقي الأحداث التي يتم التقاطها على WhatsApp.
ثلاثة عقود
اختر اتجاه التكامل الصحيح.
تفصيل توثيق Swagger للفلوات يفصل بينها لتجنب الالتباس بين الاستدعاءات إلى Whatsplaid، والاستفسارات التي يجريها المساعد، والأحداث المرسلة إلى نظامك.
يقوم Whatsplaid باستدعاء نظامك للاستعلام عن المنتجات أو الطلبات أو العملاء أو التوفر في الوقت الفعلي أثناء المحادثة.
يقوم Whatsplaid بإرسال أحداث إلى عنوان URL تقوم بتوفيره. الحدث المعروض في لوحة التحكم هو الـ lead الذي تم التقاطه أثناء المحادثة.
يحتوي Swagger في `api.whatsplaid.com/docs/` على المخططات، الأمثلة، الاستجابات المتوقعة والعقود الفنية الكاملة.
مرجع سريع لنقاط النهاية الرئيسية.
تعرض هذه العرضية ملخصاً للميزات الموجودة في التوثيق الرسمي. يجب أن تتبع التنفيذ النهائي مواصفات Swagger.
GET
/store
يعيد بيانات الحساب، والتجارة الإلكترونية المتصلة، والوحدات النشطة.
Account
GET
/modules
قائمة الوحدات النشطة، مثل العملاء المحتملين، مستشار المبيعات، ما بعد البيع، قاعدة المعرفة وسلة الشراء.
Account
GET
/ecommerce/products/search
ابحث عن المنتجات في التكاملات الأصلية المتصلة، مثل Nuvemshop أو Wix أو Shopify.
Ecommerce
GET
/ecommerce/orders/search
ابحث عن الطلبات بالرقم أو البريد الإلكتروني أو الهاتف عبر التكاملات الأصلية المتصلة.
Ecommerce
POST
/contacts
ينشئ أو يحدث جهة اتصال باستخدام رقم الهاتف كمفتاح أساسي.
Contacts
PATCH
/contacts/{contactId}/custom-fields
يحدِّث الحقول المخصصة للاستهداف والسياق التشغيلي.
Fields
POST
/messages/send
يرسل رسالة نصية ضمن نافذة المراسلة التي تستمر 24 ساعة في WhatsApp.
Messaging
POST
/handoffs
اطلب دعمًا بشريًا باستخدام تكوين الشركة الحالي.
Handoff
عقود فنية
توثيق يغطي واجهة برمجة التطبيقات (API) والموصل الخارجي وwebhooks.
قائمة التكاملات في ADMIN تستخدم نفس الفصل: Whatsplaid Public API، موصل خارجي للاستعلامات في الأنظمة الداخلية وwebhook صادر للعملاء المحتملين الملتقَطين.
يُتحقق من الحساب والوحدات وجهات الاتصال والوسوم والحقول المخصصة والرسائل والمحادثات وسلة المشتريات والدعم البشري.
يعرّض نظامكم نقاط نهاية مثل `/products/search` و`/orders/search` ليقوم Whatsplaid باستعلامها أثناء المحادثة.
العائد المتوقع مع `products`، بما في ذلك المعرف، الاسم، الوصف، السعر، التوفر، المخزون، عنوان URL والصورة.
الاستجابة المتوقعة مع `orders`، بما في ذلك الرقم، الحالة، الدفع، الشحن، الإجمالي، العميل، التتبع والعناصر.
يرسل الحدث `LEAD_CAPTURE` بيانات العميل المحتمل إلى عنوان URL المُكوَّن. يجب أن يستجيب نقطة النهاية برمز HTTP 200 أو 204.
استخدم `Authorization: Bearer` في الاستدعاءات. يجب عدم كشف الرموز في الواجهة الأمامية العامة.
هل تحتاج إلى تنفيذ أو التحقق من تكامل؟
افتح الوثائق التفاعلية للتبديل بين `Whatsplaid Public API` و`Custom Data Connector Contract` و`Outgoing Webhooks`.