← مركز التعلم English

الأتمتة وربط CRM باقتا Professional وEnterprise

اربط ثقة مع n8n أو Make.com أو Zapier أو أي CRM عبر واجهة الرسائل REST والويب هوك الموقّع. استقبل رسائل واتساب وانستجرام وماسنجر وتيليجرام وتيك توك داخل سير عملك — وأرسل الردود — بدون أي خادم خاص.

كيف يعمل ١. احصل على مفتاحك ٢. الاستقبال (ويب هوك) ٣. الإرسال (REST) n8n Make.com Zapier CRM

⚙️ كيف يعمل

تُتيح ثقة كل قناة متصلة عبر واجهة REST واحدة بسيطة بالإضافة إلى ويب هوك موقّع. أي أداة تستطيع استدعاء رابط HTTP يمكنها التواصل معها — فتربط ثقة بأتمتتك تماماً كأي تطبيق آخر:

متوافق مع: n8nMake.comZapier HubSpotSalesforceGoogle Sheets أي أداة HTTP

المرجع الكامل للواجهة: توثيق API ←

🔑 الخطوة ١ — احصل على مفتاح API

  1. من لوحة التحكم افتح لوحة البوت ← Messaging API.
  2. اضغط إنشاء مفتاح API، واختر القنوات المسموح بها، ثم احفظ.
  3. انسخ المفتاح — يبدأ بـ tk_live_ ويظهر مرة واحدة فقط. احتفظ به سرّياً.

عنوان الواجهة الخاص بك (يحتوي معرّف متجرك):

https://thikaa.com/<your-store>/api/messaging/
متاح في باقتي Professional وEnterprise. الرسائل الصادرة تستهلك رصيد ثقة المعتاد.

📥 الخطوة ٢ — استقبال الرسائل (ويب هوك)

على مفتاحك في صفحة Messaging API، ضع رابط ويب هوك HTTPS (رابط الالتقاط من n8n / Make / Zapier). كل رسالة واردة تُرسَل إليه بصيغة JSON:

POST <your webhook URL>
X-Thikaa-Event: message.received
X-Thikaa-Signature: sha256=<hmac>

{
  "event": "message.received",
  "instance_id": "inst_xxx",
  "timestamp": "2026-07-17T12:00:00Z",
  "data": {
    "channel": "wd",
    "conversation_id": 12345,
    "message_id": 67890,
    "from": "+201234567890",
    "text": "Hello, is this available?",
    "attachments": []
  }
}

تحقّق من التوقيع (موصى به)

كل طلب موقّع بسرّ التوقيع الخاص بمفتاحك. احسب HMAC-SHA256(raw_body, secret) وقارنه بترويسة X-Thikaa-Signature للتأكد أنه من ثقة فعلاً.

استجب بـ HTTP 200 بسرعة (خلال ~٢ ثانية). نفّذ المعالجة الثقيلة بشكل غير متزامن — الروابط البطيئة قد تُهمَل.

📤 الخطوة ٣ — إرسال الرسائل (REST)

من سير عملك، أرسل POST إلى نقطة الإرسال مع مفتاحك كـ Bearer:

curl -X POST "https://thikaa.com/<your-store>/api/messaging/?action=send" \
  -H "Authorization: Bearer tk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "wd",
    "to": "+201234567890",
    "message": "Thanks! Yes it is in stock ✅"
  }'
واتساب المباشر فقط يمكنه بدء محادثة جديدة مع رقم. على تيليجرام وماسنجر وانستجرام وتيك توك يجب أن يراسلك العميل أولاً (وإلا HTTP 409).

🔗 n8n

  1. الاستقبال: أضف عقدة Webhook (طريقة POST). انسخ رابط الإنتاج والصقه كرابط ويب هوك على مفتاح ثقة.
  2. (اختياري) أضف عقدة Crypto ← HMAC SHA256 على {{$json.body}} بسرّ التوقيع، وعقدة IF تقارنه بترويسة التوقيع.
  3. الإرسال: أضف عقدة HTTP Request ← POST إلى .../api/messaging/?action=send، وترويسة Authorization: Bearer tk_live_...، وجسم JSON {channel,to,message}.

🔗 Make.com

  1. الاستقبال: أضف وحدة Webhooks ← Custom webhook، انسخ عنوانها واجعلها رابط الويب هوك على مفتاح ثقة.
  2. الإرسال: أضف وحدة HTTP ← Make a request ← POST إلى نقطة الإرسال، وأضف ترويسة Authorization: Bearer tk_live_...، ونوع الجسم Raw / JSON بـ {channel,to,message}.

🔗 Zapier

  1. الاستقبال: مُشغّل Webhooks by Zapier ← Catch Hook. انسخ رابط الالتقاط إلى مفتاح ثقة.
  2. الإرسال: إجراء Webhooks by Zapier ← POST إلى نقطة الإرسال، مع ترويسة Authorization: Bearer tk_live_... وحمولة JSON {channel,to,message}.

🗂️ أي CRM (HubSpot، Salesforce، Sheets…)

اجمع الاتجاهين لمزامنة ثقة مع CRM عبر n8n / Make / Zapier:

نصيحة: اجعل رقم هاتف العميل هو المفتاح المشترك بين ثقة وCRM حتى تتطابق السجلات دائماً.

🚀 ابدأ

أنشئ أول مفتاح من لوحة البوت ← Messaging API، ثم اتبع وصفة أداتك أعلاه. تحتاج مساعدة؟ راسلنا على واتساب من الموقع.

ابدأ تجربة مجانية ٧ أيام ←  ·  المرجع الكامل للـ API ←