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

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

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الردود والتفاعلات والمجموعات والمكالمات

اقتبس رسالة بعينها، تفاعل معها، انشر في مجموعة واتساب، واعرف متى يرنّ رقمك:

copy// ردّ باقتباس — wd و wa و fb و ig و tg
{ "channel":"wd", "conversation_id":1290, "message":"نعم، متوفر", "reply_to":84990 }

// تفاعل — wd و wa و ig و tg (إيموجي فارغ يزيله)
POST ?action=react   { "message_id":84990, "emoji":"👍" }

// مجموعات واتساب — مغلقة لكل رقم حتى تشغّلها
POST ?action=groups-enabled   { "enabled":true }
GET  ?action=groups
{ "channel":"wd", "to":"120363043211234567@g.us", "message":"تحديث المسار 🚚" }

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

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