Threadwire by TriTech

→ مرجع الـ API

كيف يحمي الإرسال رقمك

يحظر واتساب الأرقام التي تتصرف كالروبوتات. لذلك تُرسل كل رسالة كما يرسلها الإنسان، وبعض الرسائل تنتظر أو تُرفض. الرسالة المرفوضة حالتها failed، وتذكر السبب في error بكلمات بسيطة، مع error_code ثابت يعتمد عليه نظامك. ويعرض GET /v1/instances/{id} وضع الرقم اليوم ضمن protection.

باختصار

  • الردود أولًا. الرسالة إلى من راسل الرقم خلال آخر 24 ساعة تُرسل خلال ثوانٍ، بعد ظهور «مقروءة» و«يكتب…». ولا تؤجَّل الردود أبدًا بسبب حدود الأشخاص الجدد أو الإحماء أو ساعات الهدوء. لكنها تحافظ على إيقاعها (بفاصل ثوانٍ قليلة، وضمن 20 رسالة في الدقيقة للرقم) وعلى الحد الخاص بكل شخص. وتُحتسب من باقتك، وتُرفض بعد أن يكتب الشخص «STOP» حتى يكتب من جديد.
  • من لم يراسلوا الرقم من قبل لهم حدود. الرسائل إليهم تُرسل متباعدة، ولها حد يومي، ولا تُرسل ليلًا.
  • لذلك دع الناس يكتبون أولًا. لكل رقم chat_link في GET /v1/instances/{id}: رابط wa.me يفتح محادثة معه (أضف ?text= لتحية مكتوبة مسبقًا). ضعه على موقعك وإيصالاتك ولافتاتك. ولوحة التحكم تنشئ الرابط ورمز QR الخاص به أيضًا («رابط المحادثة» في صفحة «الأرقام»). ورسائلك لمن يكتب أولًا تُعد ردودًا: تُرسل خلال ثوانٍ، وهي الأكثر أمانًا لرقمك.

القواعد

  • الأشخاص الجدد. من لم يراسل الرقم من قبل يُراسَل بفاصل من 30 إلى 60 ثانية، مع استراحة بعد كل 10 رسائل. ولا يُراسَل بين 22:00 و08:00 (أو ساعات الهدوء التي تحددها) بالتوقيت المحلي للرقم. وهو توقيت بلد هاتفه، أو توقيت رمز منطقته في الولايات المتحدة وكندا والبرازيل والمكسيك، ويظهر في protection.timezone (راسلنا إن كان غير صحيح). ويوم الرقم، في كل حد يومي، يبدأ عند منتصف الليل بهذا التوقيت أيضًا. الرقم المربوط حديثًا يمكنه مراسلة 10 أشخاص جدد يوميًا، ويرتفع العدد إلى 50 خلال أول أسبوعين. والشخص في بلد آخر يُحسب باثنين. ومن راسل الرقم خلال آخر 90 يومًا لا يُحسب من الأشخاص الجدد لذلك اليوم، حتى بعد حذف رسائله. وتبقى كل قاعدة أخرى تخص الشخص الجديد سارية عليه.
  • الإحماء. في أول أسبوعين بعد الربط، يمكن للرقم إرسال 50 رسالة يوميًا ليست ردودًا. وهي الرسائل إلى من راسلوه قبل أكثر من يوم، وإلى من لم يراسلوه من قبل، وإلى المجموعات والقنوات. ويصبح الحد 100 من اليوم 4 و200 من اليوم 8، ولا حد من اليوم 15. أما الردود فتُرسل دائمًا ولا تُحتسب أبدًا. وتعرض لوحة التحكم الإحماء في صفحة الرقم يومًا بيوم، مع ما عليك فعله لكسب ثقة واتساب. وبعد تجاوز الحد تفشل الرسالة مع ذكر السبب. ويعرض protection.not_replies_today وprotection.not_replies_limit وضع الرقم (الحد null بعد انتهاء الإحماء، إلا إذا حددت not_replies_per_day بنفسك).
  • الحد يتكيّف. يُخفَّض إلى النصف عندما يحذّر واتساب الرقم، أو عندما يرد قليل ممن راسلهم أولًا. وتتوقف المحادثات الجديدة مؤقتًا عندما يقيّد واتساب الرقم، أو عندما يقترب من حصة واتساب من المحادثات الجديدة أو يبلغها. وتتوقف أيضًا لمدة ساعة بعد أن يرفض واتساب محادثة جديدة، وعندما لا يرد أحد تقريبًا. أما الردود فلا تتوقف أبدًا.
  • عندما يرفض واتساب. ما دام واتساب يقيّد الرقم، وخلال فترة التوقف بعد رفضه إحدى رسائله (ساعة على الأقل)، ينتظر كل شيء ما عدا الردود. ويشمل ذلك الرسائل إلى من راسلوك قبل أكثر من يوم، والمتابعات، والمجموعات والقنوات، وكذلك المحادثات الجديدة. تنتظر كل رسالة حتى ينتهي ذلك إن كان سينتهي خلال 6 ساعات، وإلا فشلت مع ذكر السبب. أما الردود على من راسلوك خلال آخر يوم فتُرسل كالمعتاد.
  • بالترتيب. الرسائل من رقم واحد إلى شخص واحد تُرسل بالترتيب الذي أرسلتها به. لذلك إذا جاء رد بعد رسالة ما زالت تنتظر دورها، انتظر معها.
  • لا إغراق لشخص واحد. بحد أقصى 4 رسائل في الساعة إلى شخص لم يرد (و10 أثناء محادثته معك)، والرسالة التالية تنتظر.
  • انتظر رد الشخص الجديد. من لم يراسلك من قبل يتلقى 3 رسائل يوميًا كحد أقصى: الأولى ورسالتان بعدها (نص وملفه، ثم تذكير واحد). وأي رسالة أخرى في ذلك اليوم تفشل مع ذكر السبب. وإن لم يرد بعد ذلك، لا يبدأ أيٌّ من أرقامك بمراسلته مجددًا إلا بعد 7 أيام من آخر رسالة أرسلها أيٌّ منها. وتُحتسب في ذلك الرسائل التي كتبها فريقك على الهاتف. والرسالة الأولى قبل هذا الموعد تفشل مع ذكر التاريخ الذي يمكن إرسالها فيه. وحين يرد على أيٍّ من أرقامك، لا ينطبق شيء من هذا.
  • طلبات التوقف. من كانت رسالته كلها «STOP» لا يصله شيء آخر من أيٍّ من أرقامك حتى يكتب من جديد. ومثلها «unsubscribe» و«end» و«quit» و«remove me» و«do not message me» و«إلغاء الاشتراك» و«توقف» و«وقف» و«وقف الرسائل» و«لا تراسلني» و«مش عايز رسايل». ولا تُحتسب كتابةً من جديد رسالة يرسلها خلال عشر دقائق من طلبه. ولا تُحتسب كذلك رسالة قصيرة ما زالت تطلب التوقف («I said stop!»)، ولا تعديل رسالة قديمة. وحين يكتب من جديد يمكنك الرد عليه ومراسلته كما كان. والسؤال الذي يستخدم كلمة كهذه فقط («When does the offer end?») ليس طلب توقف جديدًا. ويبقى خارج الرسائل الجماعية حتى يرسل إلى أيٍّ من أرقامك رسالة كلها «START» (أو «subscribe» أو «اشترك» أو «ابدأ»).
  • الرسائل الأولى: نص أو ملف، لا موقع ولا بطاقة جهة اتصال ولا ملصق ولا استطلاع. ولا روابط http://، ولا رابط وحده، وبحد أقصى 600 حرف. النص نفسه، أو الملف نفسه بالتعليق نفسه (أو بلا تعليق)، يفتح محادثة مع 5 أشخاص جدد يوميًا كحد أقصى عبر أرقامك. لذلك اجعل كل رسالة شخصية (الاسم، أو الحجز، أو الطلب). قل من أنت ولماذا تراسله.

عداد الأمان

يعطي protection.safety الرقم درجة تبدأ من 100 وتنقص، وتُحدَّث كل ساعة. وlevel يكون good أو attention أو caution. وتذكر reasons ما يخفض الدرجة، ولكل سبب weight (النقاط التي يخصمها). والأسباب هي: عمر الرقم، وكيف ردّ من راسلهم أولًا، وتحذيرات واتساب ورفضه، والإرسال إلى أرقام ليست على واتساب، ومن طلبوا منه التوقف. ومنها أيضًا نسبة ما يرسله إلى من لم يراسلوه من قبل، وما استخدمه اليوم من حدوده، وملفه الشخصي. وadvice هي الخطوة التالية الأجدر بالتنفيذ. العداد يحذّر فقط، أما القواعد أعلاه فهي التي تؤجّل الرسائل أو ترفضها. وعندما يهبط رقم إلى caution، يتلقى فريقك رسالة بريد إلكتروني بالأسباب.

إعداداتك الخاصة

يمكنك تشديد حماية كل رقم، أو تعديلها في حدود آمنة، لكن لا يمكن إيقافها أبدًا. استخدم PATCH /v1/instances/{id} مع protection_settings، أو «إعدادات الحماية» في صفحة الرقم في لوحة التحكم. أرسل ما يتغير فقط، وnull يعيد الإعداد إلى القيمة الموصى بها.

  • حرّك ساعات الهدوء وأطِلها (6 ساعات على الأقل، وتشمل دائمًا من 00:00 إلى 05:00).
  • اخفض حد الأشخاص الجدد يوميًا (2 على الأقل، لأن الشخص في الخارج يُحسب باثنين)، وحد الرسائل التي ليست ردودًا يوميًا.
  • أطِل الفاصل بين الرسائل الأولى (من 30 إلى 60 ثانية في أسرع حال، وحتى 600) وأطِل الاستراحة بعد كل 10.
  • اسمح بمتابعات أقل لمن لم يرد (من 0 إلى 2)، وانتظر مدة أطول قبل البدء بمراسلته مرة أخرى (reopen_after_days، من 7 إلى 30 يومًا).
  • اترك المحادثات غير مقروءة عند الرد (mark_read_before_reply).
  • سجّل الهاتف رقمًا established له تاريخ طويل على واتساب، ليبدأ إحماؤه من اليوم 8 بدل اليوم 1 (ولا يُتخطى أبدًا: واتساب يراقب كل جهاز مربوط حديثًا).

المفاتيح:

المفتاح ما هو المسموح
quiet_hours لا رسائل أولى إلى أشخاص جدد في هذه الساعات، بتوقيت الرقم: {"from": 22, "to": 8}، بساعات كاملة 6 ساعات على الأقل، وتشمل من 00:00 إلى 05:00
new_people_per_day الحد الأقصى للأشخاص الجدد يوميًا. وقد يسمح الإحماء وتحذيرات واتساب ومعدل الردود بأقل منه من 2 إلى 50
first_contact_gap الثواني بين الرسائل الأولى: {"min": 30, "max": 60} أطول فقط، وحتى 600
break_minutes الاستراحة بعد كل 10 رسائل أولى: {"min": 5, "max": 10} أطول فقط، وحتى 60
unanswered_follow_ups الرسائل اليومية بعد الأولى إلى من لم يرد من 0 إلى 2
reopen_after_days الأيام قبل البدء بمراسلة من لم يرد مرة أخرى من 7 إلى 30
not_replies_per_day الحد الأقصى اليومي للرسائل التي ليست ردودًا (حد الإحماء نفسه يبقى ساريًا على الرقم الجديد) أقل فقط
warmup_mode new، أو established لهاتف له تاريخ طويل على واتساب
mark_read_before_reply هل تُعلَّم المحادثة كمقروءة قبل الرد true أو false
automatic_warmup الإحماء التلقائي مع أرقامك الأخرى (أدناه) true أو false

القيمة التي تتجاوز حدًّا آمنًا تُرفض (422، مع ذكر السبب) ولا يُحفظ شيء. ويعرض protection.settings القيم السارية، ويسرد customised ما غيّرته منها. والرسالة التي تُرفض بسبب إعدادك أنت تذكر ذلك («Your setting for this instance allows…»). أما «يكتب…»، والحد الخاص بكل شخص، واحتساب جهات الاتصال في الخارج مرتين، وقواعد الرسالة الأولى، وطلبات التوقف، والمجموعات، وتحذيرات واتساب فهي واحدة لكل الأرقام.

الإحماء التلقائي (اختياري، من إعدادات الحماية للرقم، أو automatic_warmup في protection_settings): في أول أسبوعين، يتبادل رقمان أو أكثر من أرقامك رسائل من حين لآخر. بذلك يبني كل رقم سجلًا من الاستخدام العادي. ولا يعمل إلا بين أرقامك أنت، وكل رقم على عنوان خاص به في بلده. أرقام العملاء الذين يدفعون تحصل على عنوان؛ وفي التجربة المجانية تشارك عنواننا، فيبدأ مع أول دفعة منك. وهذه المحادثات رسائل حقيقية (والرسالة الافتتاحية تُحسب من جهات الاتصال الجديدة لذلك اليوم). لكنها لا تظهر في GET /v1/messages ولا GET /v1/chats، ولا تُرسل إلى الويب هوك لديك. ولا ترد عليها ردودك التلقائية أبدًا، ولا تُحتسب من باقتك أبدًا.