Integrazione Zendesk

Allega foto clienti direttamente ai ticket di supporto.

Panoramica

Connetti Visiono a Zendesk per allegare automaticamente gli invii foto ai ticket di supporto clienti. Quando i clienti inviano foto, possono essere collegati a ticket esistenti o crearne di nuovi.

Prerequisiti

• Account Visiono con accesso API
• Account Zendesk (qualsiasi piano)
• Chiave API da Visiono
• Token API Zendesk

Metodi di Integrazione

Metodo	Migliore Per
Zapier	Setup rapido, nessun codice
Make	Workflow complessi
API Diretta	Integrazione personalizzata

Setup Zapier

1. Creare Zap

1. Accedi a Zapier
2. Crea nuovo Zap
3. Trigger: Webhooks by Zapier → Catch Hook
4. Copia URL webhook

2. Configurare Visiono

1. Aggiungi URL webhook nelle impostazioni Visiono
2. Seleziona eventi: submission.created
3. Salva configurazione

3. Aggiungere Azione Zendesk

Scegli tra le azioni:

Azione	Caso d'Uso
Create Ticket	Nuovo ticket con foto
Update Ticket	Aggiungi foto a esistente
Add Comment	Allega come commento ticket

4. Mappare Campi

Create Ticket:

Subject: Foto da {{submitter_name}}
Description: {{photos_count}} foto inviate
Tags: visiono, photos
Requester Email: {{submitter_email}}

Update Ticket:

Ticket ID: {{unique_field}}
Comment: Nuove foto inviate: {{photo_urls}}
Public: false

Esempi Workflow

Nuovo Ticket con Foto

Quando arrivano foto, crea ticket supporto:

1. Webhook riceve invio
2. Zendesk crea ticket
3. Loop attraverso foto
4. Zendesk aggiunge ogni foto come allegato

Aggiornare Ticket Esistente

Collega foto a ticket usando identificatore:

1. Il cliente include ID ticket nel campo univoco
2. Webhook riceve invio
3. Zendesk cerca ticket
4. Zendesk aggiunge nota interna con foto

Escalation Attivata da Foto

Escala in base al contenuto foto:

1. Webhook riceve invio
2. Filter controlla tag "danno"
3. Zendesk aggiorna priorità ticket
4. Zendesk assegna a team specialista

Mapping Dati

Visiono → Zendesk

Campo Visiono	Campo Zendesk
submitter_name	Nome richiedente
submitter_email	Email richiedente
unique_field	ID ticket o ID esterno
photos[].url	URL allegati
smart_link.name	Oggetto ticket
submitted_at	Timestamp commento

Campi Ticket

Mappa campi ticket personalizzati:

custom_field_12345: {{smart_link_slug}}
custom_field_67890: {{photos_count}}

Allegati Foto

Come Allegati Ticket

Aggiungi foto direttamente ai ticket:

1. Scarica foto da URL Visiono
2. Carica su API allegati Zendesk
3. Riferisci in ticket/commento

Come Link Commento

Includi URL foto nei commenti:

Il cliente ha inviato {{photos_count}} foto:

{{#each photos}}
- {{slot_name}}: {{url}}
{{/each}}

Visualizza tutto: {{dashboard_url}}

Come Link Esterni

Collega alla dashboard Visiono:

Sono state inviate delle foto.
Visualizza in Visiono: {{submission_url}}

Workflow Avanzati

Aggiornamenti Multi-Ticket

Aggiorna più ticket da un invio:

1. Estrai ID ticket dal campo univoco
2. Fai loop attraverso ogni ID
3. Aggiorna ogni ticket con foto

Creazione Ticket Automatica

Crea ticket per Link Permanenti specifici:

1. Configura webhook per Link Permanente specifico
2. Mappa dati invio a campi ticket
3. Imposta assegnatario e priorità default

Routing Qualità Foto

Instrada in base a conteggio foto:

IF photos_count < 3:
  → Richiedi altre foto
ELSE IF photos_count >= 3:
  → Elabora normalmente

Risoluzione Problemi

Foto Non Si Allegano

1. Controlla permessi API Zendesk
2. Verifica che URL file siano accessibili
3. Conferma limiti dimensione allegati

Ticket Non Trovato

1. Verifica formato ID ticket
2. Controlla stato ticket (non chiuso)
3. Assicura che API abbia accesso ticket

Ticket Duplicati

1. Aggiungi filtro deduplicazione
2. Cerca prima di creare
3. Usa identificatori univoci

Best Practice

Organizzazione Ticket

• Usa tag consistenti: visiono, photo-submission
• Imposta priorità appropriate
• Assegna al gruppo corretto

Gestione Foto

• Collega alla dashboard Visiono
• Non duplicare file grandi
• Includi metadati foto

Esperienza Cliente

• Invia conferma dopo invio
• Aggiorna stato ticket automaticamente
• Notifica quando foto sono revisionate

Considerazioni Sicurezza

• Usa note interne per foto sensibili
• Restringi accesso foto agli agenti
• Verifica allegati foto

Risorse Correlate

• Webhook - Setup eventi
• Integrazione Zapier - Piattaforma automazione
• Integrazione Make - Workflow visuali
• Riferimento API - API diretta