Client LibreDesk restreint : notes privées et étiquettes seulement
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
5e3faa47b4
commit
35a9bae018
5 files changed
+250
No files matched your search
Whitespace-only changes.
@@ -0,0 +1,87 @@
|
||||
"""Le client LibreDesk restreint : le seul code du dépôt qui parle à LibreDesk.
|
||||
|
||||
Lire des conversations et des messages ; écrire seulement une note privée et des étiquettes (spec §7.2, §7.3).
|
||||
Pas de requête générique : une écriture qui n'est pas ici n'existe pas. `ecrire=False` (simulation) : rien n'est envoyé.
|
||||
"""
|
||||
import json
|
||||
import urllib.error
|
||||
import urllib.parse
|
||||
import urllib.request
|
||||
|
||||
|
||||
class Garde(Exception):
|
||||
"""Anomalie du garde-fou d'envoi : l'appelant arrête toute l'exécution (spec §7.3)."""
|
||||
|
||||
|
||||
class LibreDesk:
|
||||
def __init__(self, url: str, cle: str, secret: str, ecrire: bool):
|
||||
self.url, self.ecrire = url.rstrip("/"), ecrire
|
||||
self._auth = f"token {cle}:{secret}"
|
||||
|
||||
def _requete(self, methode: str, chemin: str, corps: dict | None = None) -> bytes:
|
||||
r = urllib.request.Request(urllib.parse.urljoin(self.url + "/", chemin.lstrip("/")), method=methode,
|
||||
data=json.dumps(corps).encode() if corps is not None else None,
|
||||
headers={"Content-Type": "application/json"})
|
||||
r.add_unredirected_header("Authorization", self._auth) # pas vers S3 si une pièce redirige
|
||||
with urllib.request.urlopen(r, timeout=30) as rep:
|
||||
return rep.read()
|
||||
|
||||
def _data(self, methode: str, chemin: str, corps: dict | None = None):
|
||||
return json.loads(self._requete(methode, chemin, corps) or b"{}").get("data")
|
||||
|
||||
# --- lectures
|
||||
|
||||
def moi(self) -> int:
|
||||
return self._data("GET", "/api/v1/agents/me")["id"]
|
||||
|
||||
def ids_etiquettes(self) -> dict[str, int]:
|
||||
return {t["name"]: t["id"] for t in self._data("GET", "/api/v1/tags") or []}
|
||||
|
||||
def conversations(self, avec: int) -> list[dict]:
|
||||
"""Toutes les conversations qui portent l'étiquette d'id `avec`."""
|
||||
filtre = json.dumps([{"model": "conversations", "field": "tags", "operator": "contains", "value": f"[{avec}]"}])
|
||||
tout, page = [], 1
|
||||
while True:
|
||||
d = self._data("GET", f"/api/v1/conversations/all?page_size=50&page={page}"
|
||||
f"&order_by=conversations.last_message_at&order=asc&filters={urllib.parse.quote(filtre)}")
|
||||
tout += d.get("results") or []
|
||||
if page >= (d.get("total_pages") or 1):
|
||||
return tout
|
||||
page += 1
|
||||
|
||||
def etiquettes(self, uuid: str) -> list[str]:
|
||||
return self._data("GET", f"/api/v1/conversations/{uuid}").get("tags") or []
|
||||
|
||||
def messages(self, uuid: str) -> list[dict]:
|
||||
return self._data("GET", f"/api/v1/conversations/{uuid}/messages?page_size=500").get("results") or []
|
||||
|
||||
def piece(self, url: str) -> bytes:
|
||||
return self._requete("GET", url)
|
||||
|
||||
# --- écritures
|
||||
|
||||
def etiqueter(self, uuid: str, ajouter: list[str] = (), retirer: list[str] = ()) -> None:
|
||||
"""Toujours add_tags / remove_tags : sans action, LibreDesk remplacerait toutes les étiquettes."""
|
||||
if not self.ecrire:
|
||||
print(f"[simulation] {uuid} : + {list(ajouter)} − {list(retirer)}")
|
||||
return
|
||||
for action, noms in (("add_tags", ajouter), ("remove_tags", retirer)):
|
||||
if noms:
|
||||
self._data("POST", f"/api/v1/conversations/{uuid}/tags", {"tags": list(noms), "action": action})
|
||||
if ajouter and (manque := set(ajouter) - set(self.etiquettes(uuid))):
|
||||
raise RuntimeError(f"étiquettes absentes de LibreDesk (ignorées en silence) : {sorted(manque)}")
|
||||
|
||||
def note_privee(self, uuid: str, html: str) -> dict | None:
|
||||
"""La seule écriture de message : private en dur, ni to, ni cc, ni bcc. Toute réponse qui n'est pas une note
|
||||
privée lève Garde."""
|
||||
if not self.ecrire:
|
||||
print(f"[simulation] note pour {uuid} :\n{html}")
|
||||
return None
|
||||
try:
|
||||
m = self._data("POST", f"/api/v1/conversations/{uuid}/messages",
|
||||
{"message": html, "private": True, "sender_type": "agent"})
|
||||
except urllib.error.HTTPError as e:
|
||||
raise Garde(f"note privée refusée ({e.code}) sur {uuid}") from e
|
||||
if not isinstance(m, dict) or m.get("private") is not True:
|
||||
raise Garde(f"la réponse de LibreDesk n'est pas une note privée ({uuid}) : {str(m)[:200]}")
|
||||
return m
|
||||
Reference in new issue
Block a user