ربط أي صندوق بريد (SMTP وIMAP)
اربط صناديق البريد من Zoho وFastmail وYahoo وiCloud وIONOS ومزوّد الاستضافة لديك أو أي مزوّد آخر بإعدادات الخادم الخاصة بها. اختبر تسجيل الدخول أولًا، ثم اربطها واحدًا تلو الآخر أو عدة صناديق من ملف CSV.
تتصل صناديق بريد Google وMicrosoft بتسجيل الدخول الخاص بها (راجع ربط Google Workspace، وMicrosoft 365 في التطبيق ضمن صناديق البريد). أما كل مزوّد آخر فيتصل بمجموعتين من إعدادات الخادم. يتيح خادم الإرسال (SMTP) للحملات أن ترسل من صندوق البريد. ويجلب خادم قراءة الردود (IMAP) الردود إلى صندوق الوارد لديك في Argorant، فيوقف الرد التسلسل لذلك الشخص.
يسجّل Argorant الدخول إلى الخادمين كليهما قبل أن يحفظ أي شيء. لا يتصل صندوق البريد إلا عندما يعمل الإرسال وقراءة الردود معًا. تُخزَّن كلمة المرور مشفّرة ولا تُعرض مرة أخرى أبدًا، لا في التطبيق ولا في API ولا في CLI ولا في الموصِّل.
في التطبيق
افتح صناديق البريد، وانقر Add accounts، ثم ربط الموجود وأي مزوّد آخر.
- اختر مزوّدك من القائمة. يملأ ذلك أسماء الخوادم والمنافذ والأمان نيابة عنك. اختر مزوّد آخر عندما لا يكون مزوّدك مدرجًا، وانسخ الإعدادات من صفحات المساعدة لدى مزوّدك.
- أدخل عنوان البريد الإلكتروني، واسم المرسِل الذي يراه الناس، وكلمة المرور.
- انقر اختبار الاتصال. سترى سطرًا للإرسال وسطرًا لقراءة الردود، ولكل منهما ما نجح أو ما يجب إصلاحه.
- انقر ربط صندوق البريد. يظهر في القائمة فورًا مع حده اليومي وحالته.
لربط كثير من صناديق البريد دفعة واحدة، انتقل إلى عدة صناديق من ملف 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 هي دائمًا الأحدث.
| الإعداد المسبق | المزوّد | خادم الإرسال | خادم قراءة الردود |
|---|---|---|---|
zoho | Zoho Mail (نطاق أعمال) | smtppro.zoho.com, 587, STARTTLS | imappro.zoho.com, 993, SSL |
zoho_eu | Zoho Mail (مركز بيانات الاتحاد الأوروبي) | smtppro.zoho.eu, 587, STARTTLS | imappro.zoho.eu, 993, SSL |
zoho_personal | Zoho Mail (خطة شخصية أو مجانية) | smtp.zoho.com, 587, STARTTLS | imap.zoho.com, 993, SSL |
fastmail | Fastmail | smtp.fastmail.com, 587, STARTTLS | imap.fastmail.com, 993, SSL |
godaddy | GoDaddy Professional Email | smtpout.secureserver.net, 587, STARTTLS | imap.secureserver.net, 993, SSL |
titan | Titan Email | smtp.titan.email, 587, STARTTLS | imap.titan.email, 993, SSL |
hostinger | Hostinger Email | smtp.hostinger.com, 587, STARTTLS | imap.hostinger.com, 993, SSL |
ionos | IONOS (الولايات المتحدة) | smtp.ionos.com, 587, STARTTLS | imap.ionos.com, 993, SSL |
ionos_de | IONOS (ألمانيا) | smtp.ionos.de, 587, STARTTLS | imap.ionos.de, 993, SSL |
ionos_uk | IONOS (المملكة المتحدة) | smtp.ionos.co.uk, 587, STARTTLS | imap.ionos.co.uk, 993, SSL |
namecheap | Namecheap Private Email | mail.privateemail.com, 587, STARTTLS | mail.privateemail.com, 993, SSL |
yahoo | Yahoo Mail | smtp.mail.yahoo.com, 587, STARTTLS | imap.mail.yahoo.com, 993, SSL |
icloud | iCloud Mail | smtp.mail.me.com, 587, STARTTLS | imap.mail.me.com, 993, SSL |
outlook | Outlook.com أو Hotmail | smtp-mail.outlook.com, 587, STARTTLS | outlook.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 رسالة يوميًا.
| العمود | مثال |
|---|---|
email | anna@yourcompany.com |
sender_name | Anna Weber |
preset | zoho |
smtp_host, smtp_port, smtp_security | mail.yourcompany.com, 587, starttls |
smtp_username, smtp_password | anna@yourcompany.com، كلمة مرور التطبيق الخاصة بك |
imap_host, imap_port, imap_security | mail.yourcompany.com, 993, ssl |
imap_username, imap_password | فقط عندما تختلف عن بيانات الإرسال |
daily_limit | 30 |
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
# 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 صندوق بريد في الساعة عبر مسار الربط الجماعي.
من الطرفية
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، وتجيب عليها من هناك في السلسلة نفسها. تُقرأ أيضًا الردود التي تصل إلى مجلد البريد غير المرغوب فيه أو الرسائل المزعجة، لكن فقط من الأشخاص الذين راسلتهم، لذا تُتجاهل الرسائل المزعجة.