oto.cx
threecx

3cx

threecx.

The phone system's call log over a period, every extension and

ajouter à otoauth : —prefix : threecx_*

setup & usage

⚠ tes accès 3cx

le connecteur lit ton standard 3cx avec son adresse et un des deux accès suivants, choisi par auth_mode. les droits de cet accès bornent ce qui est visible.

  • base_url — l'adresse https du client web 3cx, celle de la barre d'adresse quand tu ouvres 3cx dans ton navigateur (ex. https://votre-societe.3cx.fr)
  • auth_mode=user : username et password — un compte 3cx qui voit les appels et les enregistrements des groupes voulus (un responsable de groupe suffit) ; la double authentification doit y être désactivée ; un compte dédié vaut mieux qu'un compte personnel
  • auth_mode=api_client : client_id et client_secret — un client api créé dans la console d'administration 3cx (intégrations > api), si ta licence le permet ; rôle system admin pour voir tout le standard

    • renseigne base_url, auth_mode et la paire correspondante dans tes clés de connecteur oto sous 3cx

    ▸ traces d'appels et enregistrements
  • threecx_call(date_from=…, date_to=…) une page du journal d'appels ; recorded_only=true garde les segments enregistrés ; continuer avec skip=next_skip tant que next_skip n'est pas nul
  • threecx_call(op="export", date_from=…, date_to=…) toute la période en un fichier csv (séparateur ;, durées en secondes) : les traces d'appels d'une journée ou d'une semaine, à la place d'un export quotidien
  • threecx_recording(rec_id=…) l'audio d'un enregistrement, avec le SrcRecId ou le DstRecId d'une ligne du journal ; rendu en lien signé de courte durée
  • le connecteur n'écrit jamais dans 3cx
    • ⚙ 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='threecx') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='threecx', 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 threecx …
    ← tous les connecteurscatalogue mcp →