واجهة المطورين API باقتا Professional وEnterprise

🔑 المصادقة وعنوان الواجهة

أنشئ مفاتيح API من لوحة التحكم: صفحة Messaging API (كل مفتاح نسخة مستقلة بقنواتها المسموحة وويب هوك خاص بها). يظهر المفتاح مرة واحدة فقط — احفظه بأمان.

Base URL:  https://thikaa.com/<your-store>/api/messaging/

Authorization: Bearer <api_key>      (أو X-API-Key: <api_key>)

POST إرسال رسالة

POST /api/messaging/?action=send

cURL

curl -X POST "https://thikaa.com/<your-store>/api/messaging/?action=send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "wd",
    "to": "9647701234567",
    "message": "تحديث الوظائف الأسبوعي 👇 ..."
  }'

الاستجابة

{ "ok": true, "message_id": "...", "channel": "wd", "to": "9647701234567" }

GET حالة الحساب

GET /api/messaging/?action=status — يعيد حالة المفتاح والقنوات المسموحة والرصيد الحالي.

curl "https://thikaa.com/<your-store>/api/messaging/?action=status" \
  -H "Authorization: Bearer YOUR_API_KEY"

📥 ويب هوك استقبال الرسائل

حدّد رابط ويب هوك لكل مفتاح (من صفحة Messaging API). كل رسالة واردة من عملائك على قنوات المفتاح تُرسل POST إلى نقطتك بصيغة JSON وموقّعة بسرّ المفتاح:

POST <your-webhook-url>
Content-Type: application/json
X-Thikaa-Event: message.received
X-Thikaa-Signature: sha256=<hmac_sha256(body, webhook_secret)>

{ "event": "message.received", "instance_id": "...", "data": { ... } }

التحقق من التوقيع (PHP)

$body = file_get_contents('php://input');
$sig  = $_SERVER['HTTP_X_THIKAA_SIGNATURE'] ?? '';
$ok   = hash_equals('sha256=' . hash_hmac('sha256', $body, $secret), $sig);

التحقق من التوقيع (Node.js)

const crypto = require('crypto');
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers['x-thikaa-signature'] || ''));

🔔 ويب هوك أحداث المنصة

بشكل منفصل عن واجهة الرسائل، يمكن للمنصة إرسال أحداث إدارية إلى رابط واحد (الإعدادات ← Webhooks). من أهم الأحداث:

🧠 اربط مفتاح الذكاء الاصطناعي الخاص بك

يمكنك تشغيل بوتاتك على حسابك الخاص في مزود الذكاء الاصطناعي بدل رصيد المنصة: اربط مفتاح OpenAI أو Google Gemini أو Anthropic Claude من صفحة مزودي الذكاء الاصطناعي في لوحة التحكم، ثم اختر هذا الاتصال في إعدادات نموذج البوت. مفتاحك محفوظ داخل حسابك فقط ويُستخدم لبوتاتك وحدها.

⚠️ الأخطاء والحدود

عندك سؤال؟ راسلنا على واتساب من الموقع — سيساعدك فريقنا (أو بوتنا نفسه 😄).