API встречается во многих задачах CRM-маркетинга. С его помощью сайт может автоматически передавать данные о заказе в CDP, обновлять данные клиента в CRM или запускать рассылку после покупки.
Саму интеграцию обычно настраивает разработчик, но маркетологу полезно понимать, как она работает. Тогда проще оценить, получится ли реализовать нужный сценарий, какие данные для него понадобятся и что спросить у технического специалиста.
Разберемся на примерах и без кода.
API помогает системам обмениваться данными
Представим интернет-магазин. Клиент оформил заказ на сайте. Информация о покупке нужна сразу нескольким системам: CRM-система должна сохранить заказ, а сервис рассылок — отправить письмо клиенту.
Можно переносить данные вручную: менеджер откроет CRM, создаст заказ, укажет клиента, сумму и товары. Но если заказов сотни в день, такой подход не работает.
Поэтому обмен между системами автоматизируют. Один из способов — API.
API позволяет одной системе обратиться к другой: передать данные, запросить информацию или попросить выполнить действие. Это обращение называется API-запрос.
Когда клиент завершает покупку в интернет-магазине, сайт отправляет API-запрос в CRM. Если перевести его с языка программ на обычный, получится примерно так:
Создай новый заказ. Его сумма — 7 000 ₽. Вот покупатель и список товаров.
CRM получает запрос и выполняет указанное действие — создает заказ с переданными данными.
Но через API не всегда можно передать любые данные.
Каждый сервис сам определяет, какие действия доступны через его API и какие данные он может принимать.
Например, сервис может позволить сообщить о брошенной оплате, но не принимать список товаров. Или принимать название товара, но не его цену.
Поэтому наличие API еще не означает, что между системами получится передать любую нужную информацию. Возможности API нужно проверять для конкретного сервиса и конкретной задачи.
Передать данные через API и использовать их — не одно и то же
Теперь представим, что данные о заказе нужно передать еще и в сервис рассылок. Маркетолог хочет для покупок дороже 5 000 ₽ запускать отдельную ветку сценария, а в письме показывать товары из заказа.
Для такой механики нужны данные о сумме и составе заказа. Сначала нужно проверить, позволяет ли API сервиса их передать.
Допустим, позволяет. Но значит ли это, что сценарий получится настроить именно так?
Не обязательно.
Сервис может получить сумму заказа, но не позволить использовать ее для ветвления сценария. Тогда настроить условие «если сумма больше 5 000 ₽ → запустить отдельную ветку» не получится.
То же самое с товарами. Сервис может получить и сохранить список покупок, но не позволить автоматически показать эти товары в письме.
Поэтому важно проверить:
а) можно ли передать нужные данные в сервис через API?
б) можно ли использовать полученные данные для нужной задачи?
Например, данные могут быть доступны для писем, сегментации и условий сценария, или только для части этих задач.
Это различие особенно важно при оценке сервисов. Фраза «данные можно передавать через API» сама по себе еще не означает, что на них получится построить нужную маркетинговую механику.
Как грамотно поставить задачу разработчику
Чтобы настроить интеграцию, недостаточно сказать разработчику: «Нам нужно передавать заказы по API». Из такой формулировки непонятно, какой результат должен получиться.
Лучше начать с маркетинговой задачи.
Например:
После первой покупки отправляем клиенту письмо с благодарностью. Если сумма заказа больше 5 000 ₽, запускаем отдельную ветку сценария. В письме показываем товары из заказа.
Из такого описания разработчик поймет, что должна делать интеграция, и сможет определить, какие данные для этого понадобятся и можно ли получить и передать их через API.
Поэтому маркетологу важно описать две вещи.
Что должно происходить и при каких условиях?
Вместо «после покупки запускаем сценарий», конкретизируем: «после первой покупки отправляем письмо, а для заказов дороже 5 000 ₽ запускаем отдельную ветку».
Какие данные нужно использовать?
Например, сумму заказа нужно проверить перед выбором ветки, а купленные товары — автоматически показать в письме.
Маркетологу при этому необязательно самому определять, какие поля должны быть в API-запросе и как технически передать данные. Это можно решить вместе с разработчиком.
Главное — понятно описать желаемый результат. Тогда разработчик сможет проверить техническую сторону.
