API de automatizaciones: creá, publicá y monitoreá automatizaciones por API
Ahora podés crear y administrar automatizaciones desde tu propio código. La nueva API de automatizaciones, en beta privada, crea, lee, actualiza, publica y elimina automatizaciones, y lee los registros de ejecución y las estadísticas de cada una.
✅ Qué hay de nuevo- Crear automatizaciones – Creá una automatización a partir de una definición completa. Las automatizaciones nuevas empiezan como borradores.
- Leer y actualizar automatizaciones – Leé cualquier automatización como una definición que podés modificar y devolver.
- Validar antes de guardar – Revisá una definición en busca de errores sin guardarla, con cada error señalando el paso exacto.
- Publicar o despublicar – Publicá una automatización o volvela a dejar como borrador.
- Buscar y eliminar – Encontrá automatizaciones por nombre, estado, carpeta o fecha, y eliminalas.
- Tipos de paso – Explorá todos los disparadores y acciones disponibles en la cuenta, con sus campos.
- Registros de ejecución – Mirá quién entró a una automatización, qué pasó en cada paso y qué pasos fallaron, con el error.
- Estadísticas – Contá las inscripciones, las finalizaciones y las fallas por paso, por hora, día o semana.
Con la API de automatizaciones, podés:
- Desplegar la misma automatización en muchas cuentas sin reconstruirla a mano.
- Detectar pasos que fallan desde tu propio monitoreo, en lugar de abrir cada automatización.
- Dejar que tu propia aplicación o tu agente de IA construya automatizaciones para tus clientes.
💡 Ejemplos de uso
Despliegue estándar
Leé una automatización de tu cuenta modelo → creála en la cuenta de cada cliente → publicala.
Informe de fallas
Todos los lunes, contá las fallas por paso de tus automatizaciones clave → listá a quiénes afectaron → enviá el resumen a tu equipo.
Alta de clientes desde tu aplicación
Un cliente se registra en tu producto → tu aplicación crea y publica su automatización de bienvenida en su cuenta.
🔌 Cómo empezar
- En la cuenta, andá a Configuración → Integraciones privadas, creá una integración y seleccioná los permisos de automatizaciones que necesitás: Ver automatizaciones, Editar automatizaciones, Publicar automatizaciones, Eliminar automatizaciones y Ver registros de automatizaciones.
- Enviá el token como token de portador (bearer), con el encabezado Version: v3 y el locationId de la cuenta en cada solicitud.
- Usá la referencia de la API de automatizaciones para ver cada endpoint y sus campos. Cada página de endpoint tiene un panel de solicitud para probarlo con tu token.
⚠️ Notas y detalles
- Beta privada: la API de automatizaciones está habilitada para cuentas seleccionadas. Las demás reciben un error 403 con WORKFLOW_API_NOT_ENABLED_FOR_LOCATION. Pedile al equipo de Arizar IA que te sume.
- Las actualizaciones reemplazan toda la automatización, así que leela primero y devolvé la versión que leíste.
- Para editar una automatización publicada, pasala primero a borrador. Mientras es un borrador, sus disparadores están apagados y los contactos que están en ella quedan en pausa.
- Los pasos de aplicaciones solo aceptan una cuenta de aplicación que ya esté conectada en la cuenta.
- Eliminar una automatización es permanente y detiene a todos los que están en ella en ese momento.
- Los registros cubren hasta 30 días por solicitud y se conservan durante 60 días. Muestran las ejecuciones reales; las ejecuciones de prueba del editor no se incluyen.
Documentación de ayuda: pedila al equipo de Arizar IA