التحقق من الأرقام

الاستعلام

يستهلك جلسة القناة الحيّة، ولذلك فهو محدود بـ 60 طلبًا في الدقيقة لكل مساحة عمل وليس مما يُستدعى مع كل ضغطة مفتاح. وحذف channel_id يترك للواجهة اختيار قناة مؤهلة.

يتطلب contacts.read وmessages.send معًا — وهو أحد عمليتين فقط في الواجهة كلها تسمّيان نطاقين، لأن الاستعلام يستهلك قناة إرسال. انظر المصادقة.

الأجوبة الثلاثة

curl -X POST https://whats.azzamkh.sa/api/v1/contacts/validate \
  -H "Authorization: Bearer $WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "numbers": ["+9665XXXXXXXX", "+9665YYYYYYYY"], "channel_id": "ch_..." }'

# 200 OK
# {
#   "channel_id": "ch_...",
#   "results": [
#     { "e164": "+9665XXXXXXXX", "status": "exists" },
#     { "e164": "+9665YYYYYYYY", "status": "unknown",
#       "reason": "no_answer" }
#   ],
#   "summary": { "checked": 2, "exists": 1, "not_exists": 0, "unknown": 1 }
# }

# A refused LOOKUP is not an answer about the number:
# 409 { "error": { "code": "CHANNEL_NOT_CONNECTED", ... } }

يعدّ summary القيم checked وexists وnot_exists وunknown. والأربع منفصلة، ومجموع الثلاث الأخيرة يساوي checked.

ما لا يخبرك به

• الفحص قدرة على القناة: check_number. وهو صحيح على QR والمهايئات المحاكاة وخاطئ على Meta. وغيابه يعني ألا تعرض الفحص، لا أن الفحص سيفشل — انظر القنوات.
• الوجود ليس موافقة. فالرقم الموجود الذي ليست حالته opted_in تُرفض له الرسالة التسويقية.
• الجواب صحيح في لحظة السؤال. ولا شيء منه مخزَّن نيابةً عنك، ولا شيء منه وعد بالتسليم.
• الاستعلام المرفوض ليس جوابًا عن الرقم أبدًا. فـCHANNEL_NOT_CONNECTED وRATE_LIMITED وFEATURE_TEMPORARILY_UNAVAILABLE كلها تعني أن الفحص تعذّر، ولا مكان لأيٍّ منها في صندوق الكتابة كخطأ أحمر على المستلم.
• 60 طلبًا في الدقيقة لكل مساحة عمل، مهما كان حجم الدفعة.

فحص الحملة

تجري الحملة الاستعلام نفسه على عيّنة محدودة من جمهورها المُحلّ، كجزء اختياري من فحص ما قبل الإطلاق. أرسل validate_numbers: true — فهو لا يُفهم ضمنًا من validate أبدًا، تحديدًا لأنه يستهلك جلسة القناة الحيّة. انظر الحملات.

الأخطاء المهمة هنا

كل رمز وحالته في صفحة الأخطاء.