Einstieg

OTOBO Python SDK installieren und das erste Ticket über die GenericInterface REST API erstellen.

Einstieg — OTOBO Python SDK

Webservice erforderlich. pip install otobo allein reicht nicht. Zuerst GenericInterface REST einrichten — siehe Webservice einrichten.

Bash
pip install otobo
Python
from otobo import OTOBOClient, BasicAuth, ClientConfig, TicketCreate, TicketOperation

Voraussetzungen

  • OTOBO mit aktivem GenericInterface und konfiguriertem REST-Webservice
  • Agent-Login mit Webservice-Berechtigung
  • Python 3.11+

Ohne Webservice: Webservice einrichten — otobo-cli setup-system auf dem OTOBO-Host.

OTOBO-Begriffe

OTOBO-BegriffBedeutung für dieses SDK
WebserviceBenannte REST-Schnittstelle; ClientConfig.webservice_name muss übereinstimmen
OperationEine Ticket-Aktion; Eintrag in operation_url_map
Agent-LoginBenutzer für BasicAuth
QueueTicket-Eingang; z. B. IdName(name="Raw")
Dynamic FieldBenutzerdefiniertes Feld; als dict[str, str] übergeben

Konfiguration

Python
config = ClientConfig(
base_url="https://your-otobo-server",
webservice_name="PythonClientWebService",
operation_url_map={
TicketOperation.CREATE: "ticket-create",
TicketOperation.GET: "ticket-get",
TicketOperation.SEARCH: "ticket-search",
TicketOperation.UPDATE: "ticket-update",
},
)
client = OTOBOClient(config)
client.login(BasicAuth(user_login="agent1", password="secret"))

Ticket anlegen

Python
import asyncio
from otobo import Article, IdName, TicketCreate
async def main() -> None:
ticket = TicketCreate(
title="Neue Anfrage",
queue=IdName(name="Raw"),
article=Article(subject="Hallo", body="Tickettext"),
)
async with client:
created = await client.create_ticket(ticket)
print(created.id)
asyncio.run(main())

Weiterführend