Примеры интеграции SMTP

В этом руководстве приводятся подробные примеры того, как интегрироваться с SMTP-сервисом Forward Email с использованием различных языков программирования, фреймворков и почтовых клиентов. Наш SMTP-сервис разработан так, чтобы быть надежным, безопасным и легко интегрироваться с вашими существующими приложениями.

Прежде чем углубляться в примеры интеграции, важно понять, как наша служба SMTP обрабатывает электронные письма:

Система очереди и повторных попыток электронной почты

Когда вы отправляете электронное письмо через SMTP на наши серверы:

  1. Первичная обработка: Электронная почта проверяется, сканируется на наличие вредоносного ПО и проверяется спам-фильтрами.
  2. Умная очередь: Электронные письма помещаются в сложную систему очередей для доставки
  3. Интеллектуальный механизм повтора: Если доставка временно невозможна, наша система:
    • Проанализируйте ответ об ошибке, используя наш getBounceInfo функция
    • Определите, является ли проблема временной (например, «повторите попытку позже», «временно отложено») или постоянной (например, «пользователь неизвестен»).
    • В случае временных проблем отметьте письмо для повторной попытки.
    • В случае постоянных проблем создайте уведомление о недоставке
  4. 5-дневный период повторных попыток: Мы повторяем попытки доставки в течение 5 дней (аналогично отраслевым стандартам, таким как Postfix), давая время на решение временных проблем
  5. Уведомления о статусе доставки: Отправители получают уведомления о статусе своих писем (доставлено, задержано или возвращено)

[!ПРИМЕЧАНИЕ] После успешной доставки содержимое исходящей электронной почты SMTP редактируется после настраиваемого периода хранения (по умолчанию 30 дней) для безопасности и конфиденциальности. Остается только сообщение-заполнитель, указывающее на успешную доставку.

Защита от фиктивных устройств для надежности

Наша система предназначена для обработки различных пограничных случаев:

  • Если обнаружен черный список, электронное письмо будет автоматически отправлено повторно.
  • В случае возникновения сетевых проблем будет предпринята повторная попытка доставки.
  • Если почтовый ящик получателя переполнен, система повторит попытку позже.
  • Если принимающий сервер временно недоступен, мы продолжим попытки

Такой подход значительно повышает скорость доставки, сохраняя при этом конфиденциальность и безопасность.

Использование Nodemailer

Почтовая программа заметок популярный модуль для отправки электронных писем из приложений Node.js.

const nodemailer = require('nodemailer');

// Create a transporter object const transporter = nodemailer.createTransport({ host: 'smtp.forwardemail.net', port: 465, secure: true, // Use TLS auth: { user: 'your-username@your-domain.com', pass: 'your-password' } });

// Send mail with defined transport object async function sendEmail() { try { const info = await transporter.sendMail({ from: '"Your Name" <your-username@your-domain.com>', to: 'recipient@example.com', subject: 'Hello from Forward Email', text: 'Hello world! This is a test email sent using Nodemailer and Forward Email SMTP.', html: '<b>Hello world!</b> This is a test email sent using Nodemailer and Forward Email SMTP.' });

console.log('Message sent: %s', info.messageId);

} catch (error) { console.error('Error sending email:', error); } }

sendEmail();

Использование Express.js

Вот как интегрировать пересылку электронной почты SMTP с приложением Express.js:

const express = require('express');
const nodemailer = require('nodemailer');
const app = express();
const port = 3000;

app.use(express.json());

// Configure email transporter const transporter = nodemailer.createTransport({ host: 'smtp.forwardemail.net', port: 465, secure: true, auth: { user: 'your-username@your-domain.com', pass: 'your-password' } });

// API endpoint for sending emails app.post('/send-email', async (req, res) => { const { to, subject, text, html } = req.body;

try { const info = await transporter.sendMail({ from: '"Your App" <your-username@your-domain.com>', to, subject, text, html });

res.status(200).json({
  success: true,
  messageId: info.messageId
});

} catch (error) { console.error('Error sending email:', error); res.status(500).json({ success: false, error: error.message }); } });

app.listen(port, () => { console.log(Server running at http://localhost:${port}); });

Использование smtplib

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

Email configuration

sender_email = "your-username@your-domain.com" receiver_email = "recipient@example.com" password = "your-password"

Create message

message = MIMEMultipart("alternative") message["Subject"] = "Hello from Forward Email" message["From"] = sender_email message["To"] = receiver_email

Create the plain-text and HTML version of your message

text = "Hello world! This is a test email sent using Python and Forward Email SMTP." html = "<html><body><b>Hello world!</b> This is a test email sent using Python and Forward Email SMTP.</body></html>"

Turn these into plain/html MIMEText objects

part1 = MIMEText(text, "plain") part2 = MIMEText(html, "html")

Add HTML/plain-text parts to MIMEMultipart message

message.attach(part1) message.attach(part2)

Send email

try: server = smtplib.SMTP_SSL("smtp.forwardemail.net", 465) server.login(sender_email, password) server.sendmail(sender_email, receiver_email, message.as_string()) server.quit() print("Email sent successfully!") except Exception as e: print(f"Error sending email: {e}")

Использование Джанго

Для приложений Django добавьте следующее в ваш settings.py:

# Email settings
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.forwardemail.net'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'your-username@your-domain.com'
EMAIL_HOST_PASSWORD = 'your-password'
DEFAULT_FROM_EMAIL = 'your-username@your-domain.com'

Затем отправьте электронные письма с вашими мнениями:

from django.core.mail import send_mail

def send_email_view(request): send_mail( 'Subject here', 'Here is the message.', 'from@your-domain.com', ['to@example.com'], fail_silently=False, html_message='<b>Here is the HTML message.</b>' ) return HttpResponse('Email sent!')

Использование PHPMailer

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try { // Server settings $mail->isSMTP(); $mail->Host = 'smtp.forwardemail.net'; $mail->SMTPAuth = true; $mail->Username = 'your-username@your-domain.com'; $mail->Password = 'your-password'; $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; $mail->Port = 465;

// Recipients
$mail->setFrom('your-username@your-domain.com', 'Your Name');
$mail->addAddress('recipient@example.com', 'Recipient Name');
$mail->addReplyTo('your-username@your-domain.com', 'Your Name');

// Content
$mail->isHTML(true);
$mail->Subject = 'Hello from Forward Email';
$mail->Body    = '&#x3C;b>Hello world!&#x3C;/b> This is a test email sent using PHPMailer and Forward Email SMTP.';
$mail->AltBody = 'Hello world! This is a test email sent using PHPMailer and Forward Email SMTP.';

$mail->send();
echo 'Message has been sent';

} catch (Exception $e) { echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}"; }

Использование Laravel

Для приложений Laravel обновите свой .env файл:

MAIL_MAILER=smtp
MAIL_HOST=smtp.forwardemail.net
MAIL_PORT=465
MAIL_USERNAME=your-username@your-domain.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=your-username@your-domain.com
MAIL_FROM_NAME="${APP_NAME}"

Затем отправьте электронные письма с помощью фасада Laravel Mail:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request; use Illuminate\Support\Facades\Mail; use App\Mail\WelcomeEmail;

class EmailController extends Controller { public function sendEmail() { Mail::to('recipient@example.com')->send(new WelcomeEmail());

    return 'Email sent successfully!';
}

}

Использование Ruby Mail Gem

require 'mail'

Mail.defaults do delivery_method :smtp, { address: 'smtp.forwardemail.net', port: 465, domain: 'your-domain.com', user_name: 'your-username@your-domain.com', password: 'your-password', authentication: 'plain', enable_starttls_auto: true, ssl: true } end

mail = Mail.new do from 'your-username@your-domain.com' to 'recipient@example.com' subject 'Hello from Forward Email'

text_part do body 'Hello world! This is a test email sent using Ruby Mail and Forward Email SMTP.' end

html_part do content_type 'text/html; charset=UTF-8' body '<b>Hello world!</b> This is a test email sent using Ruby Mail and Forward Email SMTP.' end end

mail.deliver! puts "Email sent successfully!"

Использование API JavaMail

import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;

public class SendEmail { public static void main(String[] args) { // Sender's email and password final String username = "your-username@your-domain.com"; final String password = "your-password";

    // SMTP server properties
    Properties props = new Properties();
    props.put("mail.smtp.auth", "true");
    props.put("mail.smtp.starttls.enable", "true");
    props.put("mail.smtp.host", "smtp.forwardemail.net");
    props.put("mail.smtp.port", "465");
    props.put("mail.smtp.socketFactory.port", "465");
    props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");

    // Create session with authenticator
    Session session = Session.getInstance(props,
        new javax.mail.Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(username, password);
            }
        });

    try {
        // Create message
        Message message = new MimeMessage(session);
        message.setFrom(new InternetAddress(username));
        message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
        message.setSubject("Hello from Forward Email");

        // Create multipart message
        Multipart multipart = new MimeMultipart("alternative");

        // Text part
        BodyPart textPart = new MimeBodyPart();
        textPart.setText("Hello world! This is a test email sent using JavaMail and Forward Email SMTP.");

        // HTML part
        BodyPart htmlPart = new MimeBodyPart();
        htmlPart.setContent("&#x3C;b>Hello world!&#x3C;/b> This is a test email sent using JavaMail and Forward Email SMTP.", "text/html");

        // Add parts to multipart
        multipart.addBodyPart(textPart);
        multipart.addBodyPart(htmlPart);

        // Set content
        message.setContent(multipart);

        // Send message
        Transport.send(message);

        System.out.println("Email sent successfully!");

    } catch (MessagingException e) {
        throw new RuntimeException(e);
    }
}

}

Тандерберд

flowchart TD
    A[Open Thunderbird] --> B[Account Settings]
    B --> C[Account Actions]
    C --> D[Add Mail Account]
    D --> E[Enter Name, Email, Password]
    E --> F[Manual Config]
    F --> G[Enter Server Details]
    G --> H[SMTP: smtp.forwardemail.net]
    H --> I[Port: 465]
    I --> J[Connection: SSL/TLS]
    J --> K[Authentication: Normal Password]
    K --> L[Username: full email address]
    L --> M[Test and Create Account]
  1. Откройте Thunderbird и перейдите в «Настройки учетной записи».
  2. Нажмите «Действия с учетной записью» и выберите «Добавить учетную запись электронной почты».
  3. Введите свое имя, адрес электронной почты и пароль
  4. Нажмите «Ручная настройка» и введите следующие данные:
    • Входящий сервер:
      • IMAP: imap.forwardemail.net, Порт: 993, SSL/TLS
      • POP3: pop3.forwardemail.net, Порт: 995, SSL/TLS
    • Исходящий сервер (SMTP): smtp.forwardemail.net, порт: 465, SSL/TLS
    • Аутентификация: Обычный пароль
    • Имя пользователя: ваш полный адрес электронной почты
  5. Нажмите «Тест», а затем «Готово».

Яблочная почта

  1. Откройте Почту и перейдите в Почта > Настройки > Учетные записи.
  2. Нажмите кнопку «+», чтобы добавить новую учетную запись.
  3. Выберите «Другая учетная запись электронной почты» и нажмите «Продолжить».
  4. Введите свое имя, адрес электронной почты и пароль, затем нажмите «Войти».
  5. Если автоматическая настройка не удалась, введите следующие данные:
    • Сервер входящей почты: imap.forwardemail.net (или pop3.forwardemail.net для POP3)
    • Сервер исходящей почты: smtp.forwardemail.net
    • Имя пользователя: ваш полный адрес электронной почты
    • Пароль: ваш пароль
  6. Нажмите «Войти», чтобы завершить настройку.

Gmail (Отправить письмо как)

  1. Откройте Gmail и перейдите в Настройки > Аккаунты и импорт.
  2. В разделе «Отправить письмо как» нажмите «Добавить другой адрес электронной почты».
  3. Введите свое имя и адрес электронной почты, затем нажмите «Следующий шаг».
  4. Введите следующие данные SMTP-сервера:
    • SMTP-сервер: smtp.forwardemail.net
    • Порт: 465
    • Имя пользователя: ваш полный адрес электронной почты
    • Пароль: ваш пароль
    • Выберите «Защищенное соединение с использованием SSL».
  5. Нажмите «Добавить учетную запись» и подтвердите свой адрес электронной почты.

Распространенные проблемы и решения

  1. Аутентификация не удалась

    • Подтвердите свое имя пользователя (полный адрес электронной почты) и пароль
    • Убедитесь, что вы используете правильный порт (465 для SSL/TLS)
    • Проверьте, включен ли в вашей учетной записи доступ по протоколу SMTP.
  2. Истекло время ожидания соединения

    • Проверьте подключение к Интернету
    • Убедитесь, что настройки брандмауэра не блокируют SMTP-трафик.
    • Попробуйте использовать другой порт (587 с STARTTLS)
  3. Сообщение отклонено

    • Убедитесь, что ваш адрес «От» соответствует вашему аутентифицированному адресу электронной почты.
    • Проверьте, не занесен ли ваш IP-адрес в черный список
    • Убедитесь, что содержимое вашего сообщения не активирует спам-фильтры.
  4. Ошибки TLS/SSL

    • Обновите свое приложение/библиотеку для поддержки современных версий TLS.
    • Убедитесь, что сертификаты CA вашей системы обновлены.
    • Попробуйте явный TLS вместо неявного TLS

Получение помощи

Если вы столкнулись с проблемами, не описанными здесь, пожалуйста:

  1. Проверьте наш Страница часто задаваемых вопросов для общих вопросов
  2. Просмотрите наш запись в блоге о доставке электронной почты для подробной информации
  3. Свяжитесь с нашей службой поддержки по адресу support@forwardemail.net

Служба SMTP Forward Email обеспечивает надежный, безопасный и ориентированный на конфиденциальность способ отправки писем из ваших приложений и почтовых клиентов. Благодаря нашей интеллектуальной системе очередей, 5-дневному механизму повторных попыток и комплексным уведомлениям о статусе доставки вы можете быть уверены, что ваши письма дойдут до адресата.

Для более сложных вариантов использования или индивидуальной интеграции обратитесь в нашу службу поддержки.