ExternalReference – Znuny Ticket Operation for External System Integration

by Znuny GmbHcompany

Integrate external systems with Znuny using a single API endpoint for ticket operations based on external reference numbers.

The ExternalReference add-on extends the Znuny GenericInterface with a specialized operation for ticket integration. It solves the common challenge where external systems (such as CRM or ERP solutions) need to perform actions on tickets but only know their own reference number rather than the internal Znuny TicketID.\n\nThe 'Ticket::ExternalReference' operation checks incoming requests to see if a ticket with the provided reference already exists in a defined dynamic field. If a match is found and the ticket is in a permitted state, it is updated. Otherwise, a new ticket is created, and the reference is stored for future updates. This significantly reduces complexity on the third-party system's side, as it no longer needs to maintain a mapping of Znuny-specific IDs.

Features

  • Single Endpoint Integration

    Allows ticket creation and updates via a single API endpoint (Ticket::ExternalReference) without the external system needing to know internal Znuny IDs.

  • Automatic Create-or-Update Logic

    Automatically determines whether to create a new ticket or update an existing one based on the external reference and configurable state conditions.

  • Dynamic Field Storage

    Automatically stores the external reference number in a configurable dynamic field for cross-system tracking.

  • Flexible Authentication

    Supports agent login, customer login, and session-based authentication for maximum flexibility with third-party integrations.

Related packages