Настройка интеграции с Telegram-ботом | Support

Пользовательские данные

Email

Омниканальность

Автоматизация

Отслеживание событий и поведения

Настройка интеграции с Telegram-ботом

Чтобы делать рассылки в вашем Telegram-боте с помощью eSputnik, выполните следующие шаги:

1. Создайте бот в сервисе @BotFather, скопируйте ключ доступа и загрузите его в eSputnik.
2. Настройте сервис на своей стороне, который будет принимать токены контактов (chat_id) из вашего бота и передавать их в eSputnik. Вы можете сделать это любым удобным для вас способом, пример реализации можно найти по ссылке.

Настройка доступа

1. Откройте @BotFather вTelegram.

2. Отправьте команды

  • /start
  • /newbot

3. Выполните инструкции по настройке бота.

4. После создания бота вы получите токен доступа. Скопируйте его.

Токен бота

5. Перейдите в настройки вашего аккаунта eSputnik на вкладку “Мои боты” и нажмите “Подключить Telegram-бот”.

Подключить Telegram-бот

6. Введите токен в соответствующее поле и нажмите “Сохранить”.

Подключение нового бота

Если требуется интегрировать уже созданный бот:

1. На вкладке “Мои боты” нажмите “Подключить Telegram-бот”.

2. Нажмите “Подключить существующий Telegram-бот”.


Подключить существующий Telegram-бот

3. В чате @BotFather введите команду /mybots, выберите нужный бот из списка, скопируйте его токен, добавьте его в соответствующее поле и нажмите “Сохранить”.

Подключение существующего бота

После подключения бота вы получите ID приложения (app_uuid) – его нужно использовать в URL для отправки запроса по добавлению и обновлению токенов ваших контактов в eSputnik: https://esputnik.com/api/v1/apps/{app_uuid}/tokens.

ID приложения

Создание и обновление контактов

Для добавления или обновления токенов контактов используйте API-метод Add application tokens (тип POST).

Формат JSON-запроса: 

{
    "tokens": [Token]
}

Формат контактных данных в запросе:

{
    "token": string,     // required
    
    // Идентификаторы для поиска контакта (по крайней мере один является обязательным)
    "contactId": Long,
    "externalCustomerId": string, 
    "phone": string,
    "email": string
}

URL для отправки запроса: /v1/apps/{app_uuid}/tokens

Запрос работает следующим образом:

  • Контакт создается со всеми идентификаторами, если в системе нет контакта с такими идентификаторами.
  • Если идентификаторы уже существуют, они не создаются и не обновляются.
  • Приоритет идентификаторов для поиска контактов в системе: contactId → externalCustomerId → phone → email.
  • Если идентификатор с наивысшим приоритетом не соответствует уже имеющемуся контакту, создается контакт с новым идентификатором и токеном.
  • Если идентификатор с наивысшим приоритетом уже существует в eSputnik, в карточке контакта будет записан токен, остальные идентификаторы будут проигнорированы. Обратите внимание: запросы методом Add application tokens не обновляют существующие токены, а только создают новые. Например, если в двух запросах с одинаковым email-адресом будут содержаться два разных токена, в карточку контакта запишутся оба.

Для обновления других контактных данных используйте методы Add/update a contact или Add/update contacts.

Статусы сообщений

Отслеживаются статусы SENT, FAILED и CLICKED.

Токен будет удален из карточки контакта при получении статуса FAILED (Forbidden), который передается, когда пользователь блокирует бот.

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email