Выплаты Agents Telegram

Инструкция по настройке выплат Agents Telegram

Описание

Модуль позволяет настроить выплату валюты через операторов, которые будут получать в отдельной телеграм группе сообщения с возможными заявками. В группе будет возможность видеть детали заявки, закрепляться за ними и изменять их статус после успешной/неуспешной выплаты. Администратор сможет мониторить в группе статусы заявки, операторов, а также время затраченное на выплату.

Установка

Используя параметры ниже, установите модуль через функционал "Install plugin" по инструкции Install plugin.

Параметры для Install Plugin

Plugin type: Payout module

Plugin URL: @boxexchanger-plugins/payout-agents-telegram

Directory path: agents-telegram

Auth: (Deploy token): оставляем пустым

Package tag: latest

Конфигурация

1. Создайте в Telegram новую группу и добавьте в нее бота https://t.me/payout_agents_bot.

2. В чате созданной группы, отправьте команду /start@payout_agents_botдля генерации API URL и ключей -> значения API URL, API Key, Secret Key в надежное место -> удалите сообщение из чата в целях безопасности.

Для перегенерации ключей вы можете использовать команду /regenerate@payout_agents_bot

Команды /start@payout_agents_bot и /regenerate@payout_agents_bot могут быть вызваны любым участником группы, однако бот отправит API URL, API Key, Secret Key либо перегенерирует ключи только если команды выше вызовет администратор группы.

3. Зайдите в админ панель скрипта -> страница "Мерчант и API" - раздел "PAYOUT SYSTEM" -> нажмите на в блоке с модулем выплаты "Payout Agents".

4. На странице настроек модуля укажите значения API URL, API Key, Secret Key в соответствующие поля -> нажмите "" напротив каждого поля.

5. Для поля "Send route fields (from order)" выберите подходящий параметр по таблице ниже -> нажмите "Save".

Yes	No
При параметре "Yes", в сообщении с деталями заявки будут отображаться и данные из полей валюты вывода и данные из полей направления.	При параметре "No", в сообщении с деталями заявки будут отображаться только данные из полей валюты выплаты.

6. В настройках валюты/направления установите "Payout Agents" в качестве модуля выплаты.

Обратите внимание, одна группа в телеграм = один модуль выплаты "Payout Agents". В случае, если вам необходимо разделить выплаты разных валют по группам, к примеру, "Выплата UAH", "Выплата USD" и т.д, то вы можете дублировать данный модуль выплаты через функционал Install plugin, при этом указывая уникальный "Directory path" для каждого последующего модуля. Также учтите, что для каждого нового модуля необходимо указывать уникальный API URL, API Key, Secret Key, которые возможно получить в новой созданной Telegram группе по инструкции выше.

Взаимодействие с заявкой

1. В ранее созданную Telegram группу добавьте операторов, которые будут обрабатывать заявки.

2. Дождитесь пока бот отправит в группу сообщение с деталями по заявке. Пример такого сообщения на .

Обратите внимание, что бот отправляет в чат новую заявку через несколько секунд после того как для заявки был выставлен статус На выплату (то есть был запущен модуль выплаты "Payout Agents" для валюты OUT).

До момента пока заявка не была принята одним из операторов - данные из полей заявки будут частично скрыты для всех участников группы.

3. Как только один из операторов будет готов обработать заявку -> оператору необходимо нажать на кнопку "" в сообщении с необходимой заявкой. После нажатия на кнопку оператор будет закреплён за заявкой и для всех участников группы станут видны данные из полей заявки. Пример на .

4. После того как оператор закрепился за заявкой, появляется возможность обозначить выплату завершенной (кнопка "Done") либо открепиться от заявки (кнопка "Cancel"). Подробнее о каждой кнопке в таблице ниже.

Done	Cancel
При нажатии на кнопку "Done", статус заявки изменяется на Завершена, а в сообщении от бота добавляется строка с временем завершения обработки заявки. Пример на .	При нажатии на кнопку "Cancel", статус заявки изменяется на Ошибка при выплате, а в сообщении от бота добавляется строка с временем, в которое оператор открепился от заявки. Пример на .

Заявку, для которой был установлен статус Ошибка при выплате (после нажатия на кнопку "Cancel"), возможно еще раз отправить в бот чтобы ее обработал другой оператор. Для этого достаточно в админ панели скрипта, в деталях заявки изменить ее статус на На выплату. Подробнее об изменении статуса заявки в инструкции Изменение статуса.

Кнопки "Done" и "Cancel" будут отображаться для все участников группы, однако изменение статуса заявки, при нажатии на одну из кнопок, произойдет только если такое действие совершит оператор, который закрепился за заявкой. В противном случае, будет отображаться ошибка, которая сообщает о том, что заявка закреплена за другим оператором.

Структура деталей заявки

• Значения номера заявки, данных из полей, а также суммы возможно скопировать нажатием на такое значение. Пример на .

• В случае, если у оператора установлен username в Telegram, то после нажатия на кнопку "Accept", в поле "Accepted By" будет установлен username оператора, который принял заявку. Пример на .

• В случае, если у оператора отсутствует username в Telegram, то после нажатия на кнопку "Accept", в поле "Accepted By" будет установлены имя и фамилия оператора, который принял заявку. Пример на .

• В поле "Currency" отображается XML валюты вывода и тип валюты вывода. Пример на .