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

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

Передумови

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

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

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

API KEY

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

APP UUID

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

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

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

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

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

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

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

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

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

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

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

Endpoint

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

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

ПараметрТипОбов'язковийОпис
bot_idinteger✅Ідентифікатор вашого бота
tokenstring✅Токен для авторизації внутрішнього API
delayinteger❌Затримка між відправками пакетів контактів у секундах (наприклад, 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

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