API позволяет сервисам и приложениям быстро и точно обмениваться информацией. Для маркетологов API это еще и возможность выбирать самое подходящее сочетание платформ и не опасаться сложностей с совместимостью форматов разных систем.
Рекомендуем показать эту статью разработчику, который будет настраивать передачу данных. В ней мы расскажем как использовать API email сервиса SendPulse, а также на примере покажем, как создать новостную рассылку и получить по ней статистику.
Что такое API
API расшифровывается как Application Programming Interface, что в переводе означает «интерфейс программирования приложений». API — это интерфейс, в котором приложения взаимодействуют между собой, выполняя общую задачу.
API создан для передачи данных между приложениями и сервисами. Поэтому он не имеет привычной панели с кнопками, в отличие от интерфейсов, созданных для пользователей программ. API представляет собой набор готовых классов, функций, процедур, структур и констант.
Вы пользуетесь им ежедневно: передаете информацию из одного приложения в другое или настраиваете задачи по автоматическому согласованию систем. Например, API применяется когда онлайн-сервис предлагает вход через аккаунты соцсетей и не требует регистрации.
Чем API может помочь маркетологу
Маркетологам приходится проявлять гибкость в получении данных. Они собирают информацию из разных каналов, а те часто не предлагают привычный интерфейс. При передаче информации через API из одной системы в другую не важны интерфейсы этих систем. Главное, что обе стороны признают общие параметры запросов и ответов. Так информация передается быстро. И это важно для задач, требующих точности и оперативности.
Чтобы понять насколько маркетологу будет полезен API того или иного сервиса, необходимо выяснить, какие данные доступны по его API и как их получить. Попросите веб-разработчика посмотреть на интересующий вас API и обсудите с ним возможности интеграции.
Что можно сделать с помощью API в SendPulse
По API SendPulse совершают операции с адресными книгами и отправителями, кампаниями и шаблонами писем, работают с черным списком, проверяют баланс пользователя и получают информацию о рассылке.
Полная документация по API SendPulse находится на нашем сайте. В ней описаны требования для разработчиков по созданию интеграции.
Как использовать сервис SendPulse c применением API
Для тестирования и иллюстраций API в этой статье мы использовали Postman, инструмент для тестирования API. Данная программа доступна для пользователей Mac, Windows и Linux и не требует изучения языков программирования. Программа работает в режимах запуска, тестирования, документации и отслеживания. Вы можете пользоваться любым похожим приложением.
Сейчас мы рассмотрим пример того, как создать новостную рассылку и получить по ней статистику через API.
1. Авторизируемся в сервисе
Для этого получаем токен-ключ авторизации, используя метод из документации SendPulse. Возьмите значения API ID и API Secret из настроек вашего аккаунта SendPulse.
![Значения API ID и API Secret из настроек аккаунта в SendPulse Значения API ID и API Secret из настроек аккаунта в SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/api_id_secret.png)
Отправьте по API запрос на получение токена с этими значениями. В ответе сервиса будет предоставлен access token и указан его тип.
![Ответ сервиса SendPulse с указанием access token и его типа Ответ сервиса SendPulse с указанием access token и его типа](https://www.spcdn.org/blog/wp-content/uploads/2018/10/access_token.png)
Этот токен понадобится для подписи каждого запроса по API. Учтите: после генерации токен действует час, потом придется обновить его — повторить первый шаг. Также в настройках аккаунта обновляйте значения API ID и Secret в целях безопасности. После этого тоже нужно сгенерировать новый токен.
2. Создаем адресную книгу
![Создание адресной книги в SendPulse через API Создание адресной книги в SendPulse через API](https://www.spcdn.org/blog/wp-content/uploads/2018/10/create_mailing_list_id-1.png)
3. Получаем ID адресной книги
Используйте метод API для получения подробной информации по доступным адресным книгам. Важно сохранить значения ID, они нужны для идентификации списков получателей в дальнейших операциях.
![Значения ID адресных книг в настройках API email сервиса SendPulse Значения ID адресных книг в настройках API email сервиса SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/id_mailing_list.png)
4. Загружаем адреса в адресную книгу
При добавлении адресов в адресную книгу передаются и переменные — в данном случае это переменная {{Name}} со значением {{Elvira}}.
![Добавление через API email адресов в адресную книгу Добавление через API email адресов в адресную книгу](https://www.spcdn.org/blog/wp-content/uploads/2018/10/add_emails.png)
5. Загружаем шаблон письма
Если у вас уже есть шаблон письма рассылки, загрузите его в сервис, используя метод описанный в документации SendPulse.
![Загрузка шаблона письма в настройках API сервиса SendPulse Загрузка шаблона письма в настройках API сервиса SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/add_template.png)
Перед тем, как создать рассылку, определите ID загруженного шаблона. Получив список всех шаблонов, найдите ID нужного вам шаблона по имени.
![ID загруженного шаблона в настройках API ID загруженного шаблона в настройках API](https://www.spcdn.org/blog/wp-content/uploads/2018/10/template_id-1.png)
Если готового шаблона у вас нет, создайте его в блочном редакторе SendPulse.
6. Создаем рассылку по адресной книге
Вместо параметра «body» подставьте параметр «template_id» со значением из предыдущего шага.
![Значение параметра «template_id» настройках API сервиса SendPulse. Значение параметра «template_id» настройках API сервиса SendPulse.](https://www.spcdn.org/blog/wp-content/uploads/2018/10/create_campaign-1.png)
7. Получаем информацию об отправленной кампании
Для маркетолога важно знать данные о статусе кампании. По API email сервиса SendPulse можно получить информацию по рассылке. На иллюстрации ниже мы видим данные о кампании: имя и адрес отправителя, тему и содержимое письма, количество писем в рассылке, статус и дату отправки.
![Информация об отправленной кампании, полученная по API email сервиса SendPulse Информация об отправленной кампании, полученная по API email сервиса SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/statistics-2.png)
Благодаря применению разных методов API мы создали рассылку по шаблону пользователя и получили по ней информацию.
8. Смотрим как письмо выглядит в ящике получателя
Как видно на примере ниже, в хедере письма отображается имя подписчика, которое мы передали с помощью переменной {{Name}}, когда добавляли адреса получателей в адресную книгу.
![Значение переменной передалось при добавлении контакта в адресную книгу по API email сервиса SendPulse Значение переменной передалось при добавлении контакта в адресную книгу по API email сервиса SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/variable_changed.png)
9. Если нужно отправить авторассылку
После пятого шага, где вы добавляете готовый шаблон письма, можно отправить подписчикам цепочку авторассылки. Для старта цепочки возьмем дату. Например, годовщину первой покупки, а первым элементом цепочки укажем email со спецпредложением.
После отправки такого письма в указанный день добавим отправку вебхука. Так письмам будет присваиваться соответствующая переменная по результатам действий подписчиков с рассылкой: открыл письмо, отписался от рассылки, отправил письмо в спам.
![Цепочка авторассылки в Automation 360 от SendPulse Цепочка авторассылки в Automation 360 от SendPulse](https://www.spcdn.org/blog/wp-content/uploads/2018/10/a360.png)
Таким образом вы можете настроить передачу данных о действиях подписчиков с рассылкой и передать результаты в вашу систему. Эти результаты пригодятся вам для дальнейшей работы с клиентами.
Что в итоге
API упрощает сложные операции между системами. Не нужно отдельно работать с большим объемом данных для каждой системы, потому что API позволяет им взаимодействовать и облегчает работу маркетолога. Покажите эту статью веб-разработчику и приступайте к интеграции SendPulse со своим проектом через API.