You've already forked OpenIntegrations
mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-11-23 22:05:15 +02:00
Переработка части инструкций документации
This commit is contained in:
Anton Titovets
13
docs/ru/md/Instructions/GreenAPI.md
vendored
13
docs/ru/md/Instructions/GreenAPI.md
vendored
@@ -10,24 +10,13 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с WhatsApp через Green API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
1. Перейдите в [Личный кабинет Green API](https://console.green-api.com/registration) и пройдите процедуру регистрации
|
||||
|
||||
|
||||
|
||||
2. Перейдите к [списку инстансов](https://console.green-api.com/instanceList) и создайте новый
|
||||
|
||||
|
||||
|
||||
3. Выберите новый инстанс и свяжите его с аккаунтом WhatsApp по QR-коду или номеру телефона
|
||||
|
||||
|
||||
|
||||
4. Сохраните учетные данны инстанса. Для работы с библиотекой необходимы `apiUrl`, `mediaUrl`, `idInstance` и `apiTokenInstance`
|
||||
|
||||
|
||||
|
||||
Полученные данные необходимо передать в функцию `СформироватьПараметрыДоступа`. Полученная в ее результате структура будет использоваться для авторизации во всех остальных функциях работы с GreenAPI
|
||||
|
||||
```bsl
|
||||
|
||||
13
docs/ru/md/Instructions/GreenMax.md
vendored
13
docs/ru/md/Instructions/GreenMax.md
vendored
@@ -10,24 +10,13 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с Max через Green API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
1. Перейдите в [Личный кабинет Green API](https://console.green-api.com/registration) и пройдите процедуру регистрации
|
||||
|
||||
|
||||
|
||||
2. Перейдите к [списку инстансов](https://console.green-api.com/instanceList) и создайте новый
|
||||
|
||||
|
||||
|
||||
3. Выберите новый инстанс и свяжите его с аккаунтом Max по номеру телефона
|
||||
|
||||
|
||||
|
||||
4. Сохраните учетные данны инстанса. Для работы с библиотекой необходимы `apiUrl`, `mediaUrl`, `idInstance` и `apiTokenInstance`
|
||||
|
||||
|
||||
|
||||
Полученные данные необходимо передать в функцию `СформироватьПараметрыДоступа`. Полученная в ее результате структура будет использоваться для авторизации во всех остальных функциях работы с GreenAPI
|
||||
|
||||
```bsl
|
||||
|
||||
55
docs/ru/md/Instructions/Slack.md
vendored
55
docs/ru/md/Instructions/Slack.md
vendored
@@ -10,56 +10,19 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы со Slack Web API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
1. Войдите в свой аккаунт и перейдите на страницу **Your Apps** на сайте [Slack API](https://api.slack.com)
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
2. Нажмите **Create App** и выберите пункт **From scratch**
|
||||
|
||||
|
||||
|
||||
3. Выберите название и рабочую область, в которой необходимо создать приложение
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
4. Создайте новый токен, нажав **Generate Token and Scopes** ниже на странице приложения
|
||||
5. Перейдите в раздел **Premission scope** из пункта установки приложения
|
||||
6. Добавьте необходимые для ваших целей разрешения
|
||||
7. Установите приложение, нажав на кнопку **Install to Workspace**
|
||||
8. Сохраните сгенерированный токен
|
||||
|
||||
|
||||
```
|
||||
xoxb-1234567890123-4567890123456-QWERTYUIOPASDFGHJKLZXCVB
|
||||
```
|
||||
|
||||
<br/>
|
||||
|
||||
5. Выберите имя и добавьте разрешения
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
6. Перейдите в раздел **Premission scope** из пункта установки приложения
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
7. Добавьте необходимые для ваших целей разрешения
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
8. Установите приложение
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
9. Сохраните сгенерированный токен
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
Далее этот токен будет использован для авторизации при выполнении действий от имени созданного приложения
|
||||
37
docs/ru/md/Instructions/Telegram.md
vendored
37
docs/ru/md/Instructions/Telegram.md
vendored
@@ -8,35 +8,26 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
# Telegram
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с Telegram API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
Этот раздел посвящен библиотеке для работы с Telegram Bot API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
- Создайте бота Telegram
|
||||
|
||||
1. Все действия при работе с Telegram API осуществляются посредством ботов. Для создания нового бота необходимо в мессенджере начать диалог с [@BotFather](https://t.me/BotFather)
|
||||
1. Начните диалог с [@BotFather](https://t.me/BotFather) для создания нового бота
|
||||
2. Выбрать команду `/newbot`
|
||||
3. Пройдите процедуру создания нового бота, выберите отображаемое имя и username
|
||||
4. Сохраните **токен**, полученный при завершении создания
|
||||
|
||||
|
||||
```
|
||||
1234567890:AAXcxHjoAmgkhgae67fmnghjfmggkTRFkgf
|
||||
```
|
||||
|
||||
2. Выбрать в меню команду */newbot*
|
||||
Далее вы можете использовать данный токен для осуществления действий от лица бота в доступных чатах. Чат для выполнения действий определяется по его `id` - это может быть ID пользователя Telegram или имя канала, начинающееся с символа `@`. Для выполнения действий в каналах, бот должен быть назначен в качестве его администратора
|
||||
|
||||
|
||||
### Получение данных
|
||||
|
||||
3. BotFather предложит вам выбрать имя и никнейм бота, после чего процедура создания будет завершена
|
||||
После создания бота вы можете получать данные о событиях бота одним из двух способов:
|
||||
|
||||
- Сохраните **токен**, который вам прислал BotFather после завершения создания бота
|
||||
- При помощи отправки сообщений к серверу Telegram (polling). Для этого необходимо регулярно вызывать метод `ПолучитьОбновления`, при помощи которого можно собирать информацию о появлении новых событий в каком либо из чатов, к котором у бота есть доступ
|
||||
|
||||
|
||||
|
||||
- (Дополнительно) Определитесь с целью взаимодействия
|
||||
|
||||
Созданного вами бота теперь можно применить двумя способами
|
||||
|
||||
- В качестве чат-бота
|
||||
- Для автоматизации ведения канала
|
||||
|
||||
В зависимости от выбранного способа применения будет отличаться способ получения **ID чата** - параметра, отвечающего за определение объекта взаимодействия.
|
||||
|
||||
В случае с чат-ботом, ID чата будет являться ID пользователя, с которым бот осуществляет диалог. Если же бота необходимо использовать для ведения канала, то, после добавления его в качестве администратора, вместо ID чата можно использовать имя канала через @ (@MyChannel)
|
||||
|
||||
Токен и ID чата являются основными параметрами всех методов работы с Telegram API
|
||||
- При помощи Webhook. Для этого необходимо создать http-сервис с публичным адресом и SSL-сертификатом, после чего передать его в функцию `УстановитьWebhook`. Telegram будет самостоятельно присылать данные о появлении новых событий по указанному адресу, где данные события могут быть обработаны
|
||||
103
docs/ru/md/Instructions/Twitter.md
vendored
103
docs/ru/md/Instructions/Twitter.md
vendored
@@ -10,10 +10,10 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с Twitter API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы. Данная библиотека позволяет работать с функционалом бесплатного плана, т.е. создавать твиты.
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
|
||||
Работа с Twitter подразумевает работу с двумя API - v1 (1.1) и v2, которые, при этом, не относятся к разным видам действий, но просто являются версиями друг друга. Несмотря на то, что Twitter настаивает на использовании v2, вышло так, что некоторые механизмы (в частности механизм загрузки файлов) в ней так и не появились. Поэтому, даже для создания обычного твита с картинкой необходима работа с обеими версиями API, а, как следствие, двойной набор авторизационных данны. Этот набор описан в функции *ПолучитьСтандартныеПараметры()*
|
||||
Работа с Twitter подразумевает работу с двумя API - v1 (1.1) и v2, каждый из которых отвечает за свою часть функционала. Для начала работы с ними, необходимо сформировать определенный набор данных и параметров авторизации. Его структура описанна в функции `ПолучитьСтандартныеПараметры`
|
||||
|
||||
|
||||
```bsl
|
||||
@@ -34,88 +34,75 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
Вы можете определить эти параметры прямо в структуре внутри данной функции или передавать непосредственно при вызове функций уже для работы с API - каждая из них принимает параметры последним необязательным параметром. При такой передаче стандартные параметры будут перезаписаны по ключам. Рассмотрим создание приложения и получение каждого поля
|
||||
|
||||
|
||||
### Создание приложения
|
||||
Для работы с Twitter API необходимо перейти по адресу [https://developer.twitter.com/](https://developer.twitter.com/), зарегистрироваться и создать новое приложение
|
||||
### Создание приложения
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Определение полей
|
||||
После создания приложения можно заполнить необходимые данные в 1С
|
||||
Для работы с Twitter API необходимо перейти по адресу [developer.twitter.com](https://developer.twitter.com/), зарегистрироваться и пройти процедуру создания нового приложения. После этого, в панели управления приложением, нужно определить поля, требуемые для создания структуры авторизации:
|
||||
|
||||
|
||||
- **redirect_uri**
|
||||
- **redirect_uri**
|
||||
|
||||
redirect_uri - адрес обработчика http-запросов, указанный при регистрации. Авторизация API v2 требует подтверждения входа через браузер, после которого запрос со специальным кодом на данный обработчик должен будет прийти. Далее об этом будет в пункте access_token и refresh_token.
|
||||
`redirect_uri` - адрес обработчика http-запросов, указанный при регистрации. Авторизация API v2 требует подтверждения входа через браузер, после которого запрос со специальным кодом на данный обработчик должен будет прийти. Подробнее в пункте *access_token и refresh_token*.
|
||||
|
||||
|
||||
- **scope**
|
||||
- **scope**
|
||||
|
||||
scope определяет доступные для работы функции. В *ПолучитьСтандартныеПараметры()* список scope определен по умолчанию.
|
||||
scope определяет доступные для работы функции. В *ПолучитьСтандартныеПараметры()* список scope определен по умолчанию.
|
||||
|
||||
- **client_id**
|
||||
- **client_id**
|
||||
|
||||
|
||||
ID клиента может быть найден на главной странице настроек в разделе *OAuth 2.0 Clien ID and Client Secret*
|
||||
|
||||
- **client_secret**
|
||||
- **client_secret**
|
||||
|
||||
|
||||
|
||||
- **access_token** и **refresh_token**
|
||||
|
||||
Эти токены необходимо получить http запросом с указанием кода, который приходит при авторизации на http-сервис redirect_uri. Порядок действий:
|
||||
1. Создать ссылку для авторизации в браузере при помощи функции *ПолучитьСсылкуАвторизации*
|
||||
2. Добавить в модуль http-сервиса (GET) вызов функции *ОбработкаВходящегоЗапросаПослеАвторизации*, передавая HTTPСервисЗапрос как параметр.
|
||||
3. Авторизоваться в браузере по ссылке из п.1.
|
||||
3. Сохранить access_token и refresh_token, полученный из функции *ОбработкаВходящегоЗапросаПослеАвторизации* п. 2, в константы или другое хранилище
|
||||
Секрет клиента может быть сгенерирован при помощи кнопки `Generate` в том же разделе, что и ID клиента
|
||||
|
||||
|
||||
```bsl title="Получение"
|
||||
- **oauth_token** и **oauth_token_secret**
|
||||
|
||||
Функция Twitterget(Запрос)
|
||||
Могут быть сгененрированы в разделе *Authentication Tokens*, пунтк *Access Token and Secret*
|
||||
|
||||
Код = Запрос.ПараметрыЗапроса["code"];
|
||||
ОтветТокен = OPI_Twitter.ПолучитьТокен(Код, Параметры);
|
||||
- **oauth_consumer_key** и **oauth_consumer_secret**
|
||||
|
||||
Константы.TwitterRefresh.Установить(ОтветТокен["refresh_token"]);
|
||||
Константы.TwitterToken.Установить(ОтветТокен["access_token"]);
|
||||
Могут быть сгенерированы в разделе *Consumer Keys*, пунт *API Key and Secret*
|
||||
|
||||
Ответ = Новый HTTPСервисОтвет(200);
|
||||
Возврат Ответ;
|
||||
- **access_token** и **refresh_token**
|
||||
|
||||
КонецФункции
|
||||
Эти токены необходимо получить http запросом с указанием кода, который приходит при авторизации на http-сервис `redirect_uri`.Порядок действий:
|
||||
|
||||
```
|
||||
|
||||
```bsl title="Обновление"
|
||||
|
||||
Процедура ОбновлятьТокенКаждыеДваЧаса(Знач Параметры)
|
||||
|
||||
Ответ = OPI_Twitter.ОбновитьТокен(Параметры);
|
||||
Константы.TwitterToken.Установить(Ответ["access_token"]);
|
||||
Константы.TwitterRefresh.Установить(Ответ["refresh_token"]);
|
||||
|
||||
КонецПроцедуры
|
||||
```
|
||||
|
||||
Хардкодить данные токены нельзя, так как access_token действует всего 2 часа. По истечении этого времени, токен необходимо обновить функцией *ОбновитьТокен*. При этом обновляется как access_token, так и refresh_token. Т.е. при следующем обновлении сгоревшего access_token токена, refresh_token должен быть из предыдущего запроса.
|
||||
|
||||
|
||||
1. Создать ссылку для авторизации в браузере при помощи функции `ПолучитьСсылкуАвторизации`
|
||||
2. Добавить в модуль http-сервиса (GET) вызов функции `ОбработкаВходящегоЗапросаПослеАвторизации`, передавая `HTTPСервисЗапрос` как параметр.
|
||||
3. Авторизоваться в браузере по ссылке из п.1.
|
||||
3. Сохранить **access_token** и **refresh_token**, полученные из функции `ОбработкаВходящегоЗапросаПослеАвторизации` п. 2, в константы или другое хранилище
|
||||
|
||||
|
||||
- **oauth_token** и **oauth_token_secret**
|
||||
```bsl title="Получение"
|
||||
|
||||
|
||||
Функция Twitterget(Запрос)
|
||||
|
||||
- **oauth_consumer_key** и **oauth_consumer_secret**
|
||||
Код = Запрос.ПараметрыЗапроса["code"];
|
||||
ОтветТокен = OPI_Twitter.ПолучитьТокен(Код, Параметры);
|
||||
|
||||
|
||||
Константы.TwitterRefresh.Установить(ОтветТокен["refresh_token"]);
|
||||
Константы.TwitterToken.Установить(ОтветТокен["access_token"]);
|
||||
|
||||
Ответ = Новый HTTPСервисОтвет(200);
|
||||
Возврат Ответ;
|
||||
|
||||
После заполнения данных полей можно приступать к работе с методами API
|
||||
КонецФункции
|
||||
|
||||
```
|
||||
|
||||
```bsl title="Обновление"
|
||||
|
||||
Процедура ОбновлятьТокенКаждыеДваЧаса(Знач Параметры)
|
||||
|
||||
Ответ = OPI_Twitter.ОбновитьТокен(Параметры);
|
||||
Константы.TwitterToken.Установить(Ответ["access_token"]);
|
||||
Константы.TwitterRefresh.Установить(Ответ["refresh_token"]);
|
||||
|
||||
КонецПроцедуры
|
||||
```
|
||||
|
||||
Access_token действует 2 часа. По истечении этого времени, токен необходимо обновить при помощи функции `ОбновитьТокен`. При этом обновляется как `access_token`, так и `refresh_token`. Т.е. при следующем обновлении сгоревшего `access_token`, `refresh_token` должен быть из **предыдущего** запроса
|
||||
|
||||
После определения всех полей и создания структуры авторизации, они могут быть использованы в различных функция библиотеки для выполнения конкретных действий
|
||||
95
docs/ru/md/Instructions/VK.md
vendored
95
docs/ru/md/Instructions/VK.md
vendored
@@ -10,86 +10,29 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с VK API в 1С:Предприятие, OneScript и CLI. Она заточена для работы с сообществами и выполнением действий от их имени. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
Для начала работы необходимо получить некоторые параметры для VK API.
|
||||
Большинство функций данной библиотеки служат для выполнения различных операций при администрировании групп и публичных страниц. Для начала работы с ними необходимо создать приложение и получить определенный набор учетных данных, которые будут использоваться в дальнейшей работе с ними:
|
||||
|
||||
<br/><br/>
|
||||
Перечень необходимых данных в виде структуры содержится в функции *ПолучитьСтандартныеПараметры()*. Вы можете указывать значения параметров прямо в ней или же передавать их структурой при вызове любых других методов библиотеки в качестве необязательного параметра *Параметры* (последний во всех методах библиотеки). В последнем случае стандартные параметры будут перезаписаны по ключам теми, которые переданы при вызове метода. Перезаписаны будут только совпадающие по ключам данные. Если какой то параметр есть в наборе стандартных, но не был передан при вызове метода, то он сохранит стандартное значение.
|
||||
<br/><br/>
|
||||
1. Пройдите процедуру создания нового Web-приложения [на странице VK ID](https://id.vk.com/about/business/go)
|
||||
2. Получите ID созданного приложения
|
||||
3. Выберите необходимую группу и получите ее ID в разделе *Основная информация* на панели управления
|
||||
4. Сформируйте URL для получения токена приложения при помощи функции `СоздатьСсылкуПолученияТокена` или вручную. URL имеет следующую структуру:
|
||||
|
||||
```bsl
|
||||
_Параметры = Новый Структура;
|
||||
```
|
||||
https://oauth.vk.com/authorize?client_id= + ID приложения из п.2 + &scope=offline,wall,groups,photos,stats,stories,ads&v=5.131&response_type=token&redirect_uri=https://api.vk.com/blank.html
|
||||
```
|
||||
|
||||
_Параметры.Вставить("v" , "5.131");
|
||||
_Параметры.Вставить("from_group" , "1");
|
||||
_Параметры.Вставить("group_id" , "123456789");
|
||||
_Параметры.Вставить("owner_id" , "-123456789");
|
||||
_Параметры.Вставить("app_id" , "87654321");
|
||||
_Параметры.Вставить("access_token" , "vk1.a.E-byuFeG1qcN7...");
|
||||
5. Перейдите по созданной ссылке в браузере и авторизуйтесь со своим аккаунтом VK
|
||||
6. Скопируйте токен из адресной строки (строка после `access_token=`)
|
||||
7. (Дополнительно) Создайте ключ доступа группы на вкладке *Работа с API*, если планируете отправлять сообщения пользователям от лица группы
|
||||
|
||||
```
|
||||
После получения необходимых данных, вы можете сформировать структуру авторизации при помощи функции `ПолучитьПараметрыАвторизации`. Эта структура используется при вызове любой из функций библиотеки в качестве параметра `Параметры` для авторизации исходящих запросов
|
||||
|
||||
Рассмотрим получение каждого значения:
|
||||
```bsl
|
||||
IDГруппы = "123456789"; // ID группы из п.3
|
||||
IDПриложения = "123456789"; // ID приложения из п.2
|
||||
Токен = "vk1.a...."; // Токен авторизации из п.6
|
||||
|
||||
**1. v**
|
||||
|
||||
Параметр `v` означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить
|
||||
|
||||
**2. from_group**
|
||||
|
||||
От лица группы. Должен быть 1
|
||||
|
||||
**3. group_id и owner_id**
|
||||
|
||||
ID группы. Если у вас стандартный адрес группы, то id можно найти в URL. В противном случае он будет на вкладке "Управление" в группе, под полем Адрес. owner_id - тоже самое, но со знаком '-' впереди
|
||||
|
||||
|
||||
|
||||
**4. app_id**
|
||||
|
||||
app_id - ID приложения. Для создания приложения необходимо:
|
||||
|
||||
* Перейти по адресу https://id.vk.com/about/business/go, авторизоваться и ввести свои данные физ. или юр. лица
|
||||
|
||||
|
||||
|
||||
* Ввести название приложения и выбрать пункт **Web**
|
||||
|
||||
|
||||
|
||||
* Ввести доменное имя и URL обработчика перенаправлений. Тут нужно отметить, что данный механизм создания приложений - новый. Еще недавно приложения VK создавались иначе и иметь redirect_url для них было не нужно. На данный момент не совсем понятно, зачем он нужен нам для серверного приложения - просто такого понятия как серверное приложение у VK теперь нет. Теоретически, туда можно вписать что угодно - для работы с библиотекой в получении обратных данных нет необходимости. Однако, с течением времени, это может измениться.
|
||||
|
||||
|
||||
|
||||
* Ввести паспортные данные или данные об организации, включить доступ к сообществам (короче, если у вас уже было приложение до этого, то вам крупно повезло, а если нет российского паспорта - придется писать в поддержку)
|
||||
|
||||
|
||||
|
||||
* Получить app_id на странице приложения
|
||||
|
||||
|
||||
|
||||
**5. access_token**
|
||||
|
||||
Ссылку на получение access_token можно получить при помощи функции *СоздатьСсылкуПолученияТокена* или склеить вручную:
|
||||
|
||||
https://oauth.vk.com/authorize?client_id= + *app_id* + &scope=offline,wall,groups,photos,stats,stories,ads&v=5.131&response_type=token&redirect_uri=https://api.vk.com/blank.html
|
||||
|
||||
* По этой ссылке необходимо перейти в браузере
|
||||
* Авторизоваться через ВК и подтвердить доступ
|
||||
* Забрать токен из параметра URL в адресной строке
|
||||
|
||||
|
||||
|
||||
**(Дополнительно) communitytoken**
|
||||
|
||||
Некоторые методы, например для работы с чат-ботом сообщества, принимают в качестве параметра communitytoken - в этих методах он заменяет access_token. Для его получения необходимо:
|
||||
|
||||
* Зайти в раздел "Управление" в группе ВК
|
||||
* Найти вкладку "Работа с API"
|
||||
* Нажать "Создать ключ" и забрать его
|
||||
|
||||
|
||||
|
||||
Пока вам не нужно использовать такие методы, получать communitytoken не обязательно
|
||||
Параметры = ПолучитьПараметрыАвторизации(IDГруппы, IDПриложения, Токен);
|
||||
```
|
||||
22
docs/ru/md/Instructions/VKTeams.md
vendored
22
docs/ru/md/Instructions/VKTeams.md
vendored
@@ -10,39 +10,21 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
|
||||
Этот раздел посвящен библиотеке для работы с VK Teams API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
1. Зарегистрируйтесь, оформите тариф и скачайте приложение VK Teams [на главной странице](https://biz.mail.ru/teams)
|
||||
|
||||
|
||||
|
||||
2. Войдите в приложении при помощи одноразового пароля, который должен прийти на почту. Просмотреть почту необходимого пользователя можно в панели администрирования
|
||||
|
||||
|
||||
|
||||
3. Начните диалог с [@metabot](http://teams.vk.com/profile/70001) и пройдите процедуру создания нового бота
|
||||
|
||||
|
||||
|
||||
4. Сгенерируйте новый **токен** и включите возможность добавлять бота в группу (если необходимо)
|
||||
|
||||
|
||||
|
||||
5. Сохраните ID бота, получив его при помощи кнопки "Показать моих ботов"
|
||||
|
||||
|
||||
|
||||
6. Сформируйте ссылку и перейдите по ней в браузере
|
||||
|
||||
```
|
||||
|
||||
```
|
||||
На конце URL должен быть ваш ID бота
|
||||
https://teams.vk.com/profile/1234567890
|
||||
|
||||
```
|
||||
|
||||
7. Начните диалог с ботом
|
||||
|
||||
Теперь вы сможете добавлять бота в группы и управлять им при помощи **Токена** и **ID необходимого диалога** (группы или пользователя)
|
||||
|
||||
|
||||
52
docs/ru/md/Instructions/Viber.md
vendored
52
docs/ru/md/Instructions/Viber.md
vendored
@@ -18,47 +18,29 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
|
||||
Методы данной библиотеки не проходят тестирование с 10.01.2025
|
||||
:::
|
||||
|
||||
## Начало работы
|
||||
### Начало работы
|
||||
|
||||
У Viber есть два REST API: один для работы с каналами, а второй - для чат-ботов. В обоих случаях основными параметрами служат **Токен** и **IDПользователя**
|
||||
У Viber есть варианта REST API: для работы с каналами и для чат-ботов. В обоих случаях основными параметрами для работы служат **Токен** и **IDПользователя**
|
||||
|
||||
- Если вам необходимо управлять каналом:
|
||||
1. Зайдите в приложение Viber и создайте новый канал
|
||||
### Управление каналом
|
||||
|
||||
|
||||
|
||||
2. После создания, перейдите в настройки канала -> Для разработчиков, и скопируйте **Токен**
|
||||
|
||||
|
||||
|
||||
3. Установите Webhook. См. Установить Webhook
|
||||
4. **IDПользователя** - ваш ID (администратора канала). См. Получить информацию о канале
|
||||
1. Зайдите в приложение Viber и создайте новый канал
|
||||
2. После создания, перейдите в настройки канала -> Для разработчиков, и скопируйте **Токен** канала
|
||||
3. Установите Webhook для получения обновлений. См. [Установить Webhook](/docs/Viber/Settings-and-information/Set-webhook)
|
||||
4. **IDПользователя** - ваш ID или ID администратора канала. См. [Получить информацию о канале](/docs/Viber/Settings-and-information/Get-channel-information)
|
||||
|
||||
<br/>
|
||||
|
||||
- Если вам необходим чат-бот:
|
||||
1. Перейдите по ссылке [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) и авторизуйтесь с вашим номером телефона, который привязан к Viber
|
||||
### Управление чат-ботом
|
||||
|
||||
|
||||
|
||||
2. Выберите пункт создания нового бота
|
||||
|
||||
|
||||
|
||||
3. В меню создания бота заполните все необходимые поля
|
||||
|
||||
|
||||
|
||||
4. Скопируйте **Токен**
|
||||
|
||||
|
||||
|
||||
4. Найти своего нового бота вы можете отсканировав QR на странице создания или в настройках (пункт чат-боты) в приложении Viber.
|
||||
|
||||
|
||||
|
||||
5. Сейчас вы не можете начать диалог с ботом, сначала необходимо установить Webhook. См. Установить Webhook
|
||||
6. После запуска **IDПользователя** будет ID конкретного человека, ведущего диалог с ботом. Получить можно из обработки входящих сообщения по Webhook
|
||||
1. Перейдите в [в кабинет партнера Viber](https://partners.viber.com/account/create-bot-account) и авторизуйтесь с вашим номером телефона, который привязан к Viber
|
||||
2. Выберите пункт создания нового бота
|
||||
3. В меню создания бота заполните все необходимые поля
|
||||
4. Скопируйте **Токен**
|
||||
4. Получите информацию о своем боте отсканировав QR на странице создания или в настройках (пункт чат-боты) в приложении Viber
|
||||
5. Установите Webhook для получения обновлений. См. [Установить Webhook](/docs/Viber/Settings-and-information/Set-webhook)
|
||||
|
||||
|
||||
**Важно:** ID одного и того же пользователя у чата и канала - это разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот
|
||||
При работе с чат-ботом в качестве **IDПользователя** будет выступать ID конкретного человека, с которым ведется диалог. Получить можно при обработке входящих сообщения по Webhook
|
||||
|
||||
**Важно:** ID одного и того же пользователя у чата и канала имеют разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот
|
||||
Reference in New Issue
Block a user