Vai al contenuto principale

Integrazione con Zoho Desk - Guida alla configurazione

Collega il tuo account Zoho Desk a Goodweek per gestire ticket di assistenza, contatti, agenti e reparti direttamente dal tuo spazio di lavoro IA.

A
Scritto da Antoine Stempien

Collega il tuo account Zoho Desk a Goodweek per gestire ticket di assistenza, contatti, agenti e reparti direttamente dal tuo spazio di lavoro IA.

ℹ️ Nota sulla governance

Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Zoho Desk, garantendo l'allineamento con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.

📋 Prerequisiti

Prima che qualsiasi utente possa vedere e collegare l'integrazione con Zoho Desk, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Configurazione amministratore

L'integrazione con Zoho Desk utilizza OAuth 2.0 e non richiede alcuna approvazione a livello di amministratore all'interno di Zoho prima che gli utenti possano collegarsi.

⚠️ Data center regionali

Zoho gestisce data center in più regioni (USA, UE, AU, IN, JP). Durante il flusso di connessione OAuth, assicurati di accedere con l'account associato al tuo data center regionale corretto.

Connessione utente

  1. In Goodweek, vai su Integrazioni.

  2. Trova Zoho Desk e fai clic su Collega.

  3. Verrai reindirizzato a Zoho, dove ti verrà chiesto di accedere e autorizzare l'accesso.

  4. Fai clic su Accetta per concedere l'accesso e tornare a Goodweek.

Note importanti

  • Ogni utente deve collegare il proprio account individualmente.

  • Goodweek può accedere solo ai ticket, ai contatti e ai reparti che il tuo profilo Zoho Desk individuale ha il permesso di visualizzare.

  • Puoi revocare l'accesso di Goodweek in qualsiasi momento da Zoho Desk → Configurazione → Developer Space → App OAuth → Composio → Revoca.


Strumenti disponibili

Strumento

Descrizione

Tipo

List Tickets

Elenca i ticket di assistenza con filtri e paginazione opzionali.

Lettura

Get Ticket

Recupera i dettagli completi di un ticket di assistenza specifico tramite il suo ID.

Lettura

Get Ticket Latest Thread

Recupera il thread di conversazione più recente di un ticket.

Lettura

Get Ticket Thread

Recupera un thread di conversazione specifico all'interno di un ticket tramite l'ID del thread.

Lettura

List Ticket Conversations

Elenca tutti i thread di conversazione di un ticket specifico.

Lettura

Get Ticket Resolution

Recupera la nota di risoluzione registrata su un ticket specifico.

Lettura

Create Ticket

Crea un nuovo ticket di assistenza con oggetto, descrizione, reparto e dettagli del richiedente.

Scrittura

Update Ticket

Aggiorna lo stato, la priorità, l'assegnatario, la descrizione o altri campi di un ticket esistente.

Scrittura

Download Ticket Attachment

Scarica un allegato da un ticket di Zoho Desk tramite l'ID dell'allegato.

Lettura

Upload Ticket Attachment

Carica un allegato su un ticket specifico di Zoho Desk.

Scrittura

List Contacts

Elenca i contatti in Zoho Desk con filtri e paginazione opzionali.

Lettura

Get Contact

Recupera i dettagli completi di un contatto specifico di Zoho Desk tramite il suo ID.

Lettura

Get Contacts By IDs

Recupera più contatti tramite i relativi ID in un'unica richiesta.

Lettura

Create Contact

Crea un nuovo contatto in Zoho Desk con nome, email e altri dettagli.

Scrittura

List Contact Accounts

Elenca gli account associati a un contatto specifico di Zoho Desk.

Lettura

Update Account

Aggiorna le informazioni di un account esistente di Zoho Desk.

Scrittura

List Agents

Elenca tutti gli agenti dell'organizzazione Zoho Desk con filtri e paginazione opzionali.

Lettura

Get Agent

Recupera i dettagli completi di un agente specifico di Zoho Desk tramite il suo ID.

Lettura

Get Agents Count

Restituisce il numero totale di agenti, facoltativamente filtrato per stato.

Lettura

List Departments

Elenca tutti i reparti dell'organizzazione Zoho Desk.

Lettura

Get Department

Recupera i dettagli completi di un reparto specifico tramite il suo ID.

Lettura

Get Departments Count

Restituisce il numero totale di reparti.

Lettura

List Teams in Department

Elenca tutti i team all'interno di un reparto specifico di Zoho Desk.

Lettura

List Views

Elenca tutte le viste dei ticket (filtri salvati) dell'organizzazione Zoho Desk.

Lettura

List Roles

Elenca tutti i ruoli configurati in Zoho Desk.

Lettura

List Organizations

Elenca tutte le organizzazioni a cui appartiene l'utente corrente.

Lettura

Search

Cerca tra i moduli di Zoho Desk, inclusi ticket, account, contatti e attività, per parola chiave.

Lettura

Update Many Tasks

Aggiorna più attività in un'unica chiamata API.

Scrittura

Casi d'uso

  • Crea e aggiorna i ticket di assistenza dalle conversazioni. Registra nuovi ticket di assistenza clienti in Zoho Desk direttamente da una conversazione Goodweek — con oggetto, descrizione, reparto e priorità — senza cambiare strumento.

  • Controlla lo stato e i thread dei ticket. Recupera i ticket aperti, controlla l'ultimo thread di un ticket specifico o consulta la risoluzione di un ticket da Goodweek per avere una rapida panoramica dei problemi dei clienti.

  • Cerca tra ticket, contatti e account. Trova record di assistenza specifici tramite parola chiave direttamente da Goodweek, senza navigare nell'interfaccia di Zoho Desk.

  • Gestisci i contatti collegati ai ticket. Cerca o crea contatti Zoho Desk direttamente da una conversazione per assicurarti che i ticket siano associati al record cliente corretto.


Risoluzione dei problemi

Connesso, ma vengono visualizzati dati dell'organizzazione sbagliata

Assicurati di aver eseguito l'accesso con l'account Zoho associato al tuo data center regionale corretto durante il flusso di connessione. Se necessario, disconnetti e riconnetti.

L'integrazione non è visibile in Goodweek

Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione con Zoho Desk dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Riferimenti

Hai ricevuto la risposta alla tua domanda?