Як інтегрувати ConnectiveOne з eSputnik

ConnectiveOne підтримує інтеграцію з платформою eSputnik для надсилання контактів та подальшої роботи з ними в маркетингових кампаніях.

Передумови

Активний акаунт eSputnik
Доступ до налаштувань eSputnik для отримання API ключів

Налаштування

Крок 1: Отримання ключів в eSputnik

API KEY

Перейдіть у налаштування eSputnik (через меню профілю)
Оберіть API-ключі
Створіть ключ з необхідними правами
Скопіюйте API KEY

APP UUID

Перейдіть у налаштування eSputnik (через меню профілю)
Оберіть Telegram-бот
Створіть бота з токеном телеграм-бота, якого будете використовувати для інтеграції
Скопіюйте ID застосунку — це і є APP UUID

Крок 2: Налаштування в ConnectiveOne

Перейдіть в Налаштування ботів → оберіть потрібного бота
Пролистайте до розділу eSputnik
Додайте API KEY та APP UUID
Збережіть налаштування

Використання

Відправка контактів через action

Після успішного налаштування інтеграції в сценаріях стає доступною дія (action) для відправлення контактів до eSputnik esputnik__push_contact.

Використання:

Отримайте chat_id користувача
Викличте action esputnik__push_contact
Контакт буде автоматично додано до eSputnik

Action не потребує конфігурації, але вимагає наявності chat_id в state.

Відправка контактів через API endpoint

Ви можете використати API для відправки всіх клієнтів із модуля "Клієнти" до бази eSputnik.

Endpoint

POST https://engine-{{instance_name}}.connectiveone.io/kw/esputnik/push-contacts

Параметри запиту

Параметр	Тип	Обов'язковий	Опис
`bot_id`	integer	✅	Ідентифікатор вашого бота
`token`	string	✅	Токен для авторизації внутрішнього API
`delay`	integer	❌	Затримка між відправками пакетів контактів у секундах (наприклад, 2 для 2 секунд)

💡 Примітка: Для отримання token зверніться до команди підтримки.

Приклад запиту

curl -X POST \
  https://engine.yourinstance.connectiveone.io/kw/esputnik/push-contacts \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 43,
    "token": "Paste your token",
    "delay": 2
  }'

Формат відповіді

Успішна відповідь:

{
  "status": "success",
  "results": [200, 200, 200],
  "total_contacts": 150,
  "sent_contacts": 150
}

Обмеження

Контакти повинні мати валідний телефон або email
Телефон повинен бути в форматі 380XXXXXXXXX (українські номери)
Email повинен відповідати базовому формату валідації
Максимальний розмір пакету: 2999 контактів
Затримка між пакетами налаштовується через параметр delay

Пов'язані статті

Що таке інтеграції