Come Integrare Zammad in un’Applicazione Delphi o FireMonkey Tramite le API
Zammad è una potente piattaforma di ticketing open source che consente di gestire facilmente le richieste di assistenza. Grazie alle sue API RESTful, è possibile integrarlo in applicazioni esterne, tra cui applicazioni Delphi o FireMonkey. In questo articolo vedremo come interagire con Zammad tramite le sue API per creare un utente e visualizzare una lista di ticket direttamente all’interno di un’applicazione Delphi.
Prerequisiti
- Ambiente di sviluppo: Delphi o FireMonkey
- Zammad: Una piattaforma Zammad installata e configurata con accesso alle API.
- Token API: Un token di accesso API valido, generabile direttamente dalla tua interfaccia Zammad (Impostazioni > Integrazioni > Token API).
Strumenti per interagire con le API
Delphi offre componenti come THTTPClient per effettuare richieste HTTP, ideali per comunicare con le API REST. Questi componenti sono semplici da usare e permettono di configurare facilmente le intestazioni e i parametri delle richieste.
1. Creare un Utente su Zammad tramite API
L’endpoint API per creare un utente su Zammad è /api/v1/users. La richiesta richiede dati dell’utente come nome, email, password e ruoli.
Codice Delphi per Creare un Utente
Per questo esempio, creiamo una funzione CreateZammadUser che accetta nome, email e password come parametri e invia una richiesta POST a Zammad.
Questa funzione costruisce una richiesta POST e aggiunge un’intestazione di autorizzazione con il token API. Se la risposta ha un codice 201 (Created), l’utente è stato creato con successo.
2. Visualizzare la Lista dei Ticket
Per ottenere la lista dei ticket, utilizziamo l’endpoint /api/v1/tickets. Questa richiesta può essere effettuata con un metodo GET.
Codice Delphi per Visualizzare la Lista dei Ticket
La funzione GetZammadTickets effettua una richiesta GET per recuperare la lista dei ticket e li visualizza in una TStringList o in un controllo simile.
Questa funzione invia una richiesta GET, recupera il JSON con la lista dei ticket e lo converte in un elenco leggibile.
3. Creare un Ticket su Zammad tramite API
L’endpoint API per creare un ticket su Zammad è /api/v1/tickets. Per creare un ticket, sono necessari alcuni dati essenziali come titolo, testo del messaggio, stato del ticket, priorità, e il cliente associato (generalmente identificato tramite ID utente).
Codice Delphi per Creare un Ticket
Di seguito, ecco una funzione chiamata CreateZammadTicket che accetta il titolo del ticket, il messaggio di descrizione e la mail del mittente. Questa funzione invia una richiesta POST a Zammad per creare un nuovo ticket.
Gestione degli Errori
In ogni chiamata API, è essenziale controllare il StatusCode della risposta per rilevare eventuali errori e reagire di conseguenza. Utilizzando componenti come THTTPClient, è possibile implementare facilmente messaggi di errore basati sui codici di risposta.
In caso di eventuali errori, nel corpo della risposta verrà mostrata la motivazione. Ad esempio se avessimo configurato in Zammad un oggetto custom obbligatorio, ci verrà segnalato che nel payload di creazione ticket è necessario indicare l’oggetto mancante.
Con le API di Zammad, è possibile creare un’esperienza di supporto clienti completa all’interno di un’applicazione Delphi o FireMonkey. L’utilizzo delle chiamate API consente di interagire direttamente con la piattaforma Zammad per creare utenti, visualizzare e gestire ticket e altro ancora.
Contattaci
Se stai cercando un partner per integrare Zammad nei tuoi sistemi aziendali, KD Software può offrirti il supporto necessario. Che si tratti di un sistema gestionale, ERP, CRM o di una piattaforma di e-commerce, KD Software può guidarti passo passo, garantendo che tutte le tue esigenze siano soddisfatte.
Grazie all’esperienza di KD Software nell’implementazione e personalizzazione di soluzioni software, avrai un’integrazione fluida e ottimizzata di Zammad nei tuoi processi aziendali. KD Software si occupa di tutto, dal setup iniziale fino all’analisi dei dati e al supporto post-implementazione, assicurando che il sistema funzioni perfettamente per la tua azienda.
Contatta KD Software per un’integrazione su misura e per scoprire come ottimizzare il tuo sistema di ticketing in sinergia con gli altri strumenti aziendali.
Puoi trovare un progetto di esempio su gitHub qui
