Assistenza clienti
Collegare Zendesk a un agente IA autonomo
Zendesk centralizza i ticket dei clienti. Un agente Atako può smistarli, definirne le priorità e preparare risposte, con un accesso limitato alle azioni che Lei sceglie.
Workflow possibili
Smistamento e definizione delle priorità dei ticket in arrivo
L'agente elenca i nuovi ticket con list_tickets o search_tickets, ne legge il contenuto con get_ticket e get_ticket_comments, poi aggiorna stato, priorità e tag con update_ticket. Un ticket urgente di fatturazione non resta più fermo tre ore in una coda generica prima di raggiungere l'agente umano giusto, e i ticket minori vengono raggruppati invece di essere gestiti uno per uno nel disordine dal team di supporto.
Supporto di primo livello tramite macro e Help Center
Per le domande ricorrenti, l'agente consulta le macro esistenti con list_macros e gli articoli dell'Help Center con get_article, compone una risposta coerente con il tono dell'azienda, poi la aggiunge al ticket tramite update_ticket. I casi ambigui restano aperti per un agente umano invece di essere chiusi a torto per eccesso di fiducia in una risposta automatica mal calibrata per quel caso specifico.
Strutturazione delle organizzazioni clienti
All'arrivo di un nuovo cliente, l'agente crea l'organizzazione corrispondente con create_organization mappandone il dominio email, aggiorna note e tag con update_organization, e associa gli utenti interessati con update_user. Una base pulita facilita poi il filtraggio automatico dei ticket per account cliente, invece di smistare ogni richiesta una per una senza il contesto dell'account associato.
Azioni del connettore
list_tickets
Lettura. Elenca i ticket dell'account, ordinabili e filtrabili.
search_tickets
Lettura. Cerca ticket con la sintassi di query Zendesk.
get_ticket
Lettura. Recupera un ticket: stato, priorità, assegnatario.
get_ticket_comments
Lettura. Elenca i commenti di un ticket, in ordine cronologico.
list_macros
Lettura. Elenca le macro di risposta disponibili.
get_article
Lettura. Recupera un articolo dell'Help Center.
list_ticket_fields
Lettura. Elenca i campi ticket definiti nell'account.
create_ticket
Scrittura. Crea un ticket con un oggetto e un primo commento.
update_ticket
Scrittura. Cambia stato, priorità, tag, e aggiunge un commento.
create_organization
Scrittura. Crea un'organizzazione, con mapping dei domini email.
update_organization
Scrittura. Modifica nome, domini, note o tag di un'organizzazione.
create_user
Scrittura. Crea un utente, agente o cliente finale.
Prerequisiti
- Ruolo admin sull'azienda Atako per collegare l'integrazione.
- Sottodominio Zendesk dell'azienda (yourcompany.zendesk.com).
- Ruolo Agent come minimo lato Zendesk, Guide admin per l'Help Center.
- Accesso token API attivato in Admin Center prima di generare il token.
Come connettersi
- 1
Aprire Impostazioni → Integrazioni
Un admin sceglie Zendesk e inserisce il sottodominio dell'azienda.
- 2
Attivare e generare il token lato Zendesk
Admin Center → Apps and integrations → APIs → attivare Token access, poi creare un token.
- 3
Incollare email e token in Atako
Il campo richiede l'indirizzo dell'agente Zendesk e il token, separati da due punti.
- 4
Concedere l'accesso a un agente
Si scelgono le azioni precise per agente, con ambito di sola lettura o lettura e scrittura.
Perché collegare un agente autonomo a Zendesk
Zendesk centralizza le richieste dei clienti, con la loro cronologia, priorità, commenti e organizzazione di appartenenza. Un agente autonomo che vi ha accesso decide da solo, in base all'istruzione ricevuta, se cercare un ticket, definirne la priorità o preparare una risposta, tramite il tool calling.
La connessione avviene tramite una chiave API, un indirizzo email e un token combinati, con un sottodominio Zendesk proprio del Suo account, senza mai trasmettere la password dell'account Zendesk stesso.
Questo funzionamento si presta bene a un agente di triage del supporto o di automazione del supporto: gira in continuo, riceve i nuovi ticket man mano che arrivano e prepara il lavoro senza attendere che una persona apra l'account Zendesk al mattino. Zendesk fa parte dei connettori inclusi nel piano Standard, senza sovrapprezzo proprio di questa integrazione.
Limiti e buone pratiche
Zendesk sta progressivamente eliminando l'autenticazione tramite token API a favore di OAuth: i token inattivi da 30 giorni sono disattivati dalla fine di luglio 2026, la creazione di nuovi token sarà bloccata a fine ottobre 2026, e tutti i token smetteranno di funzionare il 30 aprile 2027 (annuncio Zendesk). Una connessione configurata oggi tramite token dovrà essere rivista prima di questa scadenza.
Il ruolo dell'account usato per generare il token definisce ciò che il token può fare lato Zendesk, oltre al grant Atako stesso: un ruolo Agent è sufficiente per i ticket, ma la gestione dell'Help Center richiede un ruolo Guide admin sull'account.
La documentazione non menziona un limite di velocità proprio del connettore, a differenza delle quote documentate sui canali email o webhook. Ogni chiamata, riuscita o rifiutata, resta consultabile nel registro di audit della pagina dell'agente.
Casi d'uso correlati
Integrazioni correlate
Domande frequenti
L'agente può chiudere o rispondere a un ticket senza convalida?
Se dispone del grant update_ticket con ambito di scrittura, sì, può cambiare lo stato e aggiungere un commento direttamente. Molte aziende limitano questo grant ai ticket semplici e lasciano i casi delicati a un agente umano.
Come si revoca l'accesso di Atako a Zendesk?
Da Impostazioni → Integrazioni, fare clic su Revoke sulla connessione Zendesk. Il token cifrato viene eliminato immediatamente, e tutti gli agenti che lo usavano perdono l'accesso subito dopo.
Zendesk abbandonerà l'autenticazione tramite token API?
Sì, Zendesk sta progressivamente eliminando i token API a favore di OAuth, con una disattivazione completa prevista per fine aprile 2027. Una connessione configurata oggi tramite token dovrà essere rivista prima di questa scadenza.
Cosa leggere dopo
Fonti
- Managing API token access to the Zendesk API · consultato il 4 settembre 2026
- Announcing the removal of API tokens as an authentication method for API requests · consultato il 4 settembre 2026
- Migrating from API tokens to OAuth access tokens · consultato il 4 settembre 2026
CTO di Atako
Questo contenuto è stato redatto dagli agenti IA di Atako, poi rivisto, corretto e approvato da Romain Laodicina, CTO di Atako.