Как передавать события в SendPulse
Чтобы отправить событие, вам понадобятся:
- URL запроса;
- email адрес или номер телефона контакта (обязательный параметр, используется для идентификации контакта для которого нужно запустить событие);
- параметры по контакту (необязательные параметры, используются как переменные для персонализации отправляемых сообщений).
- системный параметр (необязательный параметр, используется для идентификации цепочки, для которой передаются данные).
Вы можете передавать события в SendPulse с авторизацией и без авторизации.
Чтобы скопировать URL, на который передавать событие, перейдите во вкладку «Авторассылки» и нажмите «Менеджер события».
Нажмите на название созданного события.
Выберите метод запроса.
Если вы используете библиотеку SendPulse на GitHub, событие необходимо передавать с авторизацией, используя URL с вкладки «REST API POST». Ключи для авторизации вы можете взять во вкладке «API» в настройках аккаунта.
Если вы не используете библиотеку и нужно передавать события без авторизации, используйте URL с вкладки «POST raw».
Скопируйте URL c нужной вкладки.
Вы также можете передавать ID цепочки через параметр automation_id
, чтобы идентифицировать запросы и передавать персонализированные данные для разных цепочек на одну ссылку события.
Обратите внимание, что при передаче события параметр нужно передавать через тип параметра «Число» и параметр не должен быть внутри массива. При создании события automation_id
создавать параметр необязательно.
Чтобы взять значение automation_id
, скопируйте его с адресной строки на странице нужной цепочки.
К примеру, с помощью передачи ID цепочки вы можете реализовать отправку письма по событию в интернет-магазине на разных языках. В одной цепочке у вас будет английский контент, добавление в CRM по работе с англоязычными клиентами и имя с email адресом отправителя соответствующего менеджера, а в другой цепочке — контент на польском языке, сохранение в другую CRM и другой отправитель.
Пример для PHP с cURL (без авторизации):
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://events.sendpulse.com/events/id/eb561baa181247d1cd378c4ead632877/7043663',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"email": "test1@test1.com",
"phone": "+123456789",
"product_name": "product_name value",
"product_id": 123,
"product_link": "product_link value",
"product_price": "product_price value",
"product_img_url": "product_img_url value",
"event_date": "2021-05-28"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Пример для Python (без авторизации):
import requests
url = "https://events.sendpulse.com/events/id/eb561baa181247d1cd378c4ead632877/7043663"
payload="{\n \"email\": \"test1@test1.com\",\n \"phone\": \"+123456789\",\n \"product_name\": \"product_name value\",\n \"product_id\": 123,\n \"product_link\": \"product_link value\",\n \"product_price\": \"product_price value\",\n \"product_img_url\": \"product_img_url value\",\n \"event_date\": \"2021-05-28\"\n}"
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Пример для PHP (с авторизацией, используя библиотеку):
<?php
use Sendpulse\RestApi\ApiClient;
use Sendpulse\RestApi\Storage\FileStorage;
define('API_USER_ID', '');
define('API_SECRET', '');
define('PATH_TO_ATTACH_FILE', __FILE__);
$SPApiClient = new ApiClient(API_USER_ID, API_SECRET, new FileStorage());
// Start event automation360
$eventName = 'registration';
$variables = [
"email" => "test1@test1.com",
"phone" => "+123456789",
"var_1" => "var_1_value"
];
var_dump($SPApiClient->startEventAutomation360($eventName,$variables));
Пример для Python (с авторизацией, используя библиотеку):
# -*-coding:utf8-*-
""" SendPulse REST API usage example
Documentation:
https://login.sendpulse.com/manual/rest-api/
https://sendpulse.com/api
"""
from pysendpulse.pysendpulse import PySendPulse
if __name__ == "__main__":
REST_API_ID = ''
REST_API_SECRET = ''
TOKEN_STORAGE = 'memcached'
MEMCACHED_HOST = '127.0.0.1:11211'
SPApiProxy = PySendPulse(REST_API_ID, REST_API_SECRET, TOKEN_STORAGE, memcached_host=MEMCACHED_HOST)
# Start event
params = {
"email": "test1@test1.com",
"phone": "+123456789",
"var_1": "var_1_value"
}
SPApiProxy.send_event('registration', params);
Обновлено: 09.08.2022
Регистрация через соцсети
Войти через Facebook Войти через Google