لا يملك Spun حتى الآن تطبيقًا منشورًا يُثبَّت بنقرة واحدة في Zapier أو Make. لكن لديه REST API مصممة خصيصًا لهذا الغرض: إرسال رسائل واتساب، وإنشاء جهات الاتصال أو تحديثها، وتطبيق التسميات، والتحقق مما إذا كان الرقم يستخدم واتساب، إضافة إلى Webhooks صادرة للأحداث في الوقت الفعلي. ويتصل كلاهما مباشرة بخطوة «Webhooks by Zapier» في Zapier أو بوحدة HTTP في Make، وبعقدة «HTTP Request» في n8n بالطريقة نفسها.
هذا الدليل هو المسار الصريح الذي يعمل اليوم. إذا كنت تريد تطبيقًا رسميًا مدرجًا بدلًا من خطوة HTTP عامة، فراجع ملاحظات الجدوى المرتبطة في الأسفل لمعرفة ما يتطلبه إطلاقه.
1. أنشئ مفتاح API
- 1
افتح «مفاتيح API»
في صندوق الوارد في Spun: «الإعدادات»، ثم «الويب هوكس»، ثم «إدارة مفاتيح API»، ثم «مفتاح جديد».
- 2
سمّه واختر الصلاحيات
سمّه باسم مثل «Zapier Production». فعّل الصلاحيات التي تحتاجها فعلًا فقط: إرسال الرسائل، أو إدارة جهات الاتصال، أو قراءة جهات الاتصال، أو إدارة التسميات، أو قراءة التسميات، أو التحقق من أرقام الهواتف.
- 3
انسخه مرة واحدة
يُعرض المفتاح (الذي يبدأ بـ wap_) مرة واحدة فقط. احفظه في مخزن بيانات الاعتماد في منصة الأتمتة لديك، ولا تضعه أبدًا داخل خطوة في سير العمل أو في مستند مشترك.
2. استدعِ Spun من Zap أو Scenario أو Workflow
كل إجراء يُرسَل إلى عنوان URL الأساسي نفسه مع الترويسة نفسها. في Zapier، استخدم «Webhooks by Zapier» ثم «Custom Request»؛ وفي Make، وحدة HTTP مضبوطة على «Make a request»؛ وفي n8n، عقدة «HTTP Request» مع «Header Auth».
- check-phone: تحقّق من أن الرقم يستخدم واتساب قبل الإرسال (يقبل حتى 20 رقمًا في كل استدعاء).
- create-contact / update-contact: حافظ على تحديث سجل واتساب للعميل المحتمل من أي نموذج أو CRM.
- apply-label / remove-label: ضع تسمية على محادثة من مشغّل خارجي، مثلًا ضع تسمية «عميل محتمل جديد» على محادثة لحظة إرسال نموذج.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "15551234567",
"text": "Hello! Thanks for contacting us."
}إذا كانت قناة واتساب غير متصلة لفترة قصيرة، يظل send-message يُرجع نجاحًا مع علامة queued بدلًا من الفشل: تُرسل الرسالة تلقائيًا بمجرد إعادة اتصال القناة.
3. استقبل أحداث واتساب في Zapier أو Make
- 1
أنشئ خطوة الالتقاط أولًا
في Zapier، ابدأ Zap باستخدام «Webhooks by Zapier» ثم «Catch Hook»، وانسخ عنوان URL الذي يعطيك إياه. في Make، أضف وحدة المشغّل «Custom Webhook» وانسخ عنوان URL الخاص بها.
- 2
الصقه في Spun
«الإعدادات»، ثم «الويب هوكس»، ثم «إضافة ويب هوك». الصق عنوان URL واختر الأحداث التي يجب أن تُطلقه.
- 3
أطلق حدثًا تجريبيًا
أرسل لنفسك رسالة واتساب، ثم انقر «Test trigger» (في Zapier) أو شغّل السيناريو مرة واحدة (في Make) لالتقاط نموذج الحمولة الحقيقي.
{
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"event": "message.inbound",
"timestamp": "2026-08-18T10:30:00.000Z",
"org_id": "123",
"data": {
"message_id": "[email protected]_ABC123",
"chat_id": "[email protected]",
"from": "15551234567",
"type": "text",
"text": "Hello!"
}
}الأحداث المتاحة: رسالة واردة أو صادرة، وإنشاء جهة اتصال أو تحديثها أو حذفها، وتعيين تسمية، واكتمال تدفق دردشة، ومعالجة رسالة في قائمة الانتظار، وتأهيل عميل محتمل، وأرشفة محادثة، واكتمال مكالمة.
ما يجب معرفته قبل البناء عليه
- هذا ليس تطبيقًا مدرجًا يمكن البحث عنه في Zapier أو Make. لا توجد اليوم شاشة OAuth بعنوان «Connect your Spun account» داخل Zapier أو Make: تتم المصادقة بمفتاح API ثابت تلصقه بنفسك في ترويسات خطوة HTTP.
- لا يمكن حاليًا إنشاء اشتراكات Webhooks (جانب «استقبال الأحداث») إلا من داخل واجهة «الإعدادات» في Spun نفسه، وليس من جهة Zapier، لذا فإن المشغّل بأسلوب REST Hook الذي يشترك ذاتيًا غير متاح بعد.
- حد المعدل هو 60 طلبًا في الدقيقة لكل مفتاح API. اجمع عمليات التحقق من الأرقام (حتى 20 في كل استدعاء) بدلًا من تنفيذها واحدًا تلو الآخر حيثما أمكن.
ذات صلة: واتساب + Google Sheets (مدمج بالكامل، دون الحاجة إلى مفتاح API) · واتساب + HubSpot CRM