companyLogo

محادثات واتساب: القراءة والإرسال ولقطات الشاشة عبر API

اقرأ محادثات كل رقم واتساب مرتبط، وافتح أيًّا منها بكامل سجلها وملفاتها، وأرسل نصًا أو ملفًا، والتقط صورة للمحادثة كما يعرضها واتساب ويب. والأمر نفسه في لوحة التحكم: الأجهزة، رقم واتساب، المحادثات.

  • المحادثات الفردية فقط: لا تُدرج المجموعات وقوائم البث والحالات والقنوات.
  • مفتاح المحادثة هو أرقام رقمها دون +. وعندما يخفي واتساب رقم الشخص تُقرأ المحادثة ولا يمكن الكتابة فيها (kind: hidden_number).
  • تعود الملفات ولقطات الشاشة داخل رد JSON بصيغة base64. الملف الذي تنزّله 32 ميغابايت كحد أقصى، والذي ترسله 16 ميغابايت.
  • أرقامك أنت فقط، بمفتاح API الخاص بك؛ ويجب أن يكون الرقم مرتبطًا ومتصلًا.

تفتح لقطة الشاشة المحادثة في واتساب ويب على الرقم، فتصبح مقروءة كما لو فُتحت على الهاتف.

أرقامك ومحادثاتها

اعرض أرقام واتساب الخاصة بك، ثم محادثات رقم منها، الأحدث أولًا: الرقم دائمًا، والاسم المحفوظ على الهاتف إن وُجد، واسم الشخص على واتساب، والرسائل غير المقروءة وآخر رسالة.

GET /v1/echo/whatsapp/devices
GET /v1/echo/whatsapp/devices/{id}/chats?limit=200

رسائل المحادثة

أحدث الرسائل حتى limit (بحد أقصى 5000)، من الأقدم إلى الأحدث: من أرسل كل رسالة (sender: me أو peer)، ونوعها، ونصها أو تعليقها، والوقت، وعلامات الاستلام لرسائلك، وللملف نوعه واسمه وحجمه ومعاينة صغيرة. complete: true تعني المحادثة كاملة كما هي في واتساب.

GET /v1/echo/whatsapp/devices/{id}/chats/{id}/messages?limit=100

ملف الرسالة

اطلب الملف بمعرّف رسالته. قد لا يحتفظ واتساب بالملفات القديمة (410 media_unavailable).

GET /v1/echo/whatsapp/devices/{id}/chats/{id}/media

صورة الملف الشخصي لمحادثة

صورة الملف الشخصي للشخص على واتساب كما يُظهرها واتساب لهذا الرقم: JPEG أو PNG أو WebP، بترميز base64، بحد أقصى 300 كيلوبايت. تكون picture فارغة (null) إن لم توجد صورة أو أخفاها الشخص عن هذا الرقم. تُحفظ 6 ساعات. 240 في الدقيقة.

GET /v1/echo/whatsapp/devices/{id}/chats/{id}/picture

إرسال نص أو ملف

من هذا الرقم إلى هذه المحادثة بالطريقة المعتادة: تُوضع الرسالة في الطابور وتستهلك وحدات واتساب وتلتزم بالحدود اليومية؛ أرسل Idempotency-Key. يُرسل الملف بنوعه واسمه بصيغة base64، ويصبح النص تعليقًا عليه. للكتابة إلى رقم جديد استخدم هذا المسار بأرقام ذلك الرقم، أو POST /v1/echo/messages كالمعتاد.

يُرسل الملف عبر زر الإرفاق في واتساب ويب نفسه، كما يرسله الشخص: تُفتح المحادثة على واتساب ويب الخاص بالرقم (فيعلّمها واتساب كمقروءة)، ويُرسل الملف وتعليقه، وتتبعه العلامات كالمعتاد. إن لم يُظهر واتساب ويب أنه أُرسل، تفشل الرسالة بـ send_unconfirmed ولا تُرسل مرة أخرى تلقائيًا.

POST /v1/echo/whatsapp/devices/{id}/chats/{id}/messages

لقطة شاشة للمحادثة

الوضع chat: نافذة المحادثة عند أحدث رسائلها؛ الوضع screen: نافذة واتساب ويب كاملة بمقاس 1600 × 1000. صورة PNG بصيغة base64. ست لقطات في الدقيقة.

message_id (اختياري، معرّف من قائمة الرسائل): تُظهر الصورة تلك الرسالة. إذا كانت من آخر 4 رسائل في المحادثة تبقى النافذة عند أحدث الرسائل كما بدونه (at_message: bottom)؛ والرسالة الأقدم تُحمَّل وتوضع في منتصف النافذة (at_message: scrolled). الرسالة التي لا يستطيع واتساب ويب عرضها تُجاب بـ 404 message_not_found.

POST /v1/echo/whatsapp/devices/{id}/chats/{id}/screenshot

فتح محادثة في واتساب

يفتح المحادثة على واتساب ويب الخاص بالرقم، كما يفعل فتحها على الهاتف: يحمّل واتساب المحادثة كاملة ويعلّمها كمقروءة (يرى الشخص العلامتين الزرقاوين). قراءة الرسائل عبر هذه الواجهة لا تعلّم شيئًا كمقروء؛ أما هذا فيفعل. 12 في الدقيقة.

POST /v1/echo/whatsapp/devices/{id}/chats/{id}/open

المتاح اليوم في المحادثة

كم رسالة أخرى يمكن لهذا الرقم إرسالها إلى هذا الشخص اليوم. كل رد من الشخص في اليوم نفسه يضيف 2 إلى حد تلك المحادثة: مع 5 في اليوم، رسالة واحدة تُبقي 4، ثم رد يجعلها 6.

GET /v1/echo/whatsapp/devices/{id}/chats/{id}/room

التوثيق

إيكو من ibotek