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.

open-ticket-ai - Core application
otai-base - Base plugin framework
otai-zammad - Zammad integration
otai-hf-local - Local AI model integration

Metadata

Release files for otai-otobo-znuny 1.5.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for otai-otobo-znuny 1.5.14
File	Size	Uploaded
otai_otobo_znuny-1.5.14.tar.gz	10.9 kB	Nov 12, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for otai-otobo-znuny 1.5.14
File	Interpreter	ABI	Platform	Reset
otai_otobo_znuny-1.5.14-py3-none-any.whl 7.4 kB Nov 12, 2025	Python 3	none	any	Details

Total release size: 18.3 kB

Release files / otai_otobo_znuny-1.5.14.tar.gz

Download URL	otai_otobo_znuny-1.5.14.tar.gz
Size	10.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`b57383b0d3910d776c26025936d63253b74b38c3d8777200f01eacc5a0c63276`
BLAKE2b-256 checksum How to use checksums	`5eeeaf58659fb9dd0e9bc66b33f1d1a2c0a53ede7708e50d53325c411b6ace51`
Upload date	Nov 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.9.8`

Release files / otai_otobo_znuny-1.5.14-py3-none-any.whl

Download URL	otai_otobo_znuny-1.5.14-py3-none-any.whl
Size	7.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b8d3c5de58434670b801e29a2680f98bc676cbe9474676ebabb7aba6da25ec1c`
BLAKE2b-256 checksum How to use checksums	`5202420ded05f3b4ca3c63d368d4a16935aabec74f05c9b294741dc3a16374d8`
Upload date	Nov 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.9.8`