Integración con Zendesk

Adjunta fotos de clientes directamente a tickets de soporte.

Descripción General

Conecta Visiono a Zendesk para adjuntar automáticamente envíos de fotos a tickets de soporte al cliente. Cuando los clientes envían fotos, pueden vincularse a tickets existentes o crear nuevos.

Prerrequisitos

• Cuenta de Visiono con acceso a API
• Cuenta de Zendesk (cualquier plan)
• Clave de API de Visiono
• Token de API de Zendesk

Métodos de Integración

Método	Mejor Para
Zapier	Configuración rápida, sin código
Make	Flujos de trabajo complejos
API Directa	Integración personalizada

Configuración con Zapier

1. Crear Zap

1. Inicia sesión en Zapier
2. Crea nuevo Zap
3. Disparador: Webhooks by Zapier → Catch Hook
4. Copia la URL del webhook

2. Configurar Visiono

1. Añade la URL del webhook en la configuración de Visiono
2. Selecciona eventos: submission.created
3. Guarda la configuración

3. Añadir Acción de Zendesk

Elige entre acciones:

Acción	Caso de Uso
Create Ticket	Nuevo ticket con fotos
Update Ticket	Añadir fotos a existente
Add Comment	Adjuntar como comentario

4. Mapear Campos

Crear Ticket:

Subject: Fotos de {{submitter_name}}
Description: {{photos_count}} fotos enviadas
Tags: visiono, photos
Requester Email: {{submitter_email}}

Actualizar Ticket:

Ticket ID: {{unique_field}}
Comment: Nuevas fotos enviadas: {{photo_urls}}
Public: false

Ejemplos de Flujos de Trabajo

Nuevo Ticket con Fotos

Cuando llegan fotos, crea ticket de soporte:

1. Webhook recibe envío
2. Zendesk crea ticket
3. Loop recorre las fotos
4. Zendesk añade cada foto como adjunto

Actualizar Ticket Existente

Vincula fotos a ticket usando identificador:

1. El cliente incluye ID de ticket en campo único
2. Webhook recibe envío
3. Zendesk busca el ticket
4. Zendesk añade nota interna con fotos

Escalado Activado por Fotos

Escala según contenido de fotos:

1. Webhook recibe envío
2. Filter verifica etiqueta "daño"
3. Zendesk actualiza prioridad del ticket
4. Zendesk asigna a equipo especialista

Mapeo de Datos

Visiono → Zendesk

Campo Visiono	Campo Zendesk
submitter_name	Nombre del solicitante
submitter_email	Email del solicitante
unique_field	ID de ticket o ID externo
photos[].url	URLs de adjuntos
smart_link.name	Asunto del ticket
submitted_at	Marca de tiempo del comentario

Campos de Ticket

Mapea campos personalizados de ticket:

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

Adjuntos de Fotos

Como Adjuntos de Ticket

Añade fotos directamente a tickets:

1. Descarga foto desde URL de Visiono
2. Sube a la API de adjuntos de Zendesk
3. Referencia en ticket/comentario

Como Enlaces en Comentarios

Incluye URLs de fotos en comentarios:

El cliente envió {{photos_count}} fotos:

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

Ver todas: {{dashboard_url}}

Como Enlaces Externos

Enlaza al panel de Visiono:

Se han enviado fotos.
Ver en Visiono: {{submission_url}}

Flujos de Trabajo Avanzados

Actualizaciones de Múltiples Tickets

Actualiza múltiples tickets desde un envío:

1. Parsea IDs de tickets del campo único
2. Recorre cada ID
3. Actualiza cada ticket con fotos

Creación Automática de Tickets

Crea tickets para Enlaces Permanentes específicos:

1. Configura webhook para Enlace Permanente específico
2. Mapea datos del envío a campos del ticket
3. Establece asignado y prioridad por defecto

Enrutamiento por Calidad de Fotos

Enruta según conteo de fotos:

IF photos_count < 3:
  → Solicitar más fotos
ELSE IF photos_count >= 3:
  → Procesar normalmente

Solución de Problemas

Fotos No Se Adjuntan

1. Verifica permisos de API de Zendesk
2. Confirma que URLs de archivos sean accesibles
3. Comprueba límites de tamaño de adjuntos

Ticket No Encontrado

1. Verifica formato de ID de ticket
2. Comprueba estado del ticket (no cerrado)
3. Asegura que la API tenga acceso al ticket

Tickets Duplicados

1. Añade filtro de deduplicación
2. Busca antes de crear
3. Usa identificadores únicos

Mejores Prácticas

Organización de Tickets

• Usa etiquetas consistentes: visiono, photo-submission
• Establece prioridades apropiadas
• Asigna al grupo correcto

Gestión de Fotos

• Enlaza al panel de Visiono
• No dupliques archivos grandes
• Incluye metadatos de fotos

Experiencia del Cliente

• Envía confirmación después del envío
• Actualiza estado del ticket automáticamente
• Notifica cuando las fotos sean revisadas

Consideraciones de Seguridad

• Usa notas internas para fotos sensibles
• Restringe acceso a fotos solo a agentes
• Audita adjuntos de fotos

Recursos Relacionados

• Webhooks - Configuración de eventos
• Integración con Zapier - Plataforma de automatización
• Integración con Make - Flujos de trabajo visuales
• Referencia de API - API directa