جداول بيانات جوجل - واجهة برمجة تطبيقات ملف تعريف واتساب

تحقق من صحة عمود من أرقام الهواتف مباشرةً داخل جداول بيانات جوجل باستخدام برمجة التطبيقات. الصق الأرقام، ونفّذ أمر القائمة، واحصل على النتائج في أعمدة مجاورة.

يثبت

  1. افتح ورقة.
  2. الإضافات ← سكريبت التطبيقات.
  3. ألصق النص البرمجي أدناه.
  4. استبدل YOUR_DIRECT_KEY.
  5. احفظ الملف. أعد تحميل الصفحة. ستظهر قائمة جديدة باسم "واجهة برمجة تطبيقات واتساب".
  6. ضع أرقام الهواتف في العمود أ (مع رمز الدولة، بدون علامة +). شغّل واجهة برمجة تطبيقات واتساب ← تحقق من صحة العمود أ.

برنامج التطبيقات

// Direct proxy: use your direct-purchase key from our dashboard.
// RapidAPI marketplace: set API_BASE = "https://wp-data.p.rapidapi.com"
// AND uncomment the x-rapidapi-host header below.
const API_KEY = "YOUR_DIRECT_KEY";
const API_BASE = "https://whatsapp-proxy.checkleaked.cc";

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("WhatsApp API")
    .addItem("Validate column A", "validateColumnA")
    .addToUi();
}

function validateColumnA() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;
  const numbers = sheet.getRange(2, 1, lastRow - 1, 1).getValues();

  // Header row
  sheet.getRange(1, 2, 1, 4).setValues([["isWAContact", "about", "isBusiness", "profilePic"]]);

  for (let i = 0; i < numbers.length; i++) {
    const number = String(numbers[i][0]).replace(/[^0-9]/g, "");
    if (!number) continue;

    try {
      const res = UrlFetchApp.fetch(
        `${API_BASE}/number/no_picture/${number}`,
        {
          headers: {
            "x-rapidapi-key": API_KEY,
            // "x-rapidapi-host": "wp-data.p.rapidapi.com",  // RapidAPI only
          },
          muteHttpExceptions: true,
        }
      );
      const data = JSON.parse(res.getContentText());
      sheet.getRange(i + 2, 2, 1, 4).setValues([[
        data.isWAContact || false,
        data.about || "",
        data.isBusiness || false,
        data.profilePic || "",
      ]]);
    } catch (e) {
      sheet.getRange(i + 2, 2).setValue("ERROR");
    }

    // Respect tier burst limits — sleep 500 ms between requests (2/sec). MEGA tier: 250 ms (4/sec).
    Utilities.sleep(500);
  }
}

توجيه الصوت

  • يُحدد برنامج Google Sheets Apps Script مدة تنفيذه بست دقائق. عند معدل طلبين في الثانية (BASIC/PRO/ULTRA)، يُعالج البرنامج حوالي 700 رقم في كل تشغيل؛ بينما يُعالج الإصدار MEGA عند معدل 4 طلبات في الثانية حوالي 1400 رقم.
  • بالنسبة للقوائم التي يزيد حجمها عن 1000 رقم، اتصل بنقطة النهاية المجمعة الخاصة بنا بدلاً من ذلك - مكالمة واحدة، وتنزيل ملف CSV، ولصق النتائج مرة أخرى.
  • يحتوي تطبيق UrlFetchApp الخاص بـ Apps Script على حصة يومية منفصلة - 20000 استدعاء للحسابات المجانية، و100000 لـ Workspace. راقب كلا الجانبين.

تفعيل تعديل الصف

لإضافة سير عمل "التحقق عند اللصق"، أضف مشغلًا قابلًا للتثبيت:

function onEditValidate(e) {
  if (e.range.getColumn() !== 1 || e.range.getRow() < 2) return;
  // ... call validateSingleRow(e.range.getRow())
}

قم بالتثبيت ضمن المشغلات ← إضافة مشغل ← التحقق من صحة التحرير ← من جدول البيانات ← عند التحرير.

متعلق ب

ما يقوله مستخدمونا

تقييمات حقيقية من عملائنا الراضين

لا توجد تقييمات متاحة بعد