Integración con Make
Crea flujos de trabajo de automatización visual con Make (anteriormente Integromat).
Descripción General
Make ofrece una interfaz visual de arrastrar y soltar para crear escenarios de automatización complejos. Conecta los envíos de fotos de Visiono a tus herramientas de negocio con potentes capacidades de transformación de datos.
Prerrequisitos
- Cuenta de Visiono con acceso a API
- Cuenta de Make (nivel gratuito disponible)
- Clave de API de Visiono
Pasos de Configuración
1. Crear un Nuevo Escenario
- Inicia sesión en Make
- Haz clic en Create a new scenario
- Haz clic en el botón + para añadir un módulo
2. Añadir Módulo de Webhook
- Busca Webhooks
- Selecciona Custom webhook
- Haz clic en Add para crear un nuevo webhook
- Nómbralo (ej. "Fotos de Visiono")
- Copia la URL generada
3. Configurar en Visiono
- Ve a Configuración del Espacio de Trabajo → Webhooks
- Haz clic en Añadir Webhook
- Pega la URL del webhook de Make
- Selecciona eventos:
photo_submission.createdphoto_request.submitted
- Guarda
4. Determinar Estructura de Datos
- En Make, haz clic en Run once
- Envía una foto de prueba en Visiono
- Make captura la estructura de datos automáticamente
- Detén el escenario
5. Añadir Módulos de Acción
Conecta módulos adicionales para procesar fotos:
| Módulo | Función |
|---|---|
| HTTP | Descargar archivos de fotos |
| Google Drive | Subir a almacenamiento en la nube |
| Enviar notificaciones | |
| Slack | Mensajería de equipo |
| Airtable | Registros de base de datos |
| Notion | Creación de páginas |
Constructor Visual de Flujos
La interfaz visual de Make muestra el flujo de datos:
[Webhook] → [Router] → [Google Drive] → [Email]
↘ [Slack]
↘ [Airtable]Uso de Routers
Divide flujos de trabajo basados en condiciones:
- Añade módulo Router después del webhook
- Crea múltiples rutas
- Añade filtros a cada ruta:
- Ruta 1: Fotos > 5 → Revisión completa
- Ruta 2: Tiene etiqueta "daño" → Notificación urgente
- Ruta 3: Por defecto → Procesamiento estándar
Ejemplos de Escenarios
Respaldo de Fotos en la Nube
Guarda fotos automáticamente en Google Drive:
Módulos:
- Webhooks → Custom webhook
- Iterator → Recorre el array de fotos
- HTTP → Get file (descarga foto)
- Google Drive → Upload file
Configuración:
Iterator: {{data.photos}}
HTTP URL: {{item.url}}
Drive Folder: /Visiono/{{data.smart_link.slug}}/
Filename: {{item.slot_name}}_{{now}}.jpgActualización de CRM con Fotos
Añade fotos a registros de clientes:
Módulos:
- Webhooks → Recibir envío
- HubSpot → Buscar contacto por email
- HubSpot → Añadir nota con enlaces de fotos
- Slack → Notificar equipo de ventas
Flujo de Revisión de Calidad
Enruta fotos para revisión:
Módulos:
- Webhooks → Recibir envío
- Router → Basado en conteo de fotos
- Ruta A (< 3 fotos): Solicitar más
- Ruta B (3+ fotos): Procesar normalmente
- Email → Enviar mensaje apropiado
Mapeo de Datos
Accede a datos del webhook usando notación de puntos de Make:
| Campo | Ruta |
|---|---|
| Tipo de evento | event |
| ID de Enlace Permanente | data.smart_link.id |
| Nombre de Enlace Permanente | data.smart_link.name |
| URL de primera foto | data.photos[1].url |
| Nombre del remitente | data.metadata.full_name |
| Campo único | data.metadata.unique_field |
| Hora de envío | data.metadata.submitted_at |
Iteradores y Agregadores
Procesar Cada Foto
Usa Iterator para recorrer las fotos:
- Añade módulo Iterator
- Establece array:
{{data.photos}} - Accede a cada foto:
{{item.url}},{{item.slot_name}}
Combinar Resultados
Usa Aggregator para fusionar datos procesados:
- Añade Array aggregator después del iterador
- Recopila URLs procesadas
- Usa array agregado en el siguiente módulo
Manejo de Errores
Configuración de Reintentos
Configura por módulo:
- Auto retry: 1-3 intentos
- Retry interval: 1-5 minutos
- Continue on error: Opcional
Rutas de Error
Añade ruta de manejo de errores:
- Haz clic derecho en el módulo
- Selecciona Add error handler
- Elige tipo de manejador:
- Resume - Continuar con valor por defecto
- Rollback - Deshacer escenario
- Commit - Guardar progreso, detener
Programación
Procesamiento Instantáneo
Los webhooks se disparan inmediatamente (no necesitan programación).
Procesamiento por Lotes
Para operaciones programadas:
- Interval: Cada 15 minutos
- Specific time: Diariamente a las 9 AM
- On demand: Disparo manual
Características Avanzadas
Almacenes de Datos
Crea bases de datos reutilizables:
- Almacena IDs de envíos procesados
- Rastrea conteos de fotos
- Mantén registros de estado
Variables
Establece y usa variables:
Set Variable: processed_count
Value: {{length(data.photos)}}Funciones
Transforma datos:
{{formatDate(data.metadata.submitted_at; "YYYY-MM-DD")}}
{{upper(data.smart_link.name)}}
{{join(map(data.photos; "url"); ", ")}}Solución de Problemas
Webhook No Se Dispara
- Verifica que la URL esté copiada correctamente
- Comprueba que el escenario de Make esté encendido (ON)
- Asegura que el webhook esté habilitado en Visiono
- Prueba con envío manual
Problemas de Estructura de Datos
- Redetermina la estructura en Make
- Verifica el formato del payload del webhook
- Comprueba las rutas de campos en los mapeos
Errores de Escenario
- Revisa el historial de ejecución
- Lee los mensajes de error
- Verifica conexiones de API
- Comprueba configuraciones de módulos
Mejores Prácticas
Organización
- Usa nombres descriptivos para escenarios
- Añade notas a módulos complejos
- Agrupa módulos relacionados
- Codifica por colores según función
Rendimiento
- Usa Filters para limitar ejecuciones
- Agrupa operaciones similares
- Monitorea uso de operaciones
- Optimiza transformaciones de datos
Mantenimiento
- Prueba después de cambios
- Documenta escenarios personalizados
- Verificación regular de webhooks
- Actualiza conexiones de API
Recursos Relacionados
- Webhooks - Configuración de eventos
- Referencia de API - API directa
- Integración con Zapier - Plataforma alternativa
- Integración con n8n - Opción auto-alojada
