RuSender - российский сервис для массовых email- и SMS-рассылок.
Общая схема подключения интеграции с RuSender
Интеграция подразумевает под собой выполнение сценария на сервере, в котором выполняется операция HTTP запроса на API RuSender с настроенными заголовками и телом запроса. В теле запроса передается тема письма, email отправителя, email получателя, текст письма и другие параметры.
Вам нужны:
- Аккаунт в RuSender
- API ключ для аутентификации ваших запросов
- Сценарий
Порядок действий
- Регистрация в системе RuSender и получение доступа к личному кабинету сервиса рассылок https://rusender.ru/
- Получение API ключа по ссылке https://beta.rusender.ru/api/
Важно
1. Чтобы получить API ключ, нужно подключить домен к RuSender и прописать ему DNS записи
2. Затем полученный API-ключ необходимо активировать через поддержку.
- Использование API RuSender для отправки писем.
В RuSender используют такие базовые варианты:
- Роут отправки письма (с готовым HTML)
- Отправка письма с использованием шаблона RuSender
- Настройка сценария по примеру ниже
Примеры сценариев с запросом в RuSender
Пример сценария с роут отправки письма (с готовым HTML)
Пример сценария с отправкой шаблона
Может быть полезно
Возможные ответы RuSender
В ответе на запрос к API, RuSender должен возвращать код ответа, который сигнализирует об успешности запроса или ошибке. Если вернулась ошибка, в теле ответа обычно идет код ошибки и краткое ее описание для последующего исправления.
Пример ответа:
javascript{ "message": "mail.to.name must be shorter than or equal to 255 characters,mail.from.email must be an email", "statusCode": 400 }
Статус | Описание |
201 | Email accepted for sending |
400 | Request body format is invalid |
401 | Invalid api-key |
402 | Is not enough resource on user Balance |
403 | ExternalMailApiKey not enabled, or user domain is not verify |
404 | User, UserDomain or ExternalMailApiKey not found |
422 | Email receiver unsubscribed from this API key mails |
503 | Service temporarily unavailable |