OpenAPI وأدوات الذكاء الاصطناعي

رابطان ثابتان

كلاهما خارج بادئة اللغة، لأن المولّد والوكيل يريدان عنوانا واحدا لا يتحرك بلغة القارئ.

https://whats.azzamkh.sa/openapi.json
https://whats.azzamkh.sa/llms.txt

افتح مستند OpenAPI أو خريطة الموقع للوكلاء مباشرة.

ماذا يغطي

المستند دقيق فيما يصفه، وهو يصف ما هو موجود.

• المصادقة، والرسائل، والقنوات، والـ Sandbox، والـ QR، وجهات الاتصال، والمجموعات، والوسوم، والقوالب، والمحادثات، والـ webhooks، والاستهلاك، والخطة، وفحصي الصحة.
• سطح إدارة المنصة ونداء مزوّد الـ Sandbox خارج النطاق: فهما لا يحملان وعد توافق للعملاء.
• المستند مكتوب يدويا من متحكمات الـ API ومخططاتها لا مولَّدا، لأن الـ backend لا مولّد فيه ليُشغَّل.
• لا يظهر فيه ما ليس موجودا. لا مسارات حملات ولا أتمتة ولا تسجيل Meta ولا إرسال وسائط — فالمسار الذي يعطي 404 أسوأ من المسار الغائب في مستند يقرؤه مولّد.

استعماله

المستند بصيغة OpenAPI 3.1 ويُقدَّم بسياسة CORS متساهلة، فتستطيع أداة تعمل في المتصفح جلبه مباشرة.

• وجّه مولّد عميل إلى الرابط لتحصل على عميل مكتوب الأنواع بلغتك.
• استورد الرابط تعريفَ OpenAPI لتحصل على مجموعة جاهزة.
• أي عارض OpenAPI سيصيّره. وصيغة الأمان bearerAuth معلنة، فسيطلب العارض بيانات الاعتماد على الوجه الصحيح.

لأدوات البرمجة الذكية

أعطِ الوكيل الرابطين واسم متغيّر البيئة، فيستطيع تكوين طلبات صحيحة دون قراءة أي مصدر. وهذا prompt يعمل:

Use the WhatsApp messaging API at https://whats.azzamkh.sa/api.
Read https://whats.azzamkh.sa/llms.txt and https://whats.azzamkh.sa/openapi.json first.
Authenticate with "Authorization: Bearer $WA_API_KEY" — read the key
from the environment, never write it into a file.
Send an order confirmation with the order_confirmation template.