يقوم نظامك باستدعاء Whatsplaid للاستعلام عن الإمكانيات، إدارة جهات الاتصال، متابعة المحادثات، إرسال الرسائل، التحكم في وكيل الذكاء الاصطناعي وطلب الدعم البشري.
واجهة برمجة تطبيقات عامة والوثائق
قم بربط أنظمتك بـ Whatsplaid عبر واجهات برمجة التطبيقات (API) والموصلات وwebhooks.
استخدم واجهة برمجة التطبيقات العامة لدمج جهات الاتصال والمحادثات والرسائل والدعم البشري ووكيل الذكاء الاصطناعي. استخدم الموصل الخارجي للاستعلام عن بيانات نظامك وwebhooks لتلقي الأحداث في الوقت الفعلي.
ثلاثة عقود
اختر اتجاه التكامل الصحيح.
تفصيل توثيق Swagger للفلوات يفصل بينها لتجنب الالتباس بين الاستدعاءات إلى Whatsplaid، والاستفسارات التي يجريها المساعد، والأحداث المرسلة إلى نظامك.
يقوم Whatsplaid باستدعاء نظامك للاستعلام عن المنتجات أو الطلبات أو العملاء أو التوفر في الوقت الفعلي أثناء المحادثة.
تعرّف على الموصل الخارجي عبر APIWhatsplaid يرسل أحداث العملاء المحتملين، الرسائل، حالات التسليم، التذاكر والتغييرات في وكيل الذكاء الاصطناعي إلى عنوان URL مُكوّن.
يحتوي Swagger في `api.whatsplaid.com/docs/` على المخططات، الأمثلة، الاستجابات المتوقعة والعقود الفنية الكاملة.
مرجع سريع لنقاط النهاية الرئيسية.
تعرض هذه العرضية ملخصاً للميزات الموجودة في التوثيق الرسمي. يجب أن تتبع التنفيذ النهائي مواصفات Swagger.
GET
/store
يعيد بيانات الحساب، والتجارة الإلكترونية المتصلة، والوحدات النشطة.
Account
GET
/capabilities
يُظهر العمليات المتاحة فعليًا بحسب الحساب، والخطة، والوحدات، والتكاملات.
Account
GET
/ecommerce/products/search
ابحث عن المنتجات في التكاملات الأصلية المتصلة، مثل Nuvemshop أو Wix أو Shopify.
Ecommerce
GET
/ecommerce/orders/search
ابحث عن الطلبات بالرقم أو البريد الإلكتروني أو الهاتف عبر التكاملات الأصلية المتصلة.
Ecommerce
POST
/contacts
ينشئ أو يحدث جهة اتصال باستخدام رقم الهاتف كمفتاح أساسي.
Contacts
GET
/conversations
قائمة المحادثات التي بدأها جهات الاتصال، مع تجزئة الصفحات، نافذة الرد وحالة وكيل الذكاء الاصطناعي.
Conversations
GET
/conversations/{conversationId}/messages
يعيد سجل الرسائل المجزأ إلى صفحات لمحادثة.
Conversations
PATCH
/contacts/{contactId}/custom-fields
يحدِّث الحقول المخصصة للاستهداف والسياق التشغيلي.
Fields
POST
/messages/send
يرسل رسالة نصية ضمن نافذة المراسلة التي تستمر 24 ساعة في WhatsApp.
Messaging
POST
/handoffs
اطلب دعمًا بشريًا باستخدام تكوين الشركة الحالي.
Handoff
GET
/tickets
قائمة تذاكر الدعم البشري مع مرشحات وترقيم صفحات.
Tickets
POST
/tickets/{ticketId}/close
يغلق التذكرة، يبث الحدث المقابل ويعيد تفعيل وكيل الـAI للمحادثة.
Tickets
PATCH
/conversations/{conversationId}/ai-agent
فعل أو أوقف وكيل الذكاء الاصطناعي مؤقتًا فقط للمحادثة المحددة.
Conversations
GET
/ai-agent/prompt
يتحقق من المُطالَبَة القابلة للتحرير المستخدمة كتعليمات أساسية لوكيل الذكاء الاصطناعي.
AI Agent
PATCH
/ai-agent/prompt
قم بتحديث المطالبة القابلة للتحرير مع تحكم بالإصدارات لمنع الكتابة المتزامنة فوق البيانات.
AI Agent
عقود فنية
توثيق يغطي واجهة برمجة التطبيقات (API) والموصل الخارجي وwebhooks.
تفصل العقود بين الاستدعاءات المرسلة إلى Whatsplaid، والاستعلامات التي يجريها الوكيل في أنظمة خارجية، والأحداث المرسلة بواسطة Whatsplaid.
يتحقق من الحساب والقدرات، يدير جهات الاتصال والوسوم والحقول المخصصة، يتتبع المحادثات ويرسل الرسائل ضمن النافذة المسموح بها.
عرض وتحديث الـ prompt القابل للتحرير، ولتمكين أو إيقاف مؤقت للوكيل بشكل منفصل في كل محادثة.
الوصول إلى السجل، الترقيم الصفحات، نافذة الرد على WhatsApp وحالة وكيل الذكاء الاصطناعي الحالية.
قد يكشف نظامك عن استعلامات متعلقة بالمنتجات والطلبات والعملاء والتوافر لاستخدام الوكيل أثناء المحادثة.
الأحداث المتاحة: `lead.created`، `message.received`، `message.sent`، `message.status.updated`، `ticket.created`، `ticket.closed` و`conversation.ai_agent.updated`.
تستخدم webhooks المعرف `delivery_id` لإزالة التكرارات ومحاولات جديدة عند حالات الفشل المؤقتة. لا تعتبر عملية التسليم مكتملة إلا بعد استجابة HTTP 2xx.
هل تحتاج إلى تنفيذ أو التحقق من تكامل؟
افتح الوثائق التفاعلية للتبديل بين `Whatsplaid Public API` و`Custom Data Connector Contract` و`Outgoing Webhooks`.