oto.cx
zohodesk

zoho

zohodesk.

List support tickets.

ajouter à otoauth : —prefix : zohodesk_*

setup & usage

⚠ self-client oauth zoho desk (4 champs)

zoho desk utilise un self-client oauth2 à 4 secrets. dans la console développeur zoho api, crée un self client, génère un grant token avec les scopes Desk.*, puis échange-le contre un refresh token. tu dois fournir à oto :

  • client_id et client_secret — du self client
  • refresh_token — issu de l'échange
  • org_id — l'id de ton organisation desk (en-tête orgId) — facultatif : un token mono-portail résout le portail tout seul, ne le renseigne que si un appel le réclame

    • scopes par surface — un token peut authentifier avec des scopes PARTIELS (les articles répondent pendant que les tickets rendent SCOPE_MISMATCH). demande ceux dont tu as besoin :

  • tickets → Desk.tickets.READ (+ .WRITE pour créer/modifier) · recherche → Desk.search.READ
  • contacts → Desk.contacts.READ (+ .WRITE) · départements → Desk.basic.READ · articles (KB) → Desk.articles.READ

    • renseigne ces champs dans oto sur ton compte (/account), connecteur zohodesk. byo uniquement.

    ▸ ce que tu peux faire

    gère le support zoho desk (tickets, threads, contacts) depuis claude.

  • « liste les tickets ouverts » → zohodesk_tickets (status Open)
  • « ouvre le ticket #123 avec son contact » → zohodesk_ticket (include contacts)
  • « crée un ticket » → zohodesk_create_ticket (subject + departmentId + contactId)
  • « les réponses de ce ticket » → zohodesk_ticket_threads
    • ⚙ plusieurs comptes

    ce connecteur accepte plusieurs comptes : chaque credential posé devient un compte nommé (un nom par compte), à ton niveau, à celui de ton équipe ou de ton org.

  • le premier n'a pas besoin de nom ; à partir du deuxième, chacun porte le sien (le premier prend alors le nom « principal », renommable)
  • sans précision, l'agent prend le seul compte posé, sinon celui marqué par défaut ; sinon l'appel est refusé en nommant les comptes disponibles — jamais un choix au hasard
  • viser un compte pour un appel : _account="<nom>" sur l'outil ; les lister : oto_identity(op='list', connector='zohodesk') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='zohodesk', identity_id='<nom>') ; renommer : op='rename' avec new_name
  • ⚠️ aucun outil ne parcourt les comptes tout seul : un total sur plusieurs comptes s'obtient en appelant chacun (_account) et en additionnant

    • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto zohodesk …
    ← tous les connecteurscatalogue mcp →