ArgorantDocs

ربط أي صندوق بريد (SMTP وIMAP)

اربط صناديق البريد من Zoho وFastmail وYahoo وiCloud وIONOS ومزوّد الاستضافة لديك أو أي مزوّد آخر بإعدادات الخادم الخاصة بها. اختبر تسجيل الدخول أولًا، ثم اربطها واحدًا تلو الآخر أو عدة صناديق من ملف CSV.

تتصل صناديق بريد Google وMicrosoft بتسجيل الدخول الخاص بها (راجع ربط Google Workspace، وMicrosoft 365 في التطبيق ضمن صناديق البريد). أما كل مزوّد آخر فيتصل بمجموعتين من إعدادات الخادم. يتيح خادم الإرسال (SMTP) للحملات أن ترسل من صندوق البريد. ويجلب خادم قراءة الردود (IMAP) الردود إلى صندوق الوارد لديك في Argorant، فيوقف الرد التسلسل لذلك الشخص.

يسجّل Argorant الدخول إلى الخادمين كليهما قبل أن يحفظ أي شيء. لا يتصل صندوق البريد إلا عندما يعمل الإرسال وقراءة الردود معًا. تُخزَّن كلمة المرور مشفّرة ولا تُعرض مرة أخرى أبدًا، لا في التطبيق ولا في API ولا في CLI ولا في الموصِّل.

في التطبيق

افتح صناديق البريد، وانقر Add accounts، ثم ربط الموجود وأي مزوّد آخر.

  1. اختر مزوّدك من القائمة. يملأ ذلك أسماء الخوادم والمنافذ والأمان نيابة عنك. اختر مزوّد آخر عندما لا يكون مزوّدك مدرجًا، وانسخ الإعدادات من صفحات المساعدة لدى مزوّدك.
  2. أدخل عنوان البريد الإلكتروني، واسم المرسِل الذي يراه الناس، وكلمة المرور.
  3. انقر اختبار الاتصال. سترى سطرًا للإرسال وسطرًا لقراءة الردود، ولكل منهما ما نجح أو ما يجب إصلاحه.
  4. انقر ربط صندوق البريد. يظهر في القائمة فورًا مع حده اليومي وحالته.

لربط كثير من صناديق البريد دفعة واحدة، انتقل إلى عدة صناديق من ملف CSV، وارفع الملف وتحقق من النتيجة لكل صف.

كلمات مرور التطبيقات

كثير من المزوّدين لا يقبلون كلمة مرورك العادية من التطبيقات الأخرى عندما يكون تسجيل الدخول بخطوتين مفعّلًا. أنشئ كلمة مرور للتطبيق لدى المزوّد واستخدمها بدلًا منها.

المزوّدأين تنشئ كلمة مرور للتطبيق
Zoho Mailمن My Account، ثم Security، ثم App Passwords. فعّل أيضًا وصول IMAP في إعدادات Zoho Mail.
Fastmailمن Settings، ثم Privacy and Security، ثم Manage app passwords. مطلوبة دائمًا.
Yahoo Mailمن Account Info، ثم Account Security، ثم Generate app password. مطلوبة دائمًا.
iCloud Mailمن account.apple.com، ثم Sign-In and Security، ثم App-Specific Passwords. مطلوبة دائمًا. اسم المستخدم هو عنوان iCloud الكامل الخاص بك.
Outlook.com وHotmailكثيرًا ما ترفض Microsoft كلمات المرور القادمة من التطبيقات الأخرى لهذه الحسابات. جرّب كلمة مرور للتطبيق، وإذا قال الاختبار إن كلمة المرور خاطئة، فاربط باستخدام تسجيل دخول Microsoft بدلًا من ذلك.

إعدادات المزوّدين

اختر مزوّدًا فتُملأ هذه الإعدادات. القائمة في التطبيق وفي GET /api/v1/inboxes/smtp/presets هي دائمًا الأحدث.

الإعداد المسبقالمزوّدخادم الإرسالخادم قراءة الردود
zohoZoho Mail (نطاق أعمال)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail (مركز بيانات الاتحاد الأوروبي)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail (خطة شخصية أو مجانية)smtp.zoho.com, 587, STARTTLSimap.zoho.com, 993, SSL
fastmailFastmailsmtp.fastmail.com, 587, STARTTLSimap.fastmail.com, 993, SSL
godaddyGoDaddy Professional Emailsmtpout.secureserver.net, 587, STARTTLSimap.secureserver.net, 993, SSL
titanTitan Emailsmtp.titan.email, 587, STARTTLSimap.titan.email, 993, SSL
hostingerHostinger Emailsmtp.hostinger.com, 587, STARTTLSimap.hostinger.com, 993, SSL
ionosIONOS (الولايات المتحدة)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS (ألمانيا)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS (المملكة المتحدة)smtp.ionos.co.uk, 587, STARTTLSimap.ionos.co.uk, 993, SSL
namecheapNamecheap Private Emailmail.privateemail.com, 587, STARTTLSmail.privateemail.com, 993, SSL
yahooYahoo Mailsmtp.mail.yahoo.com, 587, STARTTLSimap.mail.yahoo.com, 993, SSL
icloudiCloud Mailsmtp.mail.me.com, 587, STARTTLSimap.mail.me.com, 993, SSL
outlookOutlook.com أو Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
otherمزوّد آخرتدخله بنفسكتدخله بنفسك

استخدم المنفذ 587 للإرسال. إذا أدخلت 465، يجرّب Argorant المنفذ 587 نيابة عنك ويحفظ 587 عندما يعمل، وعندها تُظهر نتيجة الاختبار المنفذ 587 وSTARTTLS للإرسال. اسم المستخدم للخادمين هو عنوان البريد الإلكتروني ما لم تعيّن اسمًا آخر. تستخدم قراءة الردود اسم المستخدم وكلمة المرور نفسيهما المستخدمين في الإرسال ما لم تعيّن غيرهما. ومن دون إعداد مسبق، يتبع الأمان المنفذ، أي STARTTLS على 587 و143، وSSL على 993.

معنى نتيجة الاختبار

النتيجةما تعنيهما تفعله
signed_inقبل الخادم تسجيل الدخول.لا شيء.
wrong_passwordرفض الخادم اسم المستخدم أو كلمة المرور.تحقق من كليهما. استخدم كلمة مرور للتطبيق إذا طلبها المزوّد، وتأكد من أن وصول IMAP مفعّل لدى المزوّد.
not_reachableلم يُجب الخادم، أو لا يوجد خادم بهذا الاسم.تحقق من اسم الخادم والمنفذ.
security_mismatchلم ينجح الاتصال الآمن.جرّب إعداد الأمان الآخر. للإرسال، استخدم المنفذ 587 مع STARTTLS.
not_allowedيشير اسم الخادم إلى شبكة خاصة.استخدم اسم الخادم العام لدى مزوّدك.
failedحدث خطأ آخر.تحقق من الإعدادات وحاول مرة أخرى، أو تواصل مع الدعم.

عدة صناديق بريد من ملف CSV

صف واحد لكل صندوق بريد. يحتاج كل صف إلى email وsmtp_password (أو password)، وإما preset أو smtp_host وsmtp_port وimap_host. تأخذ الأعمدة الفارغة القيم الافتراضية الواردة أعلاه، و25 رسالة يوميًا.

العمودمثال
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com، كلمة مرور التطبيق الخاصة بك
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_passwordفقط عندما تختلف عن بيانات الإرسال
daily_limit30
CSV
email,sender_name,preset,smtp_password
anna@yourcompany.com,Anna Weber,zoho,app-password-1
ben@yourcompany.com,Ben Hill,zoho,app-password-2
cara@othercompany.com,Cara Lane,,app-password-3

الصف الثالث ليس له إعداد مسبق، لذا يحتاج أيضًا إلى ملء smtp_host وsmtp_port وimap_host، وإلا يعود كصف يحتاج إلى إصلاح. يحصل كل صف على نتيجته الخاصة. تبقى الصفوف التي اتصلت متصلة عندما تفشل صفوف أخرى، لذا أصلح الصفوف الفاشلة وارفعها وحدها مرة أخرى.

إعادة الربط بعد تغيير كلمة المرور

عندما يرفض المزوّد كلمة المرور، يُظهر صندوق البريد Sign in again في قائمة صناديق البريد. وإذا رُفضت قراءة الردود ثلاث مرات متتالية، يُعلَّم صندوق البريد بأنه غير متصل ويبقى كذلك حتى تعيد ربطه.

لإعادة الربط، اربط العنوان نفسه مرة أخرى بكلمة المرور الجديدة. في التطبيق، انقر إعادة الربط على صندوق البريد، وأدخل كلمة المرور الجديدة واربطه، وتبقى الإعدادات الأخرى كما هي. ومع API أو CLI أو مساعد الذكاء الاصطناعي لديك، اربط العنوان نفسه مرة أخرى، فيستبدل ذلك الإعدادات وكلمة المرور المحفوظة لهذا الصندوق.

من API

Shell
# Test first: nothing is saved
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/test" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password"}'

# Connect one mailbox
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","display_name":"Anna Weber","preset":"zoho","smtp_password":"app-password"}'

# Connect up to 25 at once
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/bulk" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"mailboxes":[{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password-1"},{"email":"ben@yourcompany.com","preset":"zoho","smtp_password":"app-password-2"}]}'

عند رفض تسجيل الدخول أثناء الربط، تكون الإجابة 422 مع الرمز sign_in_failed ونتيجة الاختبار في error.details.test. ويجيب مسار الربط الجماعي بـ 200 مع نتيجة لكل صف. تتيح الفترة التجريبية المجانية ربط ما يصل إلى صندوقي بريد. يمكنك الاختبار 30 مرة والربط 30 مرة في الساعة، وربط ما يصل إلى 500 صندوق بريد في الساعة عبر مسار الربط الجماعي.

من الطرفية

Shell
argorant inboxes presets
argorant inboxes test-smtp --email anna@yourcompany.com --preset zoho
argorant inboxes connect-smtp --email anna@yourcompany.com --preset zoho --name "Anna Weber"
argorant inboxes connect-smtp --csv mailboxes.csv

لا تأخذ CLI كلمة المرور أبدًا من سطر الأوامر. فهي تطلبها منك، أو تقرؤها من متغير بيئة تحدد اسمه بـ --password-env NAME، أو من ARGORANT_MAILBOX_PASSWORD. راجع CLI.

من مساعد الذكاء الاصطناعي لديك

مع موصِّل Argorant، اطلب بكلمات بسيطة، مثلًا «اربط anna@yourcompany.com، إنه صندوق بريد Zoho». يستخدم المساعد argorant_test_smtp_mailbox للتحقق من تسجيل الدخول، وargorant_connect_smtp_mailbox لربط صندوق بريد واحد أو حتى 25. راجع الأدوات.

بعد الربط

يرسل صندوق البريد مثل أي صندوق آخر. عيّن حده اليومي والإحماء ضمن صناديق البريد أو باستخدام PATCH /api/v1/inboxes/{email}، واختره مرسِلًا في أي حملة. تخرج رسائل المتابعة في السلسلة نفسها، وتصل الردود إلى صندوق الوارد لديك في Argorant، وتجيب عليها من هناك في السلسلة نفسها. تُقرأ أيضًا الردود التي تصل إلى مجلد البريد غير المرغوب فيه أو الرسائل المزعجة، لكن فقط من الأشخاص الذين راسلتهم، لذا تُتجاهل الرسائل المزعجة.

في هذه الصفحة