واجهة رسائل واحدة لكل القنوات

تتيح واجهة ثقة لأنظمتك وتطبيقاتك إرسال واستقبال الرسائل على كل قناة ربطتها — دون الحاجة لربط كل منصة على حدة. تحصل على نفس مسار التسليم والفوترة وصندوق الوارد الذي يستخدمه البوت الذكي.

1الرابط والمفتاح

أنشئ مفتاحاً من لوحة التحكم. كل مفتاح هو "نسخة" بقنواته ووويب هوك خاص. رابطك الأساسي يكون بالشكل:

https://thikaa.com/<your-account>/api/messaging/

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx

2إرسال رسالة

POST ?action=send

copycurl -X POST 'https://thikaa.com/<your-account>/api/messaging/?action=send' \
  -H 'Authorization: Bearer tk_live_xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "channel": "wd",
    "to": "+9665XXXXXXXX",
    "message": "Your order has shipped 🚚✅"
  }'

3الوسائط والإيموجي

الإيموجي تعمل على كل القنوات (نص UTF-8). الوسائط تُرفق عبر media_url:

copy{ "channel":"wd", "to":"+9665XXXXXXXX",
  "message":"فاتورتك 📄", "media_url":"https://you.com/invoice.pdf", "media_type":"document" }

4استقبال الرسائل (وويب هوك)

عيّن رابط وويب هوك HTTPS لمفتاحك. كل رسالة واردة من العميل — نص وإيموجي ووسائط — تُرسَل إليه عبر POST، موقّعة بـ HMAC-SHA256:

X-Thikaa-Event: message.received
X-Thikaa-Signature: sha256=<hmac>

{ "event":"message.received", "instance_id":"inst_xxxx",
  "data": { "channel":"wd", "from":"+9665XXXXXXXX",
    "text":"شكراً 🌹",
    "attachments":[{"type":"audio","url":"https://thikaa.com/.../voice.ogg"}] } }

تحقّق من التوقيع

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

5الحالة والأخطاء

GET ?action=status — حالة النسخة والقنوات والرصيد.