

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integraciones
<a name="actions-integrations"></a>

## AWS Servicios
<a name="aws-services"></a>

### Amazon S3
<a name="amazon-s3"></a>

Las acciones de Amazon S3 le permiten almacenar y recuperar archivos y datos.

**Acciones disponibles**
+ **Descargar archivo**: descarga un archivo de Amazon S3 y devuelve un identificador de objeto de archivo.
+ **Cargar archivo**: carga un identificador de objeto de archivo en Amazon S3.
+ **Copiar objeto**: crea una copia de un objeto que ya está almacenado en Amazon S3 desde un archivo de origen a una ubicación de destino.
+ **Eliminar objeto**: elimina un objeto específico de un bucket de S3.
+ **Listar objetos**: muestra todos los objetos del depósito en cuestión. Se puede filtrar con un prefijo.

### Amazon Bedrock
<a name="amazon-bedrock"></a>

Las acciones de Amazon Bedrock le permiten conectarse a los modelos básicos (FMs) de las principales empresas de IA a través de una única API.
+ **Converse con un modelo básico**: envía un mensaje a un modelo de IA. Usa un lenguaje natural para generar texto, analizar el contenido y obtener respuestas impulsadas por la IA.
+ **Modelo avanzado de conversación: genera** un modelo con más opciones. Las opciones avanzadas incluyen formatos de mensajes personalizados, integraciones de herramientas y un control detallado del comportamiento del modelo.

### Agentes de Amazon Bedrock
<a name="amazon-bedrock-agents"></a>

Las acciones de Amazon Bedrock Agent le permiten invocar asistentes de IA que pueden conectarse a sus fuentes de datos y sistemas APIs de backend.
+ **Invocación básica de un agente:** envía una solicitud a un agente de IA. Úselo para interacciones sencillas que no requieren archivos adjuntos, entradas del usuario ni configuraciones personalizadas.
+ **Invocación avanzada de agentes**: llama a un agente con más opciones. Se utiliza para interacciones avanzadas que requieren archivos adjuntos, entradas del usuario o configuraciones personalizadas.

### Automatización de datos de Amazon Bedrock
<a name="amazon-bedrock-data-automation"></a>

Bedrock Data Automation (BDA) simplifica el proceso de extraer información valiosa del contenido no estructurado mediante la IA generativa.

**Acciones disponibles**
+ **Invoque Data Automation Async**: procese datos con un proyecto o planos de automatización de datos. Inicia el procesamiento asíncrono de datos y devuelve un identificador de invocación.
+ **Obtener el estado de la automatización de datos: obtiene detalles sobre el estado** de la invocación de una automatización de datos y la ubicación de salida.

### Amazon Textract
<a name="amazon-textract"></a>

Amazon Textract le ayuda a añadir la detección y el análisis del texto de los documentos a sus automatizaciones.
+ **Consulta básica de documentos**: extrae datos en función de las preguntas. Cada consulta contiene la pregunta que desea formular y el alias que desea asociar. Textract proporciona la respuesta textual a cada pregunta y una puntuación de confianza.
+ **Análisis básico de documentos**: extrae datos de los documentos. Detecta y extrae automáticamente los formularios (pares clave-valor), las tablas (datos estructurados) y el texto, a la vez que preserva el diseño del documento y las relaciones entre los datos.

### Amazon Comprehend
<a name="amazon-comprehend"></a>

Amazon Comprehend es un servicio de procesamiento del lenguaje natural (NLP) que permite obtener información sobre el contenido de los documentos. Ayuda a analizar el texto para extraer frases clave, identificar opiniones y clasificar documentos.

**Acciones disponibles**
+ **Clasificar el documento**: crea una solicitud de clasificación para analizar un único documento en tiempo real mediante un punto final de modelo personalizado. Admite la entrada de texto o archivos de documentos (PDF, Word o imagen).
+ **Detectar frases clave**: detecta las frases nominales clave que se encuentran en el texto e identifica los conceptos y temas importantes del contenido.

## Aplicaciones externas
<a name="external-applications"></a>

### Microsoft Outlook
<a name="microsoft-outlook"></a>

Las acciones de Microsoft Outlook permiten que tus automatizaciones administren correos electrónicos y calendarios.
+ **Correo electrónico**
  + **Enviar correo electrónico de usuario**: envíe un mensaje de correo electrónico en nombre de un usuario específico.
  + **Responder al correo electrónico**: responde al remitente de un mensaje.
  + **Listar los mensajes de la carpeta**: coloca los mensajes en una carpeta específica del buzón del usuario que ha iniciado sesión.
  + **Listar los correos de los usuarios**: obtén los mensajes del buzón del usuario que ha iniciado sesión (incluidos los elementos eliminados y las carpetas de Clutter).
  + **Ver correo electrónico**: recupera las propiedades y relaciones de un objeto de mensaje específico.
  + **Actualizar correo electrónico**: actualiza las propiedades de un objeto de mensaje.
  + **Eliminar correo electrónico**: elimina un mensaje del buzón del usuario especificado.
  + **Listar los archivos adjuntos del correo electrónico**: recupera una lista de los objetos adjuntos adjuntos a un mensaje.
  + **Obtener un archivo adjunto**: lea las propiedades, las relaciones o el contenido sin procesar de un archivo adjunto.
+ **Carpetas**
  + **Listar carpetas de correo**: coloca la colección de carpetas de correo directamente en la carpeta raíz del usuario que ha iniciado sesión.
  + **Mover el correo electrónico a la carpeta**: mueve un mensaje a otra carpeta del buzón del usuario especificado.
  + **Obtener la configuración del buzón**: obtenga la configuración del buzón del usuario, como las respuestas automáticas, el formato de fecha y la zona horaria.
+ **Calendario**
  + **Listar eventos del calendario**: obtiene una lista de eventos del calendario para el usuario o recurso especificado de Microsoft Outlook.
  + **Crear evento de calendario**: crea un evento en el calendario predeterminado del usuario o en el calendario especificado.
  + **Actualizar un evento del calendario**: actualiza las propiedades de un objeto de evento existente.
+ **Otros**
  + **Listar lugares**: obtenga una colección de objetos de lugar (habitaciones o listas de habitaciones) definidos en el arrendatario.
  + **Listar usuarios**: recupera una lista de usuarios de la organización de Microsoft Outlook con su información básica.
  + **Listar contactos**: obtenga una colección de contactos de la carpeta de contactos predeterminada del usuario que ha iniciado sesión.

### Microsoft Teams
<a name="microsoft-teams"></a>

Las acciones de Microsoft Teams permiten que tus automatizaciones se comuniquen con los miembros del equipo a través de canales y mensajes de chat, así como gestionar reuniones.
+ **Mensajes**
  + **Lista de chats**: consulta todas las conversaciones de chat
  + **Crear chat**: inicia una nueva conversación de chat
  + **Obtenga un chat individual**: vea los detalles de un chat específico
  + **Listar todos los mensajes de chat**: visualiza los mensajes de una conversación de chat
  + **Enviar mensaje de chat**: envía un mensaje nuevo en un chat
+ **Equipos**
  + **Listar equipos**: muestra todos los equipos a los que puede acceder el usuario autenticado
  + **Obtener equipo**: consulta información detallada sobre un equipo específico
  + **Listar todos los miembros del equipo**: muestra los miembros de un equipo
  + **Invitar a un usuario al equipo**: agrega un nuevo miembro a un equipo
+ **Canales**
  + **Listar todos los canales**: visualiza todos los canales de un equipo específico
  + **Crear canal**: crea un nuevo canal dentro de un equipo
  + **Obtener canal**: consulta información detallada sobre un canal específico
  + **Listar todos los mensajes del canal**: visualiza los mensajes publicados en un canal
  + **Enviar mensaje de canal**: publica un mensaje nuevo en un canal
  + **Responder a un mensaje del canal**: agrega una respuesta a un mensaje del canal existente
  + **Invitar a un miembro del canal**: agrega un miembro a un canal específico
+ **Reuniones**
  + **Cree una reunión de equipos en línea**: programe una nueva reunión en línea
  + **Obtenga una reunión de equipos en línea**: vea los detalles de una reunión específica
  + **Listar todas las grabaciones**: vea las grabaciones de una reunión
  + **Listar todas las transcripciones**: vea las transcripciones de una reunión
+ **Usuarios**
  + **Listar usuarios**: vea la lista de usuarios de la organización

### Microsoft SharePoint
<a name="microsoft-sharepoint"></a>

Microsoft SharePoint le permite almacenar, administrar y compartir documentos e información de forma centralizada a través de sus automatizaciones.
+ **Listas y elementos**
  + **Obtener lista**: obtiene una lista de las operaciones asociadas a una lista
  + **Crear elemento**: crea un nuevo elemento de lista en una lista
  + **Actualizar elemento**: actualiza las propiedades de un elemento de lista
  + **Eliminar elemento**: elimina un elemento de una lista
  + **Obtener elemento**: devuelve los metadatos de un elemento de una lista
  + **Elemento de lista**: obtiene la colección de elementos de una lista
+ **Hojas y archivos**
  + **Agregar hoja**: agrega una nueva hoja de trabajo al libro de trabajo
  + **Eliminar hoja**: elimina la hoja de trabajo del libro de trabajo
  + **Actualizar hoja**: edita las propiedades de la hoja de trabajo (cambio de nombre, visibilidad)
  + **Hojas de lista**: recupera una lista de objetos de la hoja de trabajo
  + **Leer la hoja**: recupera las propiedades de una hoja de trabajo
  + **Cargar archivo**: crea o actualiza un archivo de libro de trabajo
+ **Rangos y celdas**
  + **Rango de lectura**: recupera valores de un rango especificado
  + **Eliminar rango**: elimina las celdas de un rango especificado
  + **Rango de escritura**: actualiza los valores de un rango especificado
  + **Obtener rango usado**: devuelve el rango usado de la hoja de trabajo dada
  + **Borrar rango**: borra los valores del rango, incluidos el formato, el relleno y el borde
  + **Leer celda**: obtiene el valor de una celda específica
  + **Escribir celda**: establece el valor de una celda específica

### Microsoft OneDrive
<a name="microsoft-onedrive"></a>

 OneDrive Las acciones de Microsoft te permiten almacenar, sincronizar y compartir archivos. Puede interactuar directamente con los archivos de Microsoft Excel guardados OneDrive para realizar acciones en hojas de cálculo.
+ **Administración de archivos**
  + **Obtener elemento**: muestra los detalles de un archivo o una carpeta específicos
  + **Get Drive**: consulta los detalles de la OneDrive cuenta y la información de almacenamiento
  + **Lista de elementos**: visualiza todos los archivos y carpetas de una unidad
  + **Crear elemento/Crear carpeta**: crea una nueva carpeta o elemento en OneDrive
  + **Listar niños**: vea los elementos contenidos en una carpeta específica
  + **Eliminar elemento**: elimina un archivo o una carpeta
  + **Actualizar elemento o mover elemento**: actualiza los metadatos o mueve archivos entre carpetas
  + **Copiar elemento**: crea una copia de un archivo o carpeta en una ubicación diferente
  + **Añadir permisos**: configura los permisos de acceso y uso compartido de los archivos
  + **Cargar archivo**: agrega nuevos archivos a OneDrive
+ **Excel**
  + **Agregar hoja**: crea una nueva hoja de trabajo en un libro de Excel
  + **Borrar rango**: elimina el contenido y el formato de un rango de celdas
  + **Eliminar rango**: elimina celdas, filas o columnas de una hoja de trabajo
  + **Eliminar hoja**: elimina una hoja de trabajo de un libro
  + **Listar hojas**: vea todas las hojas de trabajo de un libro de trabajo
  + **Leer celda**: obtiene el valor de una celda específica
  + **Rango de lectura**: obtiene valores de un rango de celdas
  + **Leer hoja**: muestra el contenido de una hoja de trabajo completa
  + **Leer rango usado**: obtiene el rango de celdas que contienen datos
  + **Actualizar hoja**: modifique las propiedades de la hoja de trabajo
  + **Escribir celda**: establece el valor de una celda específica
  + **Rango de escritura**: establece valores para un rango de celdas

### Salesforce
<a name="salesforce"></a>

Las acciones de Salesforce le permiten automatizar el proceso de gestión de las relaciones con los clientes en todos los casos, oportunidades, clientes potenciales, campañas, contactos y más.
+ **Casos**
  + **Obtener lista de casos**: obtiene una lista de casos de atención al cliente de Salesforce, incluidos sus metadatos y artículos recientes.
  + **Obtener un caso**: vea los detalles de un caso específico
  + **Crear un caso**: cree un nuevo caso de soporte
  + **Eliminar caso**: elimina un caso existente
  + **Actualizar un caso**: edita los detalles y la información del caso
+ **Oportunidades**
  + **Obtenga oportunidades**: vea la lista de oportunidades de venta
  + **Obtenga una oportunidad específica**: vea los detalles de una oportunidad específica
  + **Crear oportunidad**: cree una nueva oportunidad de venta
  + **Actualizar oportunidad**: edita los detalles de la oportunidad
  + **Eliminar oportunidad**: elimina una oportunidad existente
+ **Clientes potenciales**
  + **Actualizar cliente potencial**: edita los detalles e información del cliente potencial
+ **Campaigns (Campañas)**
  + **Actualizar la campaña**: edita los detalles y la información de la campaña
+ **Elementos de feed**
  + **Actualizar el elemento del feed**: edita el contenido y las propiedades del elemento del feed
+ **Contactos**
  + **Obtener lista de contactos**: vea todos los contactos del sistema
  + **Obtener contacto**: obtiene los detalles de un contacto específico
  + **Actualizar contacto**: editar la información de contacto
+ **Usuarios**
  + **Obtener lista de usuarios**: recupera la lista de usuarios de Salesforce
+ **System (Sistema)**
  + **Describa SObject**: obtenga metadatos de objetos y detalles de campo para cualquier tipo de objeto de Salesforce

### Jira
<a name="jira"></a>

Las acciones de Jira te permiten automatizar la gestión de incidencias, proyectos, sprints y mucho más.
+ **Problemas**
  + **Crear incidencia**: crea una incidencia en un proyecto.
  + **Editar problema**: modifica un problema existente en un proyecto.
  + **Actualizar el estado de un problema (hacer la transición)**: cambia el estado de la tarea de un problema.
  + **Eliminar problema**: elimina un problema de un proyecto.
  + **Obtener publicación**: muestra los detalles de una incidencia en un proyecto.
  + **Buscar problemas**: busca problemas mediante JQL
  + **Estados de búsqueda: busca estados** de problemas.
  + **Descargar el archivo adjunto del problema**: consulta el contenido de un archivo adjunto.
  + **Agregar archivo adjunto**: agrega un archivo adjunto a un número.
  + **Obtener todas las etiquetas**: ver todas las etiquetas.
+ **Comentarios**
  + **Añadir comentario**: añade un comentario nuevo a un número.
  + **Eliminar comentario**: elimina el comentario de un problema.
  + **Actualizar comentario**: edita un comentario existente sobre un tema.
  + **Obtener comentarios**: consulta los comentarios del problema.
+ **Proyectos**
  + **Crear proyecto**: crea un nuevo proyecto en Jira.
  + **Actualizar proyecto**: modifica los detalles del proyecto.
  + **Eliminar proyecto**: elimina el proyecto de Jira.
  + **Obtener proyecto**: consulta los detalles del proyecto.
  + **Obtenga los tipos de problemas para el proyecto**: vea los tipos de problemas del proyecto.
  + **Buscar proyectos**: busque proyectos visibles.
+ **Sprints**
  + **Crear un sprint**: crea un sprint en un proyecto.
  + **Actualizar Sprint**: actualiza los detalles del sprint.
  + **Eliminar Sprint**: elimina un sprint de un proyecto.
  + **Obtén Sprint**: consulta los detalles de un sprint en un proyecto.
  + **Mueva las incidencias a un sprint y clasifíquelas**: asigne una incidencia a un sprint.
  + **Mover los problemas a la lista de pendientes**: mueve los problemas a la lista de pendientes.
+ **Usuarios**
  + **Buscar usuarios**: busca un usuario de Jira.
  + **Buscar usuarios asignables**: devuelve una lista de los usuarios que se pueden asignar a una incidencia.
  + **Obtener todos los usuarios**: muestra una lista de todos los usuarios de Jira.

### ServiceNow
<a name="servicenow"></a>

ServiceNow las acciones te permiten automatizar la gestión de incidentes, solicitudes de cambio y mucho más por parte de los servicios de TI.
+ **Incidentes**
  + **Crear incidente**: crea un nuevo registro de incidentes.
  + **Leer el incidente**: recupera los detalles de un incidente específico.
  + **Actualizar incidente**: modifica un registro de incidentes existente.
  + **Eliminar incidente**: elimina un registro de incidente específico.
+ **Solicitudes de cambio**
  + **Crear solicitud de cambio**: crea un nuevo registro de solicitud de cambio.
  + **Leer la solicitud de cambio**: recupera los detalles de una solicitud de cambio específica.
  + **Actualizar solicitud de cambio**: modifica un registro de solicitud de cambio existente.
  + **Eliminar solicitud de cambio**: elimina un registro de solicitud de cambio específico.
+ **Artículos de la base de conocimientos**
  + **Actualizar el artículo de la base de conocimientos**: modifica un artículo de la base de conocimientos existente.
+ **Registros de problemas**
  + **Actualizar el registro de problemas**: modifica un registro de problemas existente.
+ **Archivos adjuntos**
  + **Cargar adjunto binario**: carga un archivo como adjunto a un registro especificado.
  + **Cargar un archivo adjunto de formulario de varias partes**: carga un archivo adjunto de formulario a un registro.
  + **Recuperar el contenido del archivo adjunto**: obtiene el contenido binario de un archivo adjunto específico.
  + **Recuperar metadatos de un archivo adjunto**: obtiene los metadatos de un archivo adjunto específico.
  + **Eliminar un archivo adjunto**: elimina un archivo adjunto del sistema.
  + **Recuperar los metadatos de los archivos adjuntos**: obtiene los metadatos de varios archivos adjuntos.
+ **System (Sistema)**
  + **Listar usuarios**: recupera todos los registros existentes de la tabla de usuarios del sistema.
  + **Lista de opciones**: recupera los valores de la lista de opciones del sistema.

### SAP
<a name="sap"></a>

Las acciones de SAP le permiten automatizar los procesos relacionados con los datos de los socios comerciales, las existencias de materiales, las listas de materiales, los patrones de productos y el inventario físico.
+ **Socios comerciales de SAP**
  + **Obtenga un socio comercial**: recupera datos generales de los socios comerciales y proporciona una visión completa de la información de los socios.
  + **Obtenga un socio comercial por identificación**: recupera datos detallados del socio comercial utilizando un número de socio comercial específico como identificador.
  + **Obtener la dirección del socio comercial**: recupera los detalles de la dirección asociada a los socios comerciales, incluidas las direcciones postales y la información de contacto.
  + **Obtener el rol de socio comercial**: recupera información sobre el rol de los socios comerciales, que muestra sus relaciones y funciones dentro del sistema.
  + **Obtenga el rol de socio comercial por ID**: recupera datos de rol específicos de un socio comercial mediante campos de identificación clave.
+ **Stock de materiales de SAP**
  + **Colección de modelos Get Material Stock In Account**: obtiene los niveles de existencias de material con detalles como el lote, la ubicación de almacenamiento y los indicadores especiales de existencias.
+ **Lista de materiales de SAP**
  + **Obtenga el artículo BOM de material**: recupera los detalles de los materiales utilizados en las listas de materiales, incluidas las cantidades, las categorías y las relaciones.
+ **Maestro de productos de SAP**
  + **Obtenga los registros maestros del producto**: consulte los detalles generales del producto maestro. Devuelve los registros maestros completos del producto con opciones para filtrar, ordenar y seleccionar datos específicos.
  + **Obtenga los datos de la planta del registro maestro del producto**: vea los detalles de la planta del producto. Acceda a información detallada específica de la planta para un producto determinado, incluidos los datos de fabricación, almacenamiento y logística.
  + **Obtenga datos de planificación del suministro por número de producto y planta: consulte** los detalles de la planificación del suministro por número de producto y planta. Recupera los parámetros de planificación detallados, incluidos los tamaños de los lotes, los niveles de existencias de seguridad y los datos de adquisición.
+ **Inventario físico de SAP**
  + **Obtenga un artículo documental de inventario de Phys**: recupera los elementos del documento de inventario físico, incluidos los resultados del recuento y las diferencias de inventario.

## Integración de la API REST
<a name="custom-rest-apis"></a>

La integración de la conexión API REST permite a Quick Automate interactuar con servicios web APIs y REST personalizados, lo que le permite extender las capacidades de automatización a sistemas externos. Esta integración permite la ejecución de acciones para los métodos HTTP GET, POST, DELETE, PATCH y PUT.

**Casos de uso comunes:**
+ Envío de notificaciones a sistemas externos
+ Recuperación de datos de servicios de terceros
+ Actualización de registros en bases de datos externas
+ Activar flujos de trabajo en las aplicaciones conectadas

**Requisitos previos**

Antes de crear automatizaciones con la integración de la API REST, asegúrese de tener lo siguiente:
+ **Integración de la API REST configurada**
  + Acceda a la consola Quick Suite
  + Vaya a Integraciones > Conexión a la API REST
  + Configure su punto final de la API REST con la URL base
  + Configuración de autenticación completa (consulte la sección de autenticación a continuación)
  + Detalles completos: [Integración de conexión API REST](rest-api-integration.md)
+ **Integración conectada con Automation Group**
  + Vincule la integración de la API REST configurada a su grupo de automatización
  + Comprueba que la integración aparezca en las acciones disponibles
  + Step-by-step guía: [AWS conectores de acción de servicio](builtin-services-integration.md)
+ **Autenticación configurada**
  + OAuth Credenciales 2.0 obtenidas de su proveedor de API

### Autenticación
<a name="rest-api-authentication"></a>

En el caso de Quick Automate, esta integración admite la autenticación **OAuth 2.0**. Debe configurar OAuth las credenciales antes de crear automatizaciones.

**OAuth Pasos de configuración 2.0:**
+ Obtenga OAuth las credenciales (ID de cliente y secreto de cliente) de su proveedor de identidad
+ En la consola de Quick Suite, navegue hasta la configuración de integración de la API REST
+ Seleccione OAuth 2.0 como método de autenticación
+ Introduzca su ID de cliente y su secreto de cliente
+ Configura la URL de autorización y la URL del token proporcionadas por tu proveedor de API
+ Complete el OAuth flujo para autorizar Quick Suite
+ Pruebe la conexión para verificar la autenticación

**Notas importantes:**
+ Quick Automate no admite la autenticación por token de portador en los encabezados de las solicitudes. En su lugar, utilice OAuth la configuración.
+ Configure la autenticación en el nivel de integración, no por acción de automatización

### Configuración
<a name="rest-api-configuration"></a>

**Configuración de la integración de la API REST**

Paso 1: Crear la configuración de URL base

Paso 2: Conectarse a Automation Group

Paso 3: Acceder a las acciones de la API REST
+ Abre el panel de acciones en tu automatización
+ Localice la acción de la API REST
+ Arrastra y suelta las acciones en tu flujo de trabajo de automatización
+ 
**nota**  
Las acciones de la API REST se deben añadir a través del panel de acciones; no están disponibles en la interfaz Build with Assistant

### Referencia de propiedades
<a name="rest-api-properties"></a>
+ **ID de Q Action Connector (obligatorio)**
  + **Descripción:** identificador único que vincula la acción de la API REST con la integración configurada, incluida la URL base y la configuración de autenticación.
  + **Formato:** se rellena automáticamente a partir de la integración conectada
  + **Ejemplo**: `rest-api-connector-abc123`
+ **URI (opcional)**
  + **Descripción:** se ha añadido una ruta adicional a la URL base para especificar el punto final exacto de la API.
  + **Formato:** cadena de ruta con o sin barra diagonal inicial (depende del formato de la URL base)
  + **Cómo funciona:**
    + URL base: `https://api.example.com`
    + URI: `/users/123`
    + URL final: `https://api.example.com/users/123`
  + **Ejemplos**:

    ```
    /users/123
    prod/send-email
    /v2/orders
    customers/search
    ```
+ **Encabezados adicionales (opcionales)**
  + **Descripción:** encabezados HTTP personalizados para incluirlos en la solicitud de API como pares clave-valor.
  + **Formato:**

    ```
    Key: Value
    ```
  + **Ejemplos comunes:**

    ```
    Content-Type: application/json
    Accept: application/json
    X-Custom-Header: custom-value
    X-API-Version: 2.0
    ```
  + **Limitaciones importantes:**
    + No incluya encabezados de autorización; la autenticación se gestiona mediante OAuth la configuración
    + Cada encabezado debe estar en una línea separada
    + Los encabezados distinguen entre mayúsculas y minúsculas
+ **Solicitud (obligatorio)**
  + **Descripción:** Datos con formato JSON para enviar con solicitudes POST o PUT.
  + **Formato:** objeto JSON válido. \$1\$1 para solicitudes en blanco
  + **Ejemplo de solicitud POST (creación de un recurso):**

    ```
    {
      "title": "My New Post",
      "body": "This is the content of my new post.",
      "userId": 1,
      "tags": ["automation", "api"],
      "published": true
    }
    ```
  + **Ejemplo de solicitud PUT (actualización de un recurso):**

    ```
    {
      "status": "completed",
      "completedDate": "2026-01-27",
      "notes": "Task finished successfully"
    }
    ```
+ **Variable de salida (opcional)**
  + **Descripción:** nombre de la variable para almacenar la respuesta JSON de la llamada a la API para utilizarla en acciones de automatización posteriores.
  + **Formato:** nombre de variable alfanumérico (sin espacios)
  + **Ejemplo:**`apiResponse`,, `userData` `orderDetails`

### Ejemplo de uso de la API
<a name="rest-api-examples"></a>

#### Ejemplo 1: Solicitud GET: recuperación de los detalles del ticket
<a name="rest-api-example-get"></a>

**Escenario:** recuperar los detalles de un ticket de soporte existente desde un sistema de venta de tickets externo

**Configuración:**
+ **ID del conector de acción Q:** rest-api-connector-tickets
+ **Método HTTP:** GET
+ **URI: /tickets/** `ticketId`
+ **Encabezados adicionales:**

  ```
  Accept: application/json
  ```
+ **Cuerpo de la solicitud:** \$1\$1 (vacío para las solicitudes GET)
+ **Variable de salida:** ticketDetails

#### Ejemplo 2: Solicitud POST: creación de un nuevo registro
<a name="rest-api-example-post"></a>

**Escenario:** enviar un nuevo ticket de soporte a un sistema de tickets externo

**Configuración:**
+ **ID del conector de acción Q:** rest-api-connector-tickets
+ **Método HTTP:** POST
+ **URI:** `/tickets`
+ **Encabezados adicionales:**

  ```
  Content-Type: application/json
  Accept: application/json
  ```
+ **Cuerpo de la solicitud:**

  ```
  {
    "title": "{{ticketTitle}}",
    "description": "{{ticketDescription}}",
    "priority": "{{ticketPriority}}",
    "requestedBy": "{{userEmail}}",
    "category": "technical_support"
  }
  ```
+ **Variable de salida:** `ticketResponse`