Onebot Help
  • Добро пожаловать!
  • Специальные предложения
    • Личный аккаунт-менеджер
    • Бесплатный шаблон
  • Часто задаваемые вопросы
    • Вопросы про WhatsApp
    • Автоподстановка в сообщения
    • Загрузка файлов в чат-бот
    • Удаление контактов из бота
    • Копирование
    • Создание Meta pixel code
  • Мессенджеры
    • Telegram
      • Создание и подключение бота
      • Настройка оформления бота
      • Прямые ссылки с выбором сценария
    • WhatsApp
      • Подключение и тарифы
      • Запуск бота по заданному сообщению
      • Настройка для бота WhatsApp
      • Особенности работы чат-бота в WhatsApp
    • Viber
      • Создание и подключение бота
  • Сценарии
    • Дерево сценариев
  • Блоки конструктора
    • Простые
      • Отправка сообщений
        • Проверка ответа пользователя (валидация)
        • Кнопки в сообщении
      • Работа с тегами
      • Блок "Заявка"
      • Блок "Сценарий"
      • Работа с условиями
      • Работа с CRM
      • Запрос данных у подписчика
      • Блоки "Задержка" и "Таймер"
      • Блок "Глобальное меню"
    • Уведомления
      • Блок "Заявка"
      • Блок "Уведомление для контакта"
      • Блок "Отправить сообщение"
      • Блок "Отправить быстрое сообщение"
      • Блок "Письмо на Email"
    • Списки и таблицы
      • Блок "Чтение записей из списка"
        • Дополнительные возможности при использовании данного блока
      • Блок "Чтение записи из списка"
      • Блок "Добавление записи в список"
      • Блок "Проверка существования записи в списке"
      • Блок "Бронирование записи из списка"
      • Блок "Чтение строк из таблицы"
    • Платежи
      • BePaid
      • LiqPay
      • CryptoPay
      • Блок "Пополнить счет контакта"
      • Блок "Списать со счета контакта"
    • Магазин
      • Блок "Корзина"
      • Блок "Список заказов"
    • Рассылка
    • Голосования
      • Блок "Регистрация участника голосования"
      • Блок "Голосование за участника"
      • Блок "Лидеры голосования"
    • Интеграции
      • Блок "Запись в Google Таблицу"
      • Блок "Проверка существования записи в Google таблице"
      • Блок "HTTP-запрос"
      • Блок "Входящий Webhook"
    • Специальные
      • Блок "Операция над переменной"
      • Блок "Удалить переменную"
      • Блок "А/В-тестирование"
      • Блок "Старт"
      • Блок "Удалить пользователя из бота"
      • Блок "Встроенный бот Telegram"
      • Блок "Распределение по группам"
      • Блок "Интерпретатор JavaScript"
    • Enterprice
  • Telegram Mini Apps
  • Оптимизация Facebook Conversion API с любого этапа воронки
  • Мини-лендинги
    • Создание мини-лендинга
    • Оформление внешнего вида
    • Технические настройки мини-лендинга
    • Подключение домена через Cloudflare
    • Настройка конверсий в FB Pixel на мини-лендингах
    • Настройка рекламы на конверсии в FB
  • Виджеты
  • Интеграции
    • Google Таблицы
      • Интеграция таблицы Onebot и Google-таблиц
    • Платежные системы
      • Подключение платежной системы BePaid
      • Подключение платежной системы LiqPay
      • Подключение платежной системы CryptoPay
    • SMS-сервисы
      • SMSala
      • SMS.to
    • Postback (постбек) для настройки персонализированных сценариев
    • Интеграция Keitaro с Onebot
    • Алгоритм тестирования оффера Onebot + Keitaro
  • Работа с переменными
    • Константы
    • Глобальные переменные
    • Пользовательские переменные
    • Математические формулы в переменных
    • Системные функции
  • Встроенная CRM
  • Авторассылка
  • Подписчики
  • Настройки платформы
    • Оплата
    • Расчет оплат и тарифы
    • Управление аккаунтом
    • Настройка роли для сотрудников
    • Выдача доступов
      • Доступ к проекту
      • Доступ к чат-боту
      • Доступ к мини-лендингу
    • Настройка проекта
    • Создание бота в проекте
  • Аналитика
    • Конверсии каждого шага сценария
    • UTM-метки
    • Статистика по прямым ссылкам на сценарии
  • Реферальная программа ONEBOT
  • Работа с API платформы
    • Аккаунт
    • Сообщения
    • Рассылка
    • Контакты
      • Счета
      • Счета в криптовалюте
      • Реферальная система
      • Теги
      • Пользовательские переменные
Powered by GitBook
On this page
  • Получить список переменных
  • Создать/обновить переменную
  • Удалить переменную по ID
  • Удалить переменную по ее имени и ID контакта
  1. Работа с API платформы
  2. Контакты

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

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

GET https://app.onebot.tech/api/v1/getContactVariables

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

Path Parameters

Name
Type
Description

contact_id

String

ID контакта

{
  "data": [
    {
      "id": 1,
      "value": "Значение переменной",
      "created_at": "2022-11-22T20:54:20+00:00",
      "updated_at": "2022-11-22T20:54:31+00:00",
      "variable": {
        "id": 14,
        "name": "Имя переменной",
        "created_at": "2022-11-11T20:54:20+00:00",
        "updated_at": "2022-11-11T20:54:20+00:00"
      }
    },
    {
      "id": 2,
      "value": "Киев",
      "created_at": "2022-11-11T20:54:20+00:00",
      "updated_at": "2022-11-11T20:54:31+00:00",
      "variable": {
        "id": 25,
        "name": "Город",
        "created_at": "2022-11-22T20:54:20+00:00",
        "updated_at": "2022-11-22T20:54:20+00:00"
      }
    }
  ],
  "links": {
    "first": "https:\/\/onebot.tech\/api\/v1\/getContactVariables?page=1",
    "last": "https:\/\/onebot.tech\/api\/v1\/getContactVariables?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https:\/\/onebot.tech\/api\/v1\/getContactVariables",
    "per_page": 100,
    "to": 2,
    "total": 2
  }
}
{
  "message": "The given data was invalid.",
  "errors": {
    "contact_id": [
      "Поле contact id обязательно для заполнения."
    ]
  }
}

Создать/обновить переменную

POST https://app.onebot.tech/api/v1/setContactVariable

Этот метод позволяет создать или обновить пользовательскую переменную. Если такой переменной не существует в боте, то она создастся и привяжется к пользователю.

Query Parameters

Name
Type
Description

contact_id

Integer

ID контакта

name

String

Имя переменной

value

String

Значение переменной

deletable

Integer

Возможные значения:

0 - переменная не должна удалиться после заявки

1 - переменная должна удалиться после заявки

По умолчанию: 0

{
  "data": {
    "id": 2,
    "value": "Значение переменной",
    "created_at": "2022-11-11T11:46:15+00:00",
    "updated_at": "2022-11-11T11:46:28+00:00",
    "variable": {
      "id": 1,
      "name": "Имя переменной",
      "created_at": "2022-11-23T11:46:15+00:00",
      "updated_at": "2022-11-23T11:46:15+00:00"
    }
  }
}
{
    "message": "Forbidden"
}
{
  "message": "The given data was invalid.",
  "errors": {
    "contact_id": [
      "Поле contact id обязательно для заполнения."
    ],
    "name": [
      "Поле Имя обязательно для заполнения."
    ],
    "value": [
      "Поле value обязательно для заполнения."
    ]
  }
}

Удалить переменную по ID

POST https://app.onebot.tech/api/v1/deleteContactVariable

Этот метод позволяет удалить пользовательскую переменную по ID переменной контакта

Query Parameters

Name
Type
Description

id

Integer

ID переменной контакта

{
    // Response
}
{
    // Response
}
{
  "message": "The given data was invalid.",
  "errors": {
    "id": [
      "Поле id обязательно для заполнения, когда Имя не указано."
    ],
    "contact_id": [
      "Поле contact id обязательно для заполнения, когда id не указано."
    ],
    "name": [
      "Поле Имя обязательно для заполнения, когда id не указано."
    ]
  }
}

Обратите внимание! Нужно передавать ID переменной контакта, а не ID переменной бота.

{    
    "id": 1, // ID переменной контакта
    "value": "Значение переменной",
    "created_at": "2022-11-22T20:54:20+00:00",
    "updated_at": "2022-11-22T20:54:31+00:00",
    "variable": {
        "id": 2, // ID переменной бота
        "name": "Имя переменной",
        "created_at": "2022-11-22T20:54:20+00:00", 
        "updated_at": "2022-11-22T20:54:20+00:00"
    }
}

Удалить переменную по ее имени и ID контакта

POST https://app.onebot.tech/api/v1/deleteContactVariable

Этот метод позволяет удалить пользовательскую переменную по ID контакта и имени переменной.

Query Parameters

Name
Type
Description

contact_id

Integer

ID контакта

name

String

Имя переменной

{
    // Response
}
PreviousТеги

Last updated 11 months ago