Как отправить рассылку через Sendsay API

Раздел документации API, посвященный отправке выпуска рассылки, может свести с ума неподготовленного читателя, но уверяем вас, все не так страшно.

С помощью запроса ниже можно отправить транзакционное письмо адресату, указанному в параметре email. Это можно сделать в API-консоли вашего аккаунта.

{
    "action": "issue.send",
    "group": "personal",
    "sendwhen": "now",
    "email": "bigboss_from_russia@mail.ru",
    "letter": {
        "from.email": "mycompany@email",
        "subject": "Тема Продающего Письма",
        "from.name": "Екатерина",
        "message": {
            "html": "Привет"
        }
    }
}

Массовые рассылки через Sendsay API

Для начала определите — будете ли передавать все данные для выпуска в API-запросе или использовать ранее подготовленные в вашем аккаунте сущности (черновик и группу).

Обычный массовый выпуск

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

{
    "action": "issue.send",
    "group": "GROUPID",
    "sendwhen": "now",
    "letter": {
        "draft.id": "DRAFTID"
    }
}

Экспресс-выпуск

Если настройки вашего аккаунта позволяют и нужно отправить рассылку не по готовой группе, а передать список участников в запросе, то используйте «Экспресс-выпуск».

Само содержимое письма можно взять из готового черновика, а вот список получателей нужно будет подготовить в CSV или JSON в соответствии с документацией.

{
    "action": "issue.send",
    "group": "masssending",
    "sendwhen": "now",
    "letter": {
        "draft.id": "DRAFTID"
    },
    "users.list": "member.email;data.name\nask@sendsay.ru;Андрей"
}