- Strona wyszukiwania
- Spis treści
Przykłady integracji SMTP
Przedmowa
Ten przewodnik zawiera szczegółowe przykłady integracji z usługą SMTP Forward Email przy użyciu różnych języków programowania, struktur i klientów poczty e-mail. Nasza usługa SMTP została zaprojektowana tak, aby była niezawodna, bezpieczna i łatwa do zintegrowania z istniejącymi aplikacjami.
Jak działa przetwarzanie SMTP usługi Forward Email
Zanim przejdziemy do przykładów integracji, ważne jest zrozumienie, w jaki sposób nasza usługa SMTP przetwarza wiadomości e-mail:
Kolejka wiadomości e-mail i system ponawiania prób
Kiedy wysyłasz wiadomość e-mail za pośrednictwem protokołu SMTP na nasze serwery:
- Początkowe przetwarzanie:E-mail jest weryfikowany, skanowany pod kątem złośliwego oprogramowania i sprawdzany pod kątem filtrów antyspamowych
- Inteligentne kolejkowanie:Wiadomości e-mail są umieszczane w zaawansowanym systemie kolejkowania w celu dostarczenia
- Inteligentny mechanizm ponawiania prób:Jeśli dostawa nie powiedzie się tymczasowo, nasz system:
- Przeanalizuj odpowiedź błędu za pomocą naszego
getBounceInfo
funkcjonować - Określ, czy problem jest tymczasowy (np. „spróbuj ponownie później”, „tymczasowo odroczony”) czy stały (np. „użytkownik nieznany”)
- W przypadku problemów tymczasowych oznacz wiadomość e-mail do ponownej próby
- W przypadku stałych problemów wygeneruj powiadomienie o niedostarczeniu
- Przeanalizuj odpowiedź błędu za pomocą naszego
- 5-dniowy okres ponawiania prób: Ponawiamy próby dostarczenia przesyłki przez okres do 5 dni (podobnie jak w przypadku standardów branżowych, takich jak Postfix), dając czas na rozwiązanie tymczasowych problemów
- Powiadomienia o statusie dostawy:Nadawcy otrzymują powiadomienia o statusie swoich wiadomości e-mail (dostarczone, opóźnione lub niedostarczone)
[!NOTE] Po pomyślnym dostarczeniu, treść wychodzącej wiadomości e-mail SMTP jest redagowana po konfigurowalnym okresie przechowywania (domyślnie 30 dni) ze względów bezpieczeństwa i prywatności. Pozostaje tylko komunikat zastępczy wskazujący pomyślne dostarczenie.
Zabezpieczony przed błędami dla niezawodności
Nasz system jest zaprojektowany tak, aby radzić sobie z różnymi przypadkami skrajnymi:
- Jeśli zostanie wykryta lista blokowanych, próba wysłania wiadomości e-mail zostanie automatycznie ponowiona
- W przypadku wystąpienia problemów z siecią, próba dostarczenia zostanie ponowiona
- Jeżeli skrzynka odbiorcza jest pełna, system spróbuje ponownie później
- Jeśli serwer odbiorczy jest tymczasowo niedostępny, będziemy nadal próbować
Takie podejście znacząco zwiększa wskaźnik doręczeń, zapewniając jednocześnie prywatność i bezpieczeństwo.
Integracja Node.js
Korzystanie z Nodemailer
Nodemailer jest popularnym modułem umożliwiającym wysyłanie wiadomości e-mail z aplikacji 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();
Korzystanie z Express.js
Oto jak zintegrować funkcję Forward Email SMTP z aplikacją 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}
);
});
Integracja Pythona
Korzystanie z smtplib
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
Email configurationsender_email = "your-username@your-domain.com"
receiver_email = "recipient@example.com"
password = "your-password"
Create messagemessage = 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 messagetext = "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 objectspart1 = MIMEText(text, "plain")
part2 = MIMEText(html, "html")
Add HTML/plain-text parts to MIMEMultipart messagemessage.attach(part1)
message.attach(part2)
Send emailtry:
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}")
Korzystanie z Django
W przypadku aplikacji Django dodaj do swojego 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'
Następnie wyślij e-maile w swoich widokach:
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!')
Integracja PHP
Korzystanie z PHPMailera
<?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 = '<b>Hello world!</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}";
}
Korzystanie z Laravel
W przypadku aplikacji Laravel zaktualizuj .env
plik:
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}"
Następnie wyślij wiadomości e-mail, korzystając z fasady Mail Laravela:
<?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!';
}
}
Integracja Ruby
Korzystanie z 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!"
Integracja Java
Korzystanie z interfejsu API poczty Java
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("<b>Hello world!</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);
}
}
}
Konfiguracja klienta poczty e-mail
Ptak piorunowy
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]
- Otwórz Thunderbirda i przejdź do Ustawień konta
- Kliknij „Akcje konta” i wybierz „Dodaj konto pocztowe”
- Wprowadź swoje imię, adres e-mail i hasło
- Kliknij „Konfiguracja ręczna” i wprowadź następujące dane:
- Serwer przychodzący:
- IMAP: imap.forwardemail.net, Port: 993, SSL/TLS
- POP3: pop3.forwardemail.net, Port: 995, SSL/TLS
- Serwer wychodzący (SMTP): smtp.forwardemail.net, Port: 465, SSL/TLS
- Uwierzytelnianie: Normalne hasło
- Nazwa użytkownika: Twój pełny adres e-mail
- Serwer przychodzący:
- Kliknij „Testuj”, a następnie „Gotowe”
Poczta Apple
- Otwórz aplikację Poczta i przejdź do opcji Poczta > Preferencje > Konta
- Kliknij przycisk „+”, aby dodać nowe konto
- Wybierz „Inne konto pocztowe” i kliknij „Kontynuuj”
- Wprowadź swoje imię, adres e-mail i hasło, a następnie kliknij „Zaloguj się”
- Jeśli automatyczna konfiguracja się nie powiedzie, wprowadź następujące dane:
- Serwer poczty przychodzącej: imap.forwardemail.net (lub pop3.forwardemail.net dla POP3)
- Serwer poczty wychodzącej: smtp.forwardemail.net
- Nazwa użytkownika: Twój pełny adres e-mail
- Hasło: Twoje hasło
- Kliknij „Zaloguj się”, aby zakończyć konfigurację
Gmail (Wyślij pocztę jako)
- Otwórz Gmaila i przejdź do Ustawienia > Konta i importowanie
- W obszarze „Wyślij pocztę jako” kliknij „Dodaj inny adres e-mail”
- Wpisz swoje imię i adres e-mail, a następnie kliknij „Następny krok”
- Wprowadź następujące dane serwera SMTP:
- Serwer SMTP: smtp.forwardemail.net
- Port: 465
- Nazwa użytkownika: Twój pełny adres e-mail
- Hasło: Twoje hasło
- Wybierz „Bezpieczne połączenie za pomocą SSL”
- Kliknij „Dodaj konto” i potwierdź swój adres e-mail
Rozwiązywanie problemów
Typowe problemy i rozwiązania
-
Uwierzytelnianie nie powiodło się
- Zweryfikuj swoją nazwę użytkownika (pełny adres e-mail) i hasło
- Upewnij się, że używasz prawidłowego portu (465 dla SSL/TLS)
- Sprawdź, czy na Twoim koncie jest włączony dostęp SMTP
-
Przekroczono limit czasu połączenia
- Sprawdź swoje połączenie internetowe
- Sprawdź, czy ustawienia zapory nie blokują ruchu SMTP
- Spróbuj użyć innego portu (587 z STARTTLS)
-
Wiadomość odrzucona
- Upewnij się, że adres „Od” jest taki sam jak Twój uwierzytelniony adres e-mail
- Sprawdź, czy Twój adres IP znajduje się na czarnej liście
- Sprawdź, czy treść Twojej wiadomości nie uruchamia filtrów antyspamowych
-
Błędy TLS/SSL
- Zaktualizuj swoją aplikację/bibliotekę, aby obsługiwała nowoczesne wersje protokołu TLS
- Upewnij się, że certyfikaty CA Twojego systemu są aktualne
- Wypróbuj jawny protokół TLS zamiast domyślnego protokołu TLS
Uzyskiwanie pomocy
Jeżeli natrafisz na problemy, które nie zostały tutaj omówione, prosimy:
- Sprawdź nasze Strona FAQ na częste pytania
- Przejrzyj nasze wpis na blogu o dostarczaniu poczty e-mail Aby uzyskać szczegółowe informacje
- Skontaktuj się z naszym zespołem wsparcia pod adresem support@forwardemail.net
Dodatkowe zasoby
Wniosek
Usługa SMTP Forward Email zapewnia niezawodny, bezpieczny i skoncentrowany na prywatności sposób wysyłania wiadomości e-mail z aplikacji i klientów poczty e-mail. Dzięki naszemu inteligentnemu systemowi kolejek, 5-dniowemu mechanizmowi ponawiania prób i kompleksowym powiadomieniom o statusie dostawy możesz mieć pewność, że Twoje wiadomości e-mail dotrą do celu.
Jeśli potrzebujesz bardziej zaawansowanych zastosowań lub integracji niestandardowych, skontaktuj się z naszym zespołem wsparcia.