Integración con Zapier

Conecta Visiono a más de 5,000 apps con la plataforma de automatización sin código de Zapier.

Descripción General

Zapier te permite crear flujos de trabajo automatizados (Zaps) que se activan cuando se envían fotos a Visiono. Conecta con CRMs, herramientas de gestión de proyectos, plataformas de comunicación y más.

Prerrequisitos

• Cuenta de Visiono con acceso a API
• Cuenta de Zapier (gratuita o de pago)
• Clave de API de Visiono

Pasos de Configuración

1. Crear un Nuevo Zap

1. Inicia sesión en Zapier
2. Haz clic en Create Zap
3. Busca Webhooks by Zapier
4. Selecciona Catch Hook como disparador

2. Configurar el Webhook

1. Zapier generará una URL de webhook única
2. Copia esta URL (se ve como https://hooks.zapier.com/hooks/catch/...)
3. Mantén la pestaña de Zapier abierta

3. Añadir Webhook a Visiono

1. Ve a Configuración del Espacio de Trabajo → Webhooks
2. Haz clic en Añadir Webhook
3. Pega la URL del webhook de Zapier
4. Selecciona eventos a disparar:
   • photo_request.submitted - Cuando todas las fotos son enviadas
   • photo_submission.created - Cuando llega un nuevo envío
5. Guarda el webhook

4. Probar la Conexión

1. En Zapier, haz clic en Test trigger
2. Envía una foto de prueba en Visiono
3. Zapier debería recibir los datos del webhook
4. Haz clic en Continue una vez que se reciban los datos

5. Añadir Acciones

Ahora añade qué sucede cuando llegan las fotos:

Acciones Populares	Caso de Uso
Gmail	Enviar email con enlaces de fotos
Slack	Notificar canal del equipo
Google Sheets	Registrar envíos en hoja de cálculo
Trello	Crear tarjeta con fotos
Salesforce	Actualizar registro de contacto
HubSpot	Añadir a línea de tiempo del contacto

Ejemplos de Zaps

Foto a Google Sheets

Registra cada envío en una hoja de cálculo:

1. Disparador: Webhooks by Zapier (Catch Hook)
2. Acción: Google Sheets → Create Spreadsheet Row

Mapea los campos:

Columna de Hoja	Datos del Webhook
Fecha	{{submitted_at}}
Enlace Permanente	{{smart_link_slug}}
Conteo de Fotos	{{photos_count}}
URL Primera Foto	{{photos__1__url}}

Notificar Slack en Envío

Envía notificación al equipo:

1. Disparador: Webhooks by Zapier
2. Acción: Slack → Send Channel Message

Plantilla de mensaje:

📸 ¡Nuevas fotos recibidas!
Enlace Permanente: {{smart_link_name}}
Fotos: {{photos_count}}
Ver: {{dashboard_url}}

Crear Tarjeta de Trello

Añade envío al tablero del proyecto:

1. Disparador: Webhooks by Zapier
2. Acción: Trello → Create Card

Configuración de la tarjeta:

• Nombre: Fotos de {{submitter_name}}
• Descripción: URLs de fotos y metadatos
• Etiquetas: Basadas en tags

Payload del Webhook

Zapier recibe esta estructura de datos:

{
  "event": "submission.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "submission_id": "sub_abc123",
    "smart_link": {
      "id": "pl_xyz789",
      "slug": "inspeccion-vehiculo",
      "name": "Inspección de Vehículo"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Vista Frontal"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Juan Pérez",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Zaps de Múltiples Pasos

Encadena múltiples acciones:

1. Paso 1: Recibir webhook
2. Paso 2: Descargar fotos (Formatter)
3. Paso 3: Subir a Google Drive
4. Paso 4: Enviar email con enlaces de Drive
5. Paso 5: Actualizar registro de CRM

Filtrado

Añade filtros para ejecutar acciones condicionalmente:

Filtro	Condición	Ejemplo
Conteo de fotos	Mayor que	Solo si 5+ fotos
Enlace Permanente	Contiene	Solo solicitudes de "daño"
Tag	Igual a	Solo etiquetadas "urgente"

Solución de Problemas

Webhook No Recibe Datos

1. Verifica que la URL del webhook sea correcta en Visiono
2. Comprueba que el webhook esté habilitado (estado verde)
3. Prueba con un nuevo envío
4. Revisa el Historial de Tareas de Zapier por errores

Campos de Datos Faltantes

1. Asegúrate de haber probado con datos reales
2. Vuelve a probar el disparador en Zapier
3. Verifica que el mapeo de campos use rutas correctas

Zap No Se Ejecuta

1. Verifica que el Zap esté encendido (ON)
2. Revisa límites del plan de Zapier
3. Revisa el Historial de Tareas por errores
4. Asegura que los eventos del webhook coincidan con el disparador

Mejores Prácticas

Convención de Nombres

Nombra Zaps descriptivamente:

• ✓ Visiono → Slack: Nuevas Fotos de Daños
• ✓ Fotos de Vehículo → Google Drive + Email
• ✗ Mi Zap 1

Manejo de Errores

1. Habilita notificaciones de error de Zapier
2. Añade pasos de Formatter para limpieza de datos
3. Usa Paths para lógica condicional
4. Prueba con casos extremos

Rendimiento

• Usa Filtros para reducir ejecuciones innecesarias
• Agrupa acciones donde sea posible
• Considera límites de tareas del plan de Zapier

Recursos Relacionados

• Webhooks - Configuración de eventos
• Referencia de API - Acceso directo a API
• Integración con Make - Automatización alternativa
• Integración con n8n - Opción auto-alojada