База Знаний CleverApp
  • Главная
  • Обзор платформы
    • Краткий обзор платформы CleverApp и создание первого бота
    • Автоподстановка переменных в текст бота
    • Валидация — проверка введенных данных
    • Основная информация контакта
    • Политика обработки персональных данных в боте
    • Работа с датами и временем
    • Арифметические операции в боте
    • Доступ к боту и проекту | Права и роли
    • Пополнение и списание баланса с внутреннего счета контакта
    • Массовое удаление контактов
    • Как удалить аккаунт с платформы CleverApp
  • Часто задаваемые вопросы
  • Тарифы и оплата
  • Партнерская программа платформы CleverApp
  • Создание чат-ботов (блоки платформы CleverApp)
    • Простые блоки
      • Блоки “Простое сообщение” и “Цепочка сообщений”
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Заявка”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блоки “Этап сделки” и “Ответственный за сделку”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок “Таймер”
      • Блок “Задержка”
      • Блок “Удалить переменную”
      • Блок “Старт”
    • Уведомления
      • Блок "Заявка"
      • Блок "Уведомление для контакта"
      • Блок "Отправить сообщение"
      • Блок "Отправить быстрое сообщение"
      • Блок "Письмо на Email"
    • Списки и таблицы
      • Блок “Чтение записей из списка”
      • Блок “Чтение записи из списка”
      • Блок “Добавление записи в список”
      • Блок “Проверка существования записи в списке”
      • Блок “Бронирование записи из списка”
      • Блок “Чтение строк из таблицы”
    • Платежи
    • Магазин
      • Блок "Чтение записей из списка"
      • Блок "Чтение записи из списка"
      • Блок “Корзина”
      • Блок “Список заказов”
    • Рассылка
    • Голосования
      • Блок “Регистрация участника голосования”
      • Блок “Голосование за участника”
      • Блок “Лидеры голосования”
    • Интеграции
      • Блок "Заказ на GetCourse"
      • Блок “Запись в Google Таблицу”
      • Блок “Проверка существования записи в Google Таблице”
      • Блок “Чтение списка из Клиентской Базы”
      • Блок “Чтение записи из Клиентской Базы”
      • Блок “Отправить контакт в группу JustClick”
      • Блок “Отправить контакт в группу Flowell”
      • Блок “HTTP запрос”
      • Блок “Исходящий Webhook”
    • Специальные
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блок “Бронирование записи из списка”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок "Письмо на Email"
      • Блок "Операция над переменной"
      • Блок “Удалить переменную”
      • Блок "A/B-тестирование"
      • Блок “Старт”
      • Блок "Удалить пользователя из бота"
      • Блок “Встроенный бот Телеграм”
      • Блок "Входящий Webhook"
      • Блок “HTTP запрос”
      • Блок “Интерпретатор JavaScript”
      • Блок “Исходящий Webhook”
      • Блок "Распределение по группам"
    • Enterprise блоки
    • Меню слева
      • Сценарий
      • Сообщения
      • Каналы
      • Авторассылки
      • Настройки
      • CRM
      • Списки
      • Бронирование
      • Статистика
  • Кнопки меню со встроенными ссылками
  • Меню в боте Telegram
  • Мессенджеры и соц. сети
    • Telegram
      • Создаем чат-бот и подключаем к каналу Telegram
      • Настройки в BotFather
      • Прямые ссылки на дополнительные сценарии в Телеграм
      • Инлайн-кнопки меню со встроенными ссылками
      • Инлайн-кнопки меню со встроенными ссылками на Web App приложение
      • Как передать права на Telegram-бота в @BotFather?
      • Подмена предыдущего сообщения в чате Telegram-бота
      • Business-аккаунт Telegram
      • Администрация канала или группы
    • Viber
      • Создаем чат-бот и подключаем к каналу Viber
      • Инлайн-кнопки меню со встроенными ссылками
    • WhatsApp
      • Создаем чат-бот и подключаем к каналу Whatsapp
      • Меню для WhatsApp
    • ВКонтакте
      • Создаем чат-бот и подключаем к каналу ВКонтакте
      • Инлайн-кнопки меню со встроенными ссылками
    • ТамТам
      • Создаем чат-бот и подключаем к каналу ТамТам
  • Авторассылки
    • Создание авторассылки
    • Гибкие фильтры авторассылок в CleverApp
    • Отложенная отправка сообщений
  • Магазин в Telegram
    • Импорт товаров в списки
    • Блоки “Чтение записей/записи из списка”
    • Постоплата и адрес доставки в корзине
    • Блок “Встроенный бот Телеграм” – Создание меню для магазина в Telegram
  • Аналитика
    • Встроенная CRM
    • UTM-метки
    • Статистика заявок и посетителей
    • Конверсии связей в сценариях
  • Интеграции
    • CRMCA
    • Клиентская база
    • amoCRM
    • Битрикс24
    • Платежные системы
      • Прием платежей и интеграция с ЮKassa
      • Прием платежей на ЮMoney
      • Прием платежей и интеграция с Robokassa
      • Прием платежей и интеграция с Cloudpayments
      • Прием платежей и интеграция c Prodamus
      • Прием платежей и интеграция с bePaid
      • Прием платежей и интеграция с LiqPay
      • Прием платежей и интеграция с JustClick
      • Прием платежей и интеграция с Flowell
      • Прием платежей и интеграция c Crypto Pay
    • Google Таблицы
    • SMS провайдеры
      • Интеграция с SMS.RU
      • Интеграция с SMS.to
      • Интеграция с SMSala
    • ERESH
    • GetCourse
    • YCLIENTS
    • Make
    • Integromat
    • Postback (постбек)
    • Интеграция CleverApp и ChatGPT
  • Конструктор Мини-лендингов
  • Форма "Захват телефона"
  • Конструктор Виджетов
  • Создание реферальной системы в Telegram
  • Создание бота с ChatGPT
  • JavaScript решения
  • Для разработчиков
    • Документация и работа с API
      • Основы
      • Аккаунт
      • Контакты
        • Счета
        • Счета в криптовалюте
        • Реферальная система
        • Теги
        • Пользовательские переменные
      • Списки
        • Элементы списка
      • Сообщения
      • Рассылка
      • Примеры реализации API интеграций
    • JavaScript API
      • Основы
      • Переменные
      • Функции
        • Пользовательские переменные
          • getContactVariable()
          • setContactVariable()
          • deleteContactVariable()
        • Теги
          • hasContactTag()
          • setContactTag()
          • deleteContactTag()
        • Глобальные переменные
          • getGlobalVariable()
          • setGlobalVariable()
          • deleteGlobalVariable()
        • Общие функции
          • sendMessage()
          • goToBlock()
          • disableContinue()
          • setContactById()
          • setContactByTelegramId()
          • setContactByViberId()
          • setContactByVkId()
          • setContactByWhatsAppPhone()
      • Блок "Входящий Webhook"
      • Блок "HTTP-запрос"
      • Блок "Интерпретатор JavaScript"
  • Полезное
    • Самозанятые
      • Как стать самозанятым?! Инструкция
    • Лайфхаки
      • Для Telegram
        • Гиперссылка в тексте бота
        • Скрытый текст в боте
  • Личный кабинет
  • Обновления платформы
  • Написать в поддержку
Powered by GitBook
On this page
  • Получение данных списка контактов
  • Удаление тега для контакта
  • Получение списка тегов контакта
  • Получение списка переменных пользователя
  • Создание или обновление переменной
  • Удаление переменной
  1. Для разработчиков
  2. Документация и работа с API

Примеры реализации API интеграций

Передаем обязательные поля (смотрите раздел Основы)

PreviousРассылкаNextJavaScript API

Last updated 1 year ago

Token - Токен для взаимодействия с API (Получить можно в разделе )

Дополнительные данные

bot_id - внутренний ID бота

contact_id - ID контакта в списке "Контакты"

tag - значение тега value - значение переменной

*name - имя переменной

*применяется для переменных пользователя

Получение данных списка контактов

Применяется GET-запрос

<? 
function removegetContacts($token) {
  global $token; // доступ к глобальной переменной $token
  $apiUrl = 'https://watbot.ru/api/v1/getContacts?api_token=' . $token . '';
    // Создаем новый cURL ресурс
    $ch = curl_init();
    // Устанавливаем настройки cURL
    curl_setopt($ch, CURLOPT_URL, $apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    // Выполняем запрос
    $response = curl_exec($ch);
    // Закрываем cURL ресурс
    curl_close($ch);
    // Обрабатываем ответ
    if ($response === false) {
        // В случае ошибки
        echo 'Ошибка при получении контактов.';
    } else {
        // В случае успеха
        // Преобразуем полученные данные из JSON в ассоциативный массив
        $contacts = json_decode($response, true);
        
        // Выводим данные в формате JSON
        echo json_encode($contacts);
    }
}
// Вызываем функцию removeTagFromContact
removegetContacts($token);
?> 

Удаление тега для контакта

Применяется POST-запрос

<?
function removeTagFromContact($token, $contact_id, $tag) {
  global $token; // доступ к глобальной переменной
  $apiUrl = 'https://watbot.ru/api/v1/detachTagFromContact?api_token=' . $token . '&contact_id=' . $contact_id . '&name=' .$tag.'';
    // Создаем новый cURL ресурс
    $ch = curl_init();
    // Устанавливаем настройки cURL
    curl_setopt($ch, CURLOPT_URL, $apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    // Выполняем запрос
    $response = curl_exec($ch);
    // Закрываем cURL ресурс
    curl_close($ch);
    // Обрабатываем ответ
    if ($response === false) {
        // В случае ошибки
        echo 'Ошибка при удалении тега контакта.';
    } else {
        // В случае успеха
        // Преобразуем полученные данные из JSON в ассоциативный массив
        $contacts = json_decode($response, true);
        
        // Выводим данные в формате JSON
        echo json_encode($contacts);
    }
}
// Вызываем функцию removeTagFromContact
removeTagFromContact($token, $contact_id, $tag);
?>

Получение списка тегов контакта

Применяется GET-запрос

<?
function getContactTags($token, $contact_id) {
  global $token; //доступ к глобальной переменной
  $apiUrl = 'https://watbot.ru/api/v1/getContactTags?contact_id=' . $contact_id . '&api_token=' . $token . '';
    // Создаем новый cURL ресурс
   $ch = curl_init();
    // Устанавливаем настройки cURL
    curl_setopt($ch, CURLOPT_URL, $apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    // Выполняем запрос
  $response = curl_exec($ch);
    // Закрываем cURL ресурс
    curl_close($ch);
    // Обрабатываем ответ
    if ($response === false) {
        // В случае ошибки
        echo 'Ошибка при получении тегов контакта.';
    } else {
        // В случае успеха
        // Преобразуем полученные данные из JSON в ассоциативный массив
       $contact = json_decode($response, true);
        
        // Выводим данные в формате JSON
        echo json_encode($contact);
    }
}
// Вызываем функцию getContactTags
getContactTags($token, $contact_id);
?>

Получение списка переменных пользователя

Применяется GET-запрос

<?
function getContactVariables($contact_id) {
global $token; //доступ к глобальной переменной
  $apiUrl = "https://watbot.ru/api/v1/getContactVariables?api_token=" . $token . "&contact_id=" . $contact_id;
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $apiUrl);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  $response = curl_exec($ch);
  curl_close($ch);
  if ($response === false) {
      echo 'Ошибка при получении списка переменных пользователя.';
  } else {
      $variables = json_decode($response, true);
  }
}
//Вызываем функцию getContactVariables
getContactVariables($contact_id);
?>

Создание или обновление переменной

Применяется POST-запрос

<?
function setContactVariable($contact_id, $name, $value) {
global $token; //доступ к глобальной переменной
  $apiUrl = "https://watbot.ru/api/v1/setContactVariable?api_token=" . $token . "&contact_id=" . $contact_id."&name=".$name."&value=".$value;
  $data = array(
    "contact_id" => $contact_id,
    "name" => $name,
    "value" => $value);
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $apiUrl);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
  $response = curl_exec($ch);
  curl_close($ch);
  if ($response === false) {
      echo 'Ошибка при обновлении или создании переменной пользователя.';
  } else {
      $result = json_decode($response, true);
  }
}
//Вызываем функцию setContactVariables 
setContactVariable($contact_id, $name, $value);
?>

Удаление переменной

Применяется POST-запрос

<?
function deleteContactVariable($contact_id, $name) {
global $token; //доступ к глобальной переменной
  $apiUrl = "https://watbot.ru/api/v1/deleteContactVariable?api_token=" . $token . "&contact_id=" . $contact_id . "&name=" . $name;
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $apiUrl);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
  $response = curl_exec($ch);
  curl_close($ch);
  if ($response === false) {
      echo 'Ошибка при удалении переменной пользователя.';
  } else {
      $result = json_decode($response, true);
  }
}
//Вызываем функцию deleteContactVariables
deleteContactVariable($contact_id, $name);
?>

Раздел будет дополняться

Основы
https://app.cleverapp.pro/settings