otai-otobo-znuny
OTOBO and Znuny (OTRS fork) ticket system integration plugin for Open Ticket AI - automated helpdesk workflows.
Overview
otai-otobo-znuny provides comprehensive integration between Open Ticket AI and OTOBO/Znuny ticket systems. It supports both OTOBO and Znuny (formerly OTRS) instances, enabling automated ticket management and intelligent workflow automation.
Features
- 🎫 Full CRUD operations - Create, read, update, and delete tickets
- 🔍 Ticket search - Query tickets across queues and states
- 📝 Article management - Add notes and articles to tickets
- 🔄 Dual compatibility - Works with both OTOBO and Znuny
- 🔐 Secure authentication - Session-based or token authentication
- 🎯 Type-safe - Full Pydantic v2 validation
Installation
pip install otai-otobo-znuny
Configuration
Add the plugin to your Open Ticket AI configuration:
ticketsystem_service:
type: otobo_znuny
params:
webservice_url: "https://your-otobo.example.com/otrs/nph-genericinterface.pl/Webservice/GenericTicketConnectorREST"
username: "api-user"
password: "api-password"
Usage
Programmatic Usage
from otai_otobo_znuny import OTOBOZnunyTicketsystemService
from open_ticket_ai.models import UnifiedTicket, UnifiedEntity
# Initialize service
service = OTOBOZnunyTicketsystemService(
webservice_url="https://your-otobo.example.com/otrs/nph-genericinterface.pl/Webservice/GenericTicketConnectorREST",
username="api-user",
password="api-password"
)
# Create a ticket
ticket = await service.create_ticket(
UnifiedTicket(
subject="System Error",
body="Database connection failed",
queue=UnifiedEntity(name="System::Database"),
priority=UnifiedEntity(name="3 normal"),
customer=UnifiedEntity(name="admin@example.com")
)
)
With Open Ticket AI
from open_ticket_ai import OpenTicketAI
# Load configuration
app = OpenTicketAI.from_yaml("config.yml")
# Use the OTOBO/Znuny service
tickets = await app.ticketsystem.find_tickets(limit=10)
Requirements
- Python 3.13 or higher
- OTOBO or Znuny instance with REST webservice configured
- Valid API credentials
Documentation
- Full docs: open-ticket-ai.com
- OTOBO docs: doc.otobo.org
- Znuny docs: doc.znuny.org
Contributing
Contributions welcome! See the main repository for guidelines.
License
LGPL-2.1-only - See LICENSE.
Related Packages
open-ticket-ai- Core applicationotai-base- Base plugin frameworkotai-zammad- Zammad integrationotai-hf-local- Local AI model integration
Links
- Homepage: open-ticket-ai.com
- Repository: GitHub
- Issue Tracker: GitHub Issues
- PyPI: pypi.org/project/otai-otobo-znuny
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file otai_otobo_znuny-1.5.14.tar.gz.
File metadata
- Download URL: otai_otobo_znuny-1.5.14.tar.gz
- Upload date:
- Size: 10.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.9.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b57383b0d3910d776c26025936d63253b74b38c3d8777200f01eacc5a0c63276
|
|
| MD5 |
cbd1dfcb0c3528f6283da65cbd906815
|
|
| BLAKE2b-256 |
5eeeaf58659fb9dd0e9bc66b33f1d1a2c0a53ede7708e50d53325c411b6ace51
|
File details
Details for the file otai_otobo_znuny-1.5.14-py3-none-any.whl.
File metadata
- Download URL: otai_otobo_znuny-1.5.14-py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.9.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b8d3c5de58434670b801e29a2680f98bc676cbe9474676ebabb7aba6da25ec1c
|
|
| MD5 |
15cf545d707635422f9b3ea8afd4d193
|
|
| BLAKE2b-256 |
5202420ded05f3b4ca3c63d368d4a16935aabec74f05c9b294741dc3a16374d8
|
