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

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

ابدأ

البدء السريع

أرسل أول رسالة واتساب عبر Threadwire API في خمس خطوات: حساب، ورقم مربوط، ومفتاح API، وطلب، وويب هوك.

أرسل أول رسالة واتساب عبر الـ API، واستقبل الرد، في نحو خمس دقائق. تحتاج الهاتف الذي عليه رقم واتساب الخاص بك، وهاتفًا ثانيًا تكتب منه.

خمس خطوات

  1. افتح حسابًا

    سجّل في /app/register. التجربة 7 أيام، ولا تحتاج بطاقة.

  2. اربط رقم واتساب الخاص بك

    في لوحة التحكم، اضغط إضافة رقم. على الهاتف، افتح واتساب، واذهب إلى الإعدادات ← الأجهزة المرتبطة ← ربط جهاز، وامسح رمز QR. حين يظهر الرقم متصلًا، انسخ معرّف الرقم من صفحته.

  3. أنشئ مفتاح API

    افتح للمطورين ← مفاتيح API ← مفتاح جديد (للمسؤولين فقط). انسخ المفتاح فورًا: يُعرض مرة واحدة فقط. أبقِه على خادمك، ولا تضعه أبدًا في صفحة ويب أو تطبيق.

  4. أرسل رسالة إلى نفسك

    من هاتفك الثاني، اكتب "hi" إلى رقمك أولًا: يفتح chat_link الخاص بالرقم تلك المحادثة. ثم أرسل إلى الهاتف الثاني. YOUR_PHONE هو رقمه بالصيغة الدولية، مثل 201012345678: رمز الدولة، بلا 0 في البداية.

    curl https://threadwire.net/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instance_id": "YOUR_INSTANCE_ID", "to": "YOUR_PHONE", "text": "Hello from Threadwire"}'

    $request = curl_init('https://threadwire.net/api/v1/messages');
curl_setopt_array($request, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json', 'Accept: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['instance_id' => 'YOUR_INSTANCE_ID', 'to' => 'YOUR_PHONE', 'text' => 'Hello from Threadwire']),
]);
$message = json_decode(curl_exec($request), true)['data'];

    const response = await fetch('https://threadwire.net/api/v1/messages', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', Accept: 'application/json' },
  body: JSON.stringify({ instance_id: 'YOUR_INSTANCE_ID', to: 'YOUR_PHONE', text: 'Hello from Threadwire' }),
});
const { data: message } = await response.json();

    import requests

response = requests.post(
    'https://threadwire.net/api/v1/messages',
    headers={'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json'},
    json={'instance_id': 'YOUR_INSTANCE_ID', 'to': 'YOUR_PHONE', 'text': 'Hello from Threadwire'},
)
message = response.json()['data']

    يأتي الرد فورًا، والرسالة في الطابور:

    {"data": {"id": "01K…", "status": "queued", "phone": "201012345678", "body": "Hello from Threadwire"}}

    ذلك الهاتف كتب أولًا، فهذه رسالة رد، وتصل خلال ثوانٍ. لديك هاتف واحد فقط؟ أرسل إلى رقم الرقم نفسه بدلًا من ذلك.

  5. استقبل الرد

    افتح للمطورين ← الويب هوك (للمسؤولين فقط) وضع عنوان نقطة النهاية الخاصة بك. ثم رُدّ من الهاتف الثاني. يستقبل عنوانك الرد بصيغة JSON:

    {"id": "evt_01K…", "type": "message.received", "created_at": "2026-10-01T10:00:00+00:00",
 "data": {"id": "01K…", "instance_id": "01K…", "phone": "201012345678", "body": "Hi!"}}

    رُدّ بأي 2xx. لا عنوان عامًا بعد؟ اجلب الأحداث نفسها بـ GET /v1/events.

قبل أن تبدأ فعليًا

التالي