Tickets

Tickets allow you to easily track issues and service requests from your clients.

There are currently two main views for tickets

• All tickets (from all clients)

• Client-specific tickets - accessed via a client's view/page

• Subject
• Ticket description
• Client & Contact
• Priority (low/med/high)
• Status (open, working, hold, auto-close, closed)
• Related asset (future feature is to allow multiple assets)

• Agent Assignment/Re-assignment

• Custom ticket prefix

• Time tracking

• Email integration

• Private/internal notes

• Merging

• Scheduled tickets

• Invoicing

• Auto-close tickets

Registered client contacts can create/update tickets via e-mail.

• Configure at: Settings > Mail:
  • IMAP Host
  • IMAP Port
  • IMAP Encryption
• Turn on: Settings > Ticket > Email-to-ticket parsing
• Add a cron job to run email_parser_cron.php every min

• Only supports basic authentication (no oAuth) for now - a “nice to have” in the future
• The IMAP connection uses the same SMTP Username/Password configured for sending emails - should be configurable in future
• Emails from unregistered contacts without a ticket reference are ignored - we plan to auto-create contacts based on a client domain in future

/api/v1/tickets

Read - Retrieve ticket information (/read.php) (GET)

• Default / No params - Returns all tickets
• ticket_id - Specific ticket ID from the ITFlow database (may, but usually shouldn't, differ from ticket number)

Invoke-RestMethod -Uri "http://127.0.0.1/itflow/api/v1/tickets/read.php?api_key=3iVeTipINS9eDGpm&ticket_id=3" | ConvertTo-Json
{
    "success":  "True",
    "count":  1,
    "data":  [
                 {
                     "0":  "3",
                     "ticket_id":  "3",
                     "1":  "TCK-",
                     "ticket_prefix":  "TCK-",
                     "2":  "3",
                     "ticket_number":  "3",
                     "3":  null,
                     "ticket_category":  null,
                     "4":  "Computer broken",
                     "ticket_subject":  "Computer broken",

[...]