Что такое API и как интегрировать свой сайт с SendPulse

apiAPI этоemail маркетинг APIREST APISendPulse APIчто такое API

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

Отправьте по API запрос на получение токена с этими значениями. В ответе сервиса будет предоставлен access token и указан его тип.

Ответ сервиса SendPulse с указанием access token и его типа
Ответ сервиса SendPulse с указанием access token и его типа

Этот токен понадобится для подписи каждого запроса по API. Учтите: после генерации токен действует час, потом придется обновить его — повторить первый шаг. Также в настройках аккаунта обновляйте значения API ID и Secret в целях безопасности. После этого тоже нужно сгенерировать новый токен.

2. Создаем адресную книгу

Создание адресной книги в SendPulse через API
Создание адресной книги в SendPulse через API

3. Получаем ID адресной книги

Используйте метод API для получения подробной информации по доступным адресным книгам. Важно сохранить значения ID, они нужны для идентификации списков получателей в дальнейших операциях.

Значения ID адресных книг в настройках API email сервиса SendPulse
Значения ID адресных книг в ответе API email сервиса SendPulse

4. Загружаем адреса в адресную книгу

При добавлении адресов в адресную книгу передаются и переменные — в данном случае это переменная {{Name}} со значением {{Elvira}}.

Добавление через API email адресов в адресную книгу
Добавление через API email адресов в адресную книгу

5. Загружаем шаблон письма

Если у вас уже есть шаблон письма рассылки, загрузите его в сервис, используя метод описанный в документации SendPulse.

Загрузка шаблона письма в настройках API сервиса SendPulse
Загрузка шаблона письма по API email сервиса SendPulse

Перед тем, как создать рассылку, определите ID загруженного шаблона. Получив список всех шаблонов, найдите ID нужного вам шаблона по имени.

ID загруженного шаблона в настройках API
ID загруженного шаблона в ответе API email сервиса SendPulse

Если готового шаблона у вас нет, создайте его в блочном редакторе SendPulse.

6. Создаем рассылку по адресной книге

Вместо параметра «body» подставьте параметр «template_id» со значением из предыдущего шага.

Значение параметра «template_id» настройках API сервиса SendPulse.
Передача значения параметра «template_id» по API сервиса SendPulse

7. Получаем информацию об отправленной кампании

Для маркетолога важно знать данные о статусе кампании. По API email сервиса SendPulse можно получить информацию по рассылке. На иллюстрации ниже мы видим данные о кампании: имя и адрес отправителя, тему и содержимое письма, количество писем в рассылке, статус и дату отправки.

Информация об отправленной кампании, полученная по API email сервиса SendPulse
Информация об отправленной кампании, полученная по API email сервиса SendPulse

Благодаря применению разных методов API мы создали рассылку по шаблону пользователя и получили по ней информацию.

Подробную аналитику по вашим email рассылкам удобно просматривать непосредственно в аккаунте SendPulse.

8. Смотрим как письмо выглядит в ящике получателя

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

Значение переменной передалось при добавлении контакта в адресную книгу по API email сервиса SendPulse
Значение переменной передалось при добавлении контакта в адресную книгу по API email сервиса SendPulse

9. Если нужно отправить авторассылку

После пятого шага, где вы добавляете готовый шаблон письма, можно отправить подписчикам цепочку авторассылки. Для старта цепочки возьмем дату. Например, годовщину первой покупки, а первым элементом цепочки укажем email со спецпредложением.

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

Цепочка авторассылки в Automation 360 от SendPulse
Цепочка авторассылки в Automation 360 от SendPulse

Таким образом вы можете настроить передачу данных о действиях подписчиков с рассылкой и передать результаты в вашу систему. Эти результаты пригодятся вам для дальнейшей работы с клиентами.

Что в итоге

API упрощает сложные операции между системами. Не нужно отдельно работать с большим объемом данных для каждой системы, потому что API позволяет им взаимодействовать и облегчает работу маркетолога. Покажите эту статью веб-разработчику и приступайте к интеграции SendPulse со своим проектом через API.

[Всего голосов: 0    Средний: 0/5]
SendPulse

15 000 email сообщений бесплатно каждый месяц.