Документация / Общая информация

Отправка электронной почты через сервис FMailer

FMailer — это удобный сервис для отправки электронной почты с поддержкой SMTP и REST API. Для авторизации в сервисе используется Токен, который содержит логин и пароль.

Что такое токен в FMailer?

Токен — это сущность, которая используется для аутентификации при отправке писем. Он состоит из:

  • Логина (указывается при создании)
  • Пароля (генерируется автоматически, его нельзя восстановить)

Управлять токенами можно на странице «Управление токенами». Если пароль утерян, токен необходимо удалить и создать заново.

Как отправлять почту через SMTP

FMailer предоставляет SMTP-сервер для отправки писем:

  • Адрес сервера: smtp.fmailer.ru
  • Порты:
    • Без шифрования: 25, 8025
    • С шифрованием StartTLS: 587
    • (SSL не поддерживается)

Настройки SMTP-клиента:

  • Логин и пароль — данные из токена
  • Для безопасного соединения используйте порт 587 с StartTLS

Как отправлять почту через REST API

REST API — это программный интерфейс для отправки писем через HTTP-запросы. Этот способ удобен, если:

  • Нужна интеграция с веб-приложением или мобильным приложением
  • Требуется контроль над процессом отправки (логирование, обработка ошибок)
  • Нужна поддержка идемпотентности (повторные запросы не дублируют отправку)

Пример запроса:

Адрес запроса: POST /external/send_email_simple/

Payload:

{
    "recipient": "email@test.com",
    "subject": "Subject",
    "body": "Email Content",
    "sender": "from me <email@test.com>",
    "idempotency_key": "xxxxxx",
    "auth": {
        "username": "Username",
        "password": "Password"
    }
}

Пример вызова через curl:

curl -X POST "https://smtp.fmailer.ru/external/send_email_simple/" \
     -H "Content-Type: application/json" \
     -d '{
         "recipient": "email@test.com",
         "subject": "Test Email",
         "body": "Hello, this is a test email!",
         "sender": "sender@test.com",
         "idempotency_key": "12345",
         "auth": {
             "username": "your_token_login",
             "password": "your_token_password"
         }
     }'

Примеры интеграции с популярными CMS

Доступны в меню слева. Если вы не нашли инструкцию по интеграцией с вашей CMS - напишите нам!

FMailer предоставляет гибкие способы отправки электронной почты — выбирайте SMTP для классического использования или REST API для автоматизированных сценариев.