Difference between revisions of "Support Agent"

From Bisq Wiki
Jump to navigation Jump to search
(45 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
== Matrix bisq.chat support agents team ==
 +
 +
The [[Matrix bisq.chat]] and Github handles for current support agents are as follows:
 +
 +
{| class="wikitable"
 +
! Name !! Matrix !! Github
 +
|-
 +
| Jmacxx || [https://matrix.to/#/@jmacxx:matrix.org @jmacxx:matrix.org] || [https://github.com/jmacxx jmacxx]
 +
|-
 +
| MnM || [https://matrix.to/#/@mwithm:matrix.org @mwithm:matrix.org] || [https://github.com/mwithm mwithm]
 +
|-
 +
| WAT || [https://matrix.to/#/@w000000t:matrix.org @w000000t:matrix.org] || [https://github.com/w0000000t w0000000t]
 +
|-
 +
| pazza83 || [https://matrix.to/#/@pazza83:matrix.org @pazza83:matrix.org] || [https://github.com/pazza83 pazza83]
 +
|-
 +
| leo816 || [https://matrix.to/#/@leo816:matrix.org @leo816:matrix.org] || [https://github.com/leo816 leo816]
 +
|}
 +
 +
Please check when speaking to a Bisq support agent that '''both''' their name and their domain extension matches the above.
 +
 
__TOC__
 
__TOC__
  
Line 6: Line 26:
  
 
* You're a Bisq user. You understand how to use it well enough to help others.
 
* You're a Bisq user. You understand how to use it well enough to help others.
* You can be available for 10 hours or more per week to field user requests.
+
* You can be available for 10 hours or more per week to handle support cases.
* You're familiar with the existing [[Docs]] and [[Knowledge Base]] articles.
+
* You're familiar with the existing [[Docs]] and [[Support_Agent_Knowledge_Base | Knowledge Base]] articles.
  
If you're interested in becoming a support agent, see the [[#Interning: How to become a support agent|#Interning]] section below.
+
If you're interested in becoming a support agent, see the [[#Internship]] section below.
  
 
==Infrastructure==
 
==Infrastructure==
Line 15: Line 35:
 
Includes all of [[Support Team#Infrastructure]], plus the following:
 
Includes all of [[Support Team#Infrastructure]], plus the following:
  
=== Coverage Calendar ===
+
=== Coverage calendar ===
  
 
The coverage calendar tracks shifts for each support agent, with the goal of achieving 24/7 coverage.
 
The coverage calendar tracks shifts for each support agent, with the goal of achieving 24/7 coverage.
Line 23: Line 43:
 
* [https://calendar.google.com/calendar?cid=dTRlZWE2YmZmazEwYjc2bDJjbWI4NmVxcWNAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ Google Calendar] (login required)
 
* [https://calendar.google.com/calendar?cid=dTRlZWE2YmZmazEwYjc2bDJjbWI4NmVxcWNAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ Google Calendar] (login required)
  
===GitHub Team===
+
===GitHub team===
 +
* [https://github.com/orgs/bisq-network/teams/support-agents @bisq-network/support-agents] (includes l1, l2 and intern subteams)
  
[https://github.com/orgs/bisq-network/teams/support-agents @bisq-network/support-agents]
+
===Role issue===
 +
* [https://github.com/bisq-network/roles/issues/64 L1 Support Agent #64]
  
===Role Issue===
+
==Duties==
  
https://github.com/bisq-network/roles/issues/64
+
===Handle support cases===
 +
If unable to solve the trade successfully you must gather the appropriate data before contacting a developer.
 +
 
 +
Required data to request support from '''developers''':
  
==Duties==
+
* Create a directory with the trade ID as name
 +
* Add a short description in a plain text file of the problem/bug. Use BTC buyer/BTC seller if you refer to any trader. Ask user when the issue happened so its easier to find the issue in the logs.
 +
* Ask them if they have done anything non-standard or had past issues.
 +
* Add all available trade tx IDs of both traders as plain text to the report.
 +
* Get a screenshot of the trade details window (click on trade ID). Tell users to only blur out the payment account details but not the tx IDs or other data. There is no relevant privacy issue with exposing trade ID, tx IDs or onion address.
 +
* Add a screenshot from the mediators dispute details window. The contract as json data is not required initially and only needed if the dev requests it. The payment account data in the json file should be removed before handing over to a dev to protect traders privacy.
 +
* Get all log files from both users (at Account/Backup there is a button for opening the data dir) - its up to 11 files.
 +
* Put all logs from one user into a directory named buyer and seller
 +
* Add a screenshot of both traders first chat message (system message containing data like version number/OS,...)
 +
* If there have been any error/warning popups request a screenshot of that as well.
 +
* Zip all and send it on Matrix chat as PM to a dev who has committed to work on it. Avoid adding it to the support channel as then nobody will feel responsible to work on it.
  
 
===Keep the coverage calendar up to date===
 
===Keep the coverage calendar up to date===
  
===Handle support cases===
+
===Submit regular cycle reports===
  
===Submit regular cycle reports===
+
Bisq Github roles page is the [https://github.com/bisq-network/roles/issues/64 place] to submit reports for every Bisq DAO Cycle.
  
 
==Rights==
 
==Rights==
  
* Writer access to the <code>bisq.support</code> Keybase subteam
+
* Writer access to the <code>Support - Private</code> Matrix room
 
* [https://help.github.com/en/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#repository-access-for-each-permission-level Triage] access to [[Support Team#Repositories]]
 
* [https://help.github.com/en/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#repository-access-for-each-permission-level Triage] access to [[Support Team#Repositories]]
 
* Edit access to the [[#Coverage Calendar]]
 
* Edit access to the [[#Coverage Calendar]]
 +
* Create com
  
  
 
==Policies==
 
==Policies==
  
===Time to Response===
+
===Time to response===
  
 
If you are on duty, it's your job to respond as promptly as possible to incoming user requests. The goal is to respond to all support inquiries in the <code>#support</code> channel within 1 hour of being asked and preferably much faster. This initial response need not actually ''resolve'' the user's issue, it is merely letting the user know that you've heard their question and that you'll be their primary support agent for this case.
 
If you are on duty, it's your job to respond as promptly as possible to incoming user requests. The goal is to respond to all support inquiries in the <code>#support</code> channel within 1 hour of being asked and preferably much faster. This initial response need not actually ''resolve'' the user's issue, it is merely letting the user know that you've heard their question and that you'll be their primary support agent for this case.
Line 58: Line 94:
 
==Processes==
 
==Processes==
  
===Interning: How to become a support agent===
+
===Internship===
  
Prospective support agents are asked to go through an internship process that lasts one DAO cycle (approximately one month). During this period, you'll perform the [[#duties]] of a support agent, but your contributions won't be eligible for compensation. This gives you a chance to get to know the ropes and for all parties involved to determine whether a support agent role is a good fit for you.
+
Prospective support agents are asked to go through an internship process that lasts one DAO cycle (approximately one month). During this period, you'll perform the [[#Duties|duties]] of a support agent, but your contributions won't be eligible for compensation. This gives you a chance to get to know the ropes and for all parties involved to determine whether a support agent role is a good fit for you.
  
 
# Indicate in the <code>#support</code> channel that you're interested in interning as a Support Agent.
 
# Indicate in the <code>#support</code> channel that you're interested in interning as a Support Agent.
Line 66: Line 102:
 
#* Mention what days and times you'll be available to do this work
 
#* Mention what days and times you'll be available to do this work
 
# The [[Support Team Lead]] will then:
 
# The [[Support Team Lead]] will then:
#* Add you to the [https://github.com/orgs/bisq-network/teams/support-agent-interns @bisq-network/support-agent-interns] team
+
#* Add you to the [https://github.com/orgs/bisq-network/teams/intern-support-agents @bisq-network/intern-support-agents] team
 
#* Add your requested shifts to the support coverage calendar
 
#* Add your requested shifts to the support coverage calendar
 +
#* Announce your internship:
 +
#** with a message to the larger [https://github.com/orgs/bisq-network/teams/support @bisq-network/support] team
 +
#** with a message in the <code>#support</code> channel
 
# After one full cycle of interning
 
# After one full cycle of interning
#* Submit a [[Proposals|proposal]] to be added to the [https://github.com/orgs/bisq-network/teams/support-agents @bisq-network/support-agents] team
+
#* Submit a [[Proposals|proposal]] to be added to the [https://github.com/orgs/bisq-network/teams/l1-support-agents @bisq-network/l1-support-agents] team
 
#* If your proposal is approved, the support team lead will promote you as per the process below.
 
#* If your proposal is approved, the support team lead will promote you as per the process below.
 +
 +
===Using the coverage calendar===
 +
 +
===Case tracking===
 +
 +
===Escalation===
 +
 +
===Reporting===
 +
 +
===Compensation===
 +
* Compensation Requests for L1 Support Agents have been established at a rate of 500 USD per cycle.
 +
* This USD amount is not tied to a number of hours but it does require for the contributor to work at least 10 hours per week to be eligible.
 +
* It is a fixed rate for all Support Agents and bonuses may apply when properly justified.
 +
* Increase in any compensation amounts will be agreed through consensus by the Support Team and Support Team Lead.
 +
  
 
[[Category:Roles]]
 
[[Category:Roles]]

Revision as of 00:14, 6 February 2022

Matrix bisq.chat support agents team

The Matrix bisq.chat and Github handles for current support agents are as follows:

Name Matrix Github
Jmacxx @jmacxx:matrix.org jmacxx
MnM @mwithm:matrix.org mwithm
WAT @w000000t:matrix.org w0000000t
pazza83 @pazza83:matrix.org pazza83
leo816 @leo816:matrix.org leo816

Please check when speaking to a Bisq support agent that both their name and their domain extension matches the above.

Requirements

What makes a great support agent?

  • You're a Bisq user. You understand how to use it well enough to help others.
  • You can be available for 10 hours or more per week to handle support cases.
  • You're familiar with the existing Docs and Knowledge Base articles.

If you're interested in becoming a support agent, see the #Internship section below.

Infrastructure

Includes all of Support Team#Infrastructure, plus the following:

Coverage calendar

The coverage calendar tracks shifts for each support agent, with the goal of achieving 24/7 coverage.

GitHub team

Role issue

Duties

Handle support cases

If unable to solve the trade successfully you must gather the appropriate data before contacting a developer.

Required data to request support from developers:

  • Create a directory with the trade ID as name
  • Add a short description in a plain text file of the problem/bug. Use BTC buyer/BTC seller if you refer to any trader. Ask user when the issue happened so its easier to find the issue in the logs.
  • Ask them if they have done anything non-standard or had past issues.
  • Add all available trade tx IDs of both traders as plain text to the report.
  • Get a screenshot of the trade details window (click on trade ID). Tell users to only blur out the payment account details but not the tx IDs or other data. There is no relevant privacy issue with exposing trade ID, tx IDs or onion address.
  • Add a screenshot from the mediators dispute details window. The contract as json data is not required initially and only needed if the dev requests it. The payment account data in the json file should be removed before handing over to a dev to protect traders privacy.
  • Get all log files from both users (at Account/Backup there is a button for opening the data dir) - its up to 11 files.
  • Put all logs from one user into a directory named buyer and seller
  • Add a screenshot of both traders first chat message (system message containing data like version number/OS,...)
  • If there have been any error/warning popups request a screenshot of that as well.
  • Zip all and send it on Matrix chat as PM to a dev who has committed to work on it. Avoid adding it to the support channel as then nobody will feel responsible to work on it.

Keep the coverage calendar up to date

Submit regular cycle reports

Bisq Github roles page is the place to submit reports for every Bisq DAO Cycle.

Rights


Policies

Time to response

If you are on duty, it's your job to respond as promptly as possible to incoming user requests. The goal is to respond to all support inquiries in the #support channel within 1 hour of being asked and preferably much faster. This initial response need not actually resolve the user's issue, it is merely letting the user know that you've heard their question and that you'll be their primary support agent for this case.

Sensitive user data

Often support agents will need to ask users to share their logs with you or specific information about their offer or trade, such as trade ID, trade amounts, etc. This data should not be shared in any public channel and should be destroyed one month after the case is closed. Note that any such information that shared in the bisq.support subteam is automatically destroyed after 30 days.

Processes

Internship

Prospective support agents are asked to go through an internship process that lasts one DAO cycle (approximately one month). During this period, you'll perform the duties of a support agent, but your contributions won't be eligible for compensation. This gives you a chance to get to know the ropes and for all parties involved to determine whether a support agent role is a good fit for you.

  1. Indicate in the #support channel that you're interested in interning as a Support Agent.
    • Say a bit about yourself and why you're interested in doing this work
    • Mention what days and times you'll be available to do this work
  2. The Support Team Lead will then:
  3. After one full cycle of interning

Using the coverage calendar

Case tracking

Escalation

Reporting

Compensation

  • Compensation Requests for L1 Support Agents have been established at a rate of 500 USD per cycle.
  • This USD amount is not tied to a number of hours but it does require for the contributor to work at least 10 hours per week to be eligible.
  • It is a fixed rate for all Support Agents and bonuses may apply when properly justified.
  • Increase in any compensation amounts will be agreed through consensus by the Support Team and Support Team Lead.