Conectar Atera con servicios de terceros y acciones de tickets de Atera te permite automatizar más tus flujos de trabajo y reducir el trabajo manual de tu equipo. Puedes activar diferentes acciones en plataformas externas —o activar las APIs de tickets de Atera como escalar, resolver, listar y recuperar tickets— todo desde Atera, usando llamadas dinámicas basadas en parámetros a la API de cada servicio. Esto mantiene tus sistemas sincronizados, te permite pasar contexto (como detalles de dispositivo, sitio, usuario o ticket) a esas acciones, y te ayuda a crear procesos más completos de principio a fin en tus flujos de monitoreo, automatización, Robin y gestión de tickets.

Descripción general

Las acciones en la nube definen cómo Atera se comunica con servicios externos y APIs de tickets: qué endpoint de API llamar, qué parámetros y encabezados enviar, y qué datos incluir en el cuerpo de la solicitud. Puedes combinar valores estáticos (como autenticación y configuraciones fijas) con valores dinámicos extraídos de tickets, dispositivos, usuarios o entradas del usuario, e incluso dejar que AI Copilot genere la acción inicial por ti. Esto te da una forma flexible de crear y reutilizar integraciones como parte de tus flujos de monitoreo, automatización, Robin y gestión de tickets.

Las acciones en la nube también pueden activar acciones de tickets de Atera, incluyendo escalar tickets, resolver tickets, listar tickets y recuperar detalles de tickets. Esto permite que AI Copilot y Robin ayuden a avanzar los flujos de trabajo de tickets usando el contexto adecuado en el momento justo.

Parámetros

Los parámetros te permiten enviar datos adicionales al endpoint de la API, como filtros, ubicaciones o identificadores de recursos. Se pueden agregar como parámetros de consulta o de ruta, según la especificación de la API.

• Parámetros estáticos: Usa parámetros estáticos para valores que siempre serán los mismos cada vez que se ejecute la acción (por ejemplo, un código de país fijo, un estado predeterminado o una versión específica de la API). Estos se ingresan una vez y se reutilizan en cada solicitud.
• Parámetros dinámicos: Usa parámetros dinámicos para valores que pueden cambiar en tiempo de ejecución y que deben provenir del usuario o del contexto (por ejemplo, ID de dispositivo, ID de cliente, nombre de ciudad o ID de ticket). Defines el nombre del parámetro y una descripción, y AI Copilot y Robin solicitarán estos valores o los extraerán del contexto relevante al ejecutar la acción.

Esto te permite combinar valores predeterminados estáticos con valores dinámicos por solicitud, para que la misma acción se pueda reutilizar entre diferentes clientes, inquilinos, ubicaciones, recursos o tickets.

Encabezados

Los encabezados te permiten enviar metadatos adicionales al endpoint de la API, como autenticación, tipo de contenido o información del cliente. Cada encabezado tiene un tipo (Predeterminado o Secreto), una clave y un valor. Cuando seleccionas 'Secreto', el valor se oculta y solo se puede ver haciendo clic en el ícono del ojo.

• Encabezados predeterminados: Úsalos para valores no sensibles que se pueden ver sin problema, u otros valores de configuración fijos.
• Encabezados secretos: Úsalos para valores sensibles como claves de API, tokens o credenciales. Estos valores se enmascaran para ayudar a proteger información confidencial, pero siguen estando disponibles para la llamada a la API en tiempo de ejecución.

Los encabezados también pueden definirse como estáticos o dinámicos, dependiendo de si sus valores permanecen iguales cada vez que se ejecuta la acción o cambian en tiempo de ejecución según la entrada del usuario o el contexto.

• Encabezados estáticos: Usa encabezados estáticos para valores que siempre serán los mismos en cada solicitud, como autenticación y configuración fija. (por ejemplo, Authorization: ApiKey {{api_key}}). Una vez configurados, AI Copilot los incluye automáticamente en cada solicitud para saber cómo autenticarse y llamar a la API correcta sin pedirle nada al usuario.
• Encabezados dinámicos: Usa encabezados dinámicos para valores que pueden cambiar en tiempo de ejecución y que deben provenir del usuario o del contexto (por ejemplo, ciudad, país, ID de inquilino o ID de ticket). Defines la clave del encabezado y una descripción, y AI Copilot solicitará estos valores o los obtendrá del ticket, dispositivo o cliente actual al ejecutar la acción.

Al combinar encabezados Predeterminados o Secretos con comportamiento estático y dinámico, puedes reutilizar de forma segura la misma acción de API entre diferentes clientes, ubicaciones, recursos y flujos de tickets, manteniendo el flujo de trabajo flexible y seguro.

Cuerpo de la solicitud

Agrega un cuerpo de solicitud (en formato JSON válido) si tu acción necesita enviar datos al servicio de destino o a la API de tickets de Atera (por ejemplo, crear o actualizar un recurso o modificar un ticket). Para valores dinámicos, coloca los marcadores de posición entre llaves (por ejemplo, {customer_id} o {ticket_id}).

Crear una acción en la nube

Cuando creas una acción en la nube, defines exactamente qué debe suceder en el servicio externo o dentro de Atera (por ejemplo, acciones de tickets): qué endpoint llamar, qué datos enviar y cuándo debe ejecutarse. Esto te da control total sobre las integraciones, para que puedas adaptar cada acción a tus herramientas, casos de uso, flujos de tickets y requisitos de seguridad específicos.

Para crear una acción en la nube:

1. Ve a Centro de IA > Acciones en la nube.

2. Haz clic en Nueva acción en la nube.

Aparecerá la página Crear acción en la nube.

3. Ingresa el nombre y la descripción.

4. Activa o desactiva Robin para que pueda evaluar los problemas reportados por los usuarios y ejecutar esta acción en la nube cuando sea necesario. 

5. Selecciona el método de solicitud HTTP (GET, POST, PUT, PATCH o DELETE). Luego ingresa la URL completa del endpoint de la API que quieres que esta acción en la nube llame.

6. Completa los parámetros, encabezados y cuerpo según lo requiera el servicio de destino o la acción de tickets de Atera:

• Parámetros: Agrega cualquier parámetro de consulta o de ruta que el endpoint espere. También puedes usar valores dinámicos aquí colocándolos entre doble llave (por ejemplo,  {{ticket_id}}).
• Encabezados: Agrega cualquier encabezado HTTP requerido por la API (sigue el formato definido en la documentación de la API correspondiente).
• Cuerpo: Agrega un cuerpo de solicitud (en formato JSON válido) si tu acción necesita enviar datos al servicio de destino o a la API de tickets de Atera. Para insertar valores dinámicos, colócalos entre doble llave (por ejemplo, {{ticket_id}}).

Generar acciones con AI Copilot

Describe tu objetivo en lenguaje sencillo y deja que AI Copilot redacte la solicitud por ti: URL, método, encabezados y cuerpo, ya sea para un servicio externo o una acción de tickets de Atera. Te recomendamos revisar y ajustar la acción generada antes de habilitarla, para que se alinee exactamente con tu intención y políticas internas.

Para generar una acción en la nube con AI Copilot:

1. Haz clic en Generar con AI Copilot.

Aparecerá la ventana Generar acciones en la nube con AI Copilot.

2. Describe el caso de uso.

3. Ingresa el valor que el sistema de destino espera en el encabezado Authorization para sus llamadas a la API. Normalmente es una clave de API o un token. 

Nota: Si la API no requiere autorización, puedes dejar este campo vacío.

4. Ingresa la URL de la documentación de la API.

5. Haz clic en Generar acción.

La acción aparecerá en la página Acciones en la nube. 

6. Ábrela, revisa los detalles que creó AI Copilot y haz los cambios necesarios. Luego haz clic en Guardar. 

7. Cambia el estado a Activo.