How to Integrate ConnectiveOne with eSputnik

ConnectiveOne supports integration with the eSputnik platform for sending contacts and further work with them in marketing campaigns.

Prerequisites

Active eSputnik account
Access to eSputnik settings to obtain API keys

Configuration

Step 1: Getting Keys in eSputnik

API KEY

Go to eSputnik settings (through profile menu)
Select API Keys
Create a key with necessary permissions
Copy API KEY

APP UUID

Go to eSputnik settings (through profile menu)
Select Telegram Bot
Create a bot with the Telegram bot token you will use for integration
Copy Application ID — this is APP UUID

Step 2: Configuration in ConnectiveOne

Go to Bot Settings → select the needed bot
Scroll to the eSputnik section
Add API KEY and APP UUID
Save settings

Usage

Sending Contacts via Action

After successful integration configuration, an action for sending contacts to eSputnik esputnik__push_contact becomes available in scenarios.

Usage:

Get user's chat_id
Call the esputnik__push_contact action
Contact will be automatically added to eSputnik

The action doesn't require configuration but requires chat_id presence in state.

Sending Contacts via API Endpoint

You can use API to send all clients from the "Clients" module to the eSputnik database.

Endpoint

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

Request Parameters

Parameter	Type	Required	Description
`bot_id`	integer	✅	Your bot identifier
`token`	string	✅	Token for internal API authorization
`delay`	integer	❌	Delay between sending contact batches in seconds (for example, 2 for 2 seconds)

💡 Note: To obtain token, contact the support team.

Example Request

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

Response Format

Successful response:

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

Limitations

Contacts must have a valid phone or email
Phone must be in format 380XXXXXXXXX (Ukrainian numbers)
Email must match basic validation format
Maximum batch size: 2999 contacts
Delay between batches is configured through the delay parameter

What are integrations