التحقق بالجملة

ارفعوا ملف CSV يضم عناوين البريد الإلكتروني واحصلوا على النتائج لقائمتكم بالكامل.

نظرة عامة

يتيح لكم التحقق بالجملة التحقق من آلاف عناوين البريد الإلكتروني في مهمة واحدة. ارفعوا ملف CSV عبر لوحة التحكم أو API، ونزّلوا النتائج عند اكتمال المهمة.

ℹ️

التحقق بالجملة متاح عبر لوحة التحكم وAPI. ارفعوا ملفات CSV باستخدام POST /api/bulk، واستعلموا عن GET /api/bulk/{job_id}، ثم نزّلوا النتائج من /api/bulk/{job_id}/download.

الرفع عبر API

أرسلوا رفع CSV بصيغة multipart مع مفتاح API الخاص بكم. ويمكنكم اختياريًا تمرير email_column عندما لا يكون اسم حقل البريد الإلكتروني email.

bash

curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

الرفع عبر لوحة التحكم

سجّلوا الدخول إلى verimails.com/dashboard
انقروا على التحقق بالجملة في الشريط الجانبي
ارفعوا ملف CSV الخاص بكم
انتظروا اكتمال المهمة (تظهر في قائمة المهام لديكم)
نزّلوا ملف CSV الخاص بالنتائج

تنسيق CSV

يجب أن يحتوي ملف CSV على عمود لعناوين البريد الإلكتروني. تكتشف VeriMails تلقائيًا الترويسات الشائعة مثل email, Email Address, work_email، و business_email. كما تُدعم ملفات CSV ذات العمود الواحد دون ترويسة، لكن وجود ترويسة واضحة للبريد الإلكتروني يظل الأفضل:

csv

email
john@example.com
jane@company.com
info@business.io
sales@corp.net

تُحفظ الأعمدة الإضافية في المخرجات ولن تؤثر على المعالجة.

التنسيقات المدعومة

ملفات CSV بفواصل من نوع الفاصلة أو الفاصلة المنقوطة
ترميز UTF-8
حتى 500,000 صف لكل مهمة
الحد الأقصى لحجم الملف: 50MB

تنسيق المخرجات

يحافظ ملف النتائج الكامل على أعمدة CSV الأصلية ويُلحق عمودًا واضحًا لقابلية الإرسال:

العمود المُضاف	الوصف
`Safe to Send`	`Yes` عندما تكون الحالة المُتحقق منها صالحة؛ `No` للنتائج غير الصالحة أو catch-all أو المؤقتة أو غير المعروفة أو المحفوفة بالمخاطر.

التحقق من حالة المهمة

في لوحة التحكم، تعرض قائمة المهام التقدم في الوقت الفعلي. وعبر API، استعلموا عن GET /api/bulk/{job_id} حتى تصبح حالة المهمة completed أو failed.

إشعارات webhook

دعم webhook لاكتمال مهام الجملة قادم قريبًا. راجعوا Webhooks ←

💡

نصيحة: لبناء القوائم في الوقت الفعلي، استخدموا API التحقق الفردي للتحقق من العناوين أثناء جمعها. أما التحقق بالجملة فهو الأنسب لتنظيف القوائم الحالية.