Uso de acciones de Linear en los flujos de acciones

Linear es una herramienta de seguimiento de problemas y administración de proyectos creada específicamente para los equipos de software. Con el conector de Linear para el generador de acciones, se pueden crear y administrar problemas, proyectos y comentarios, buscar problemas y usuarios, y mantener organizado el trabajo del equipo desde los mismos flujos de acciones de Zendesk.

¿Qué plan tengo?

Suite, todas las versiones

Team, Growth, Professional, Enterprise o Enterprise Plus

Support

Team, Professional o Enterprise

Resumen: ◀▼

Los flujos de acciones se pueden conectar con Linear para crear, actualizar y administrar problemas, proyectos y comentarios directamente en los flujos de trabajo. Esta integración es compatible con la búsqueda de problemas y usuarios, la asignación de problemas y la organización de proyectos, y ayuda a simplificar la administración de proyectos y el seguimiento de problemas sin necesidad de cambiar de plataforma. Utilice una cuenta de servicio exclusiva para que las acciones externas sean seguras y estén atribuidas.

Si el generador de acciones se conecta con sistemas externos, como Linear, los administradores pueden integrar Zendesk con sistemas externos en los flujos de trabajo automatizados, lo que mejora la colaboración y mantiene una experiencia fluida en las distintas plataformas.

Nota: Los pasos asociados a los sistemas externos en los flujos de acciones se denominan colectivamente acciones externas.

Linear es una herramienta de seguimiento de problemas y administración de proyectos creada específicamente para los equipos de software. Con el conector de Linear para el generador de acciones, se pueden crear y administrar problemas, proyectos y comentarios, buscar problemas y usuarios, y mantener organizado el trabajo del equipo desde los mismos flujos de acciones de Zendesk.

En este artículo se tratan los siguientes temas:

• Conectar Linear con el generador de acciones
• Usar las acciones de Linear en los flujos de acciones

Conectar Linear con el generador de acciones

Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

Las siguientes prácticas son las más recomendadas a la hora de conectarse a sistemas externos para usarlos en flujos de acciones:

• Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
• Todas las integraciones solicitan acceso a los ámbitos necesarios. Sin embargo, es importante que revise y valide los ámbitos antes de autorizar la conexión al sistema externo.
• Cuando necesite administrar credenciales para herramientas que funcionan con claves API (como OpenAI), lo mejor es guardar las claves en una bóveda o con un administrador de credenciales.

Para conectar el generador de acciones con Linear

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones > Flujos de acciones.
2. Cree o edite un flujo de acciones.
3. Abra la barra lateral de pasos.
4. En Acciones externas, haga clic en Linear.
5. Haga clic en Conectar.
6. Siga las instrucciones de Linear para autenticarse y completar la conexión.

   La conexión de Linear utiliza OAuth 2.0 con el tipo de concesión de código de autorización. Una vez que autorice la conexión, se le redirigirá a Linear para otorgar permisos a su cuenta de Zendesk.

   Nota: Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.

Después de conectarse al sistema, verá un indicador de conexión y detalles sobre la instancia a la que está conectado, así como las acciones disponibles para Linear.

Usar las acciones de Linear en los flujos de acciones

Los pasos de acción de Linear se pueden usar para buscar formularios y respuestas de encuestas.

Están disponibles las siguientes acciones de Linear:

• Crear problema
• Actualizar problema
• Buscar problema por ID
• Buscar problemas
• Agregar comentario al problema
• Buscar usuario
• Buscar usuarios
• Crear proyecto
• Actualizar proyecto
• Agregar problema al proyecto
• Asignar problema a un miembro

Crear un problema

Utilice la acción Crear problema para crear un nuevo problema en Linear con los detalles especificados.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Title, Team Opcional: Description, Project, Assignee email, Status, Priority, Due date, Estimate Nota: La fecha de vencimiento debe ingresarse con el formato AAAA-MM-DD según la zona horaria de su cuenta de Linear. Las opciones de prioridad son: Sin prioridad, Urgente, Alta, Media o Baja.
Salida	Detalles del problema, lo que incluye: ID, identificador, título, descripción, URL, información del proyecto, información del agente asignado, información del estado, prioridad, fecha de vencimiento, estimación y marcas de tiempo

Actualizar un problema

Use la acción Actualizar problema para actualizar las propiedades de un problema existente en Linear.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Issue Opcional: Title, Description, Assignee email, Project, Status, Priority, Due date, Estimate Nota: La fecha de vencimiento debe ingresarse con el formato AAAA-MM-DD según la zona horaria de su cuenta de Linear.
Salida	Detalles del problema actualizado, lo que incluye: ID, identificador, título, descripción, URL, información del agente asignado, información del estado, prioridad, fecha de vencimiento, estimación y marca de tiempo de la actualización

Buscar un problema

Use la acción Buscar problema por ID para obtener información detallada sobre un problema específico.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Issue ID
Salida	Detalles del problema, lo que incluye: ID, identificador, título, descripción, URL, información del proyecto, información del agente asignado, información del estado, prioridad, fecha de vencimiento, estimación y marcas de tiempo

Buscar problemas

Use la acción Buscar problemas para buscar problemas en función de distintos criterios.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Opcional: Team, Project, Assignee email, Status, Order by, Limit, Cursor
Salida	Matriz de problemas con ID, identificador, título, URL, información del estado, información del agente asignado, prioridad y marca de tiempo de creación; también incluye información de paginación (hasNextPage, endCursor)

Agregar un comentario a un problema

Use la acción Agregar comentario al problema para agregar un comentario a un problema existente.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Issue, Body
Salida	Detalles del comentario, lo que incluye: ID, texto del cuerpo, información del autor (ID y nombre) y marca de tiempo de creación

Buscar a un usuario

Use la acción Buscar usuario para obtener información del usuario por el correo electrónico o nombre mostrado.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Lookup by, Value
Salida	Detalles del usuario, lo que incluye ID, nombre, nombre mostrado, correo electrónico, URL de avatar y URL de perfil

Buscar usuarios

Use la acción Buscar usuarios para buscar a los usuarios que coincidan con una consulta de búsqueda.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Query Opcional: Limit, Cursor
Salida	Matriz de usuarios con ID, nombre, nombre mostrado, correo electrónico y URL de avatar; también incluye información de paginación (hasNextPage, endCursor)

Crear proyectos

Use la acción Crear proyecto para crear un proyecto nuevo en Linear.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Name, Team Opcional: Description, Start date, End date Nota: Las fechas de inicio y de finalización deben ingresarse con el formato AAAA-MM-DD según la zona horaria de su cuenta de Linear.
Salida	Detalles del proyecto, lo que incluye: ID, nombre, descripción, URL, información del equipo (ID y nombre), fecha de inicio, fecha de finalización y marca de tiempo de creación

Actualizar proyectos

Use la acción Actualizar proyecto para actualizar las propiedades de un proyecto existente.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Project Opcional: Name, Description, Start Date, End Date Nota: Las fechas de inicio y de finalización deben ingresarse con el formato AAAA-MM-DD según la zona horaria de su cuenta de Linear.
Salida	Detalles del proyecto actualizado, lo que incluye: ID, nombre, descripción, URL, fecha de inicio, fecha de finalización y marca de tiempo de actualización

Agregar un problema a un proyecto

Use la acción Agregar problema al proyecto para asignar un problema existente a un proyecto.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Issue, Project
Salida	Detalles del problema, lo que incluye: ID, identificador, título, URL e información del proyecto (ID y nombre)

Asignar un problema a un miembro

Use la acción Asignar problema a un miembro para asignar un problema a un integrante del equipo por correo electrónico.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Issue, Assignee email
Salida	Detalles del problema, lo que incluye: ID, identificador, título, URL e información del agente asignado (ID y nombre)