• Главная
• Ресурсы
• Документация
• API
• sendEmail

Метод sendEmail

Метод для отправки одного или нескольких индивидуальных email-сообщений без использования персонализации и с ограниченными возможностями получения статистики. Не рекомендуется использовать его при массовых рассылках незначительно отличающихся сообщений. Разумный сценарий использования – персональное уведомление клиента о каком-то индивидуальном событии (например, изменение статуса заказа в интернет-магазине). Для массовых рассылок похожих по содержанию писем предназначена комбинация методов createEmailMessage / createCampaign.

Если вам всё же надо отправить много писем через sendEmail, то для уменьшения нагрузки на сервер и увеличения пропускной способности рекомендуем отправлять по несколько писем за один вызов метода, а не по одному письму за раз. Мы рекомендуем отправлять до 100 писем за вызов (но если размер письма превышает 200 килобайт, то лучше ограничиться меньшим количеством). Верхняя граница – 200 писем за вызов.

Сообщения, отправляемые через sendEmail, не подтвергаются цензуре человеком, поэтому по умолчанию количество разрешаемых к отправке писем через этот метод в сутки ограничено 200, а максимальный размер письма ограничен 1 мегабайтом. Чтобы увеличить лимиты, обращайтесь в администрацию. И в любом случае, даже при увеличении лимитов email-адрес получателя должен находиться в ваших списках, и быть активным и доступным.

Поскольку сообщения и так могут быть сделаны максимально индивидуальными, подстановка полей в них не осуществляется, за исключением значения {{UnsubscribeUrl}}.

Вы можете узнать статус доставки отправленного сообщения с помощью метода checkEmail. Для ускорения работы метода sendEmail статусы доставки хранятся ограниченное время – только неделю.

Принцип использования

attachments[quotes.txt]=text%20file%content

attachments[0][a.txt]=some%20text
&attachments[1][a.txt]=other%20text&attach_multi=1

Смотрите также

• checkEmail
• createCampaign
• createEmailMessage

Пример формирования URL-запроса

http://api.unisender.com/ru/api/sendEmail?format=json&api_key=KEY
&email=test@example.com&sender_name=Mike&sender_email=mike@example.com
&subject=Sample+Subject&body=Hello,+World!&list_id=112233

— отправить сообщение Hello, World на адрес test@example.org с указанием обратного адрес Mike

Примеры на PHP

Мы настоятельно рекомендуем использовать POST-запросы, так как это более безопасный метод передачи данных, нежели GET. Подробнее о методах соединения здесь.

// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxxxx";

// Параметры сообщения
// Если скрипт в кодировке UTF-8, не используйте iconv
$email_from_name = "UniSender";
$email_from_email = "text@example.org";
$email_to = "user@example.org";
$email_body = urlencode(iconv('cp1251', 'utf-8',"Email-сообщение по-русски"));
$list_id = "234442";

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'email' => $email,
  'sender_name' => $email_from_name,
  'sender_email' => $email_from_email,
  'body' => $email_body,
  'list_id' => $list_id
);

// Устанавливаем соединение
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $POST);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_URL, 
            'http://api.unisender.com/ru/api/sendEmail?format=json');
$result = curl_exec($ch);

if ($result) {
  // Раскодируем ответ API-сервера
  $jsonObj = json_decode($result);

  if(null===$jsonObj) {
    // Ошибка в полученном ответе
    echo "Invalid JSON";

  }
  elseif(!empty($jsonObj->error)) {
    // Ошибка отправки сообщения
    echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";

  } else {
    // Сообщение успешно отправлено
    echo "Email message is sent. Message id " . $jsonObj->result->email_id;

  }
} else {
  // Ошибка соединения с API-сервером
  echo "API access error";
}