# Як інтегрувати 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_id` | integer | ✅ | Ідентифікатор вашого бота |
| `token` | string | ✅ | Токен для авторизації внутрішнього API |
| `delay` | integer | ❌ | Затримка між відправками пакетів контактів у секундах (наприклад, 2 для 2 секунд) |

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

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

```bash
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
  }'
```

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

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

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

## Обмеження

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

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

- [Що таке інтеграції](/uk/integrations/explanation/what-are-integrations.md)