انتقل إلى المحتوى
Threadwire التوثيق

اكتب للبحث في كل الأدلة ونقاط نهاية الـ API.

ابدأ

مرحبًا بك في Threadwire

ما الذي تقدمه Threadwire WhatsApp API، وكيف تتصل بأنظمتك، وأسرع طريق للبدء: بالكود، أو بأدوات بلا كود، أو بإضافة جاهزة.

يربط Threadwire أنظمتك بواتساب عبر رقم واتساب لديك بالفعل. تربط الرقم بمسح رمز QR، كما في WhatsApp Web: بلا موافقة من Meta وبلا قوالب رسائل. ثم يرسل الكود الخاص بك بطلب REST واحد، ونرسل نحن كل رد وكل تحديث تسليم إلى الويب هوك الخاص بك.

ما الذي تحصل عليه

بعض الميزات تأتي مع بعض الباقات فقط: انظر الباقات والحدود.

كيف يعمل

  1. نظامك يستدعي الـ API بمفتاحك.
  2. Threadwire يتحقق منها، ويضعها في الطابور، ويضبط إيقاعها.
  3. رقم واتساب الخاص بك يرسلها من الهاتف المربوط.
  4. عميلك يقرؤها ويرد.

والعودة بالطريق نفسه معكوسًا. حين يرد أحد، أو تُسلَّم رسالة أو تُقرأ، نرسل حدثًا إلى عنوان الويب هوك الخاص بك.

الكلمة معناها
الرقم رقم واتساب واحد مربوط بـ Threadwire. تسمّيه الطلبات بمعرّفه، instance_id.
مفتاح API كلمة مرور نظامك للـ API، تُرسل بصيغة Authorization: Bearer …. مفتاح لكل نظام.
الرسالة رسالة واحدة إلى شخص أو مجموعة أو قناة. تنتقل status من queued إلى sent وdelivered وread، أو إلى failed مع السبب في error.
الحدث شيء حدث، مثل message.received أو message.status. يصل إلى الويب هوك الخاص بك، أو تجلبه بـ GET /v1/events.

كل طلب يذهب إلى https://threadwire.net/api/v1. يُرد على الإرسال بـ 202 فورًا، ثم تخرج الرسالة بإيقاع بشري.

اختر طريقة الربط

  • البدء السريع أول رسالة وردّها في خمس خطوات، مع كود بـ cURL وPHP وNode.js وPython.
  • مرجع الـ API كل نقطة نهاية، بحقولها وردودها وزر لتجربتها.
  • حزم Laravel وNode.js حزمنا ترسل، وتتحقق من توقيع الويب هوك، وتتعامل مع الأخطاء عنك.
  • n8n وMake وWooCommerce مسارات عمل جاهزة للاستيراد، وعقدة n8n، وإضافة لتحديثات الطلبات. بلا كود.
  • Postman كل طلب جاهز للتشغيل، مع ملفات نموذجية للإرسال.
  • وكلاء الذكاء الاصطناعي (MCP) دع مساعدًا ذكيًا يقرأ محادثاتك ويرسل عبر أرقامك.

تفضّل بلا كود إطلاقًا؟ لوحة التحكم في /app تربط الأرقام، وتردّ على المحادثات كفريق، وتضبط الردود التلقائية، وتشغّل الرسائل الجماعية.

ما تحتاجه

  • رقم واتساب على هاتف بيدك، على واتساب أو WhatsApp Business. الرقم المستخدم يوميًا منذ أشهر أكثر أمانًا من رقم جديد.
  • حساب في Threadwire. التجربة 7 أيام، ولا تحتاج بطاقة: سجّل.
  • للاستقبال: عنوان https:// عام يقبل POST. لا عنوان بعد؟ اجلب الأحداث بـ GET /v1/events بدلًا من ذلك.

من المهم أن تعرف

يربط Threadwire الرقم بالطريقة التي يربط بها WhatsApp Web. ليس هو WhatsApp Business API الرسمية، ولم تصنعه واتساب أو Meta ولا تتبنّاه. قد تقيّد واتساب أي رقم يرسل رسائل لم يطلبها الناس. فراسل من يتوقعونك، ودعهم يكتبون أولًا حيث تستطيع.

اقرأ كيف يحمي الإرسال رقمك قبل أن ترسل إلى من لم يكتبوا لك قط. لست متأكدًا أي طريق يناسبك؟ الواجهة الرسمية أم رقم مربوط؟ تقارن بينهما.