Agregar configuración a acciones personalizadas para integraciones

Nota: Este artículo se aplica a las integraciones de acciones de datos de AWS Lambda, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, servicios web y Zendesk.

Al crear una acción personalizada, primero agregue contratos y luego agregue la configuración. La configuración define cómo la acción implementa los contratos. Para más información, ver Crea una acción personalizada y Agregar contratos a acciones personalizadas.

Nota: Puede modificar la configuración después de publicar la acción. Para más información, ver Modificar la configuración en acciones personalizadas.

Haga clic en el Configuración pestaña.
Seleccione el método HTTP.
Debajo Solicitud, configure la solicitud que la acción envía al servicio web. Genesys recomienda configurar la solicitud utilizando los campos debajo Sencillo.
Propina: Haga clic en las propiedades debajo de Entradas disponibles para copiarlos y pegarlos rápidamente en la solicitud. Estas propiedades provienen de su contrato de entrada. Para más información, ver Agregar contratos a acciones personalizadas. Puede utilizar macros con las plantillas. Para más información, ver Macros de velocidad para acciones de datos.

Ingrese información para los campos que aparecen. Los campos que aparecen varían según el método HTTP seleccionado y los contratos agregados.
Notas:
- Para las integraciones de acciones de datos de AWS Lambda y Google Cloud Functions, consulte la siguiente sección Configuraciones de solicitudes especiales.
- Los objetos JSON excesivamente anidados pueden afectar al rendimiento del servicio de acción de datos. Para mantener el rendimiento, la profundidad de los objetos JSON se limita a 50 niveles. Para obtener más información, consulte Limits en el Centro de desarrollo de Genesys Cloud.
Solicitar plantilla de URL
Colocar Solicitar plantilla de URL al punto final remoto al que llega su solicitud HTTP.
Encabezados (Opcional)
Pares clave-valor que se agregan como encabezados HTTP en la solicitud que se envía al extremo remoto.
Nota: Si está configurando el encabezado Aceptar, debe usar un tipo de medio JSON como valor del encabezado.
Transferencia de codificación
Si su servicio web no es compatible Codificación de transferencia ajustado a troceado, agregar Codificación de transferencia: amortiguado debajo encabezados. Para más información, ver La acción personalizada falla por un motivo inesperado.
Autorización
Puede incluir información de autorización en la configuración de la solicitud. Para más información, ver Cómo utilizar el tipo de credencial definido por el usuario y Cómo utilizar el tipo de credencial definida por el usuario (OAuth).

Configuración de solicitud especial

La configuración de solicitud para acciones personalizadas que están asociadas con las integraciones de acciones de datos de Adobe o AWS Lambda o que ejecutan las funciones de Google Cloud varían de la configuración de solicitud estándar para servicios web.

Solicitar plantilla de URL
Colocar Solicitar plantilla de URL al ARN de su función AWS Lambda. Para más información, ver Cree recursos de IAM para invocar funciones de AWS Lambda.
tipo de solicitud
Colocar Solicitud Escribe para CORREO. Este método HTTP garantiza que la acción envíe cualquier cuerpo de solicitud con la configuración de la solicitud.
Encabezados
Pares clave-valor que se agregan a un personalizado mapa en el clientContext objeto. los clientContext el objeto es a su vez un valor en la invocación contexto objeto. Si existen los siguientes atributos, se establecen automáticamente en el contexto objeto:
- ID-organización-ININ
- ININ-Home-Organization-Id
- ID de correlación ININ
- ID de usuario ININ
- ID de integración ININ
Para un ejemplo de Java del clientContext objeto, ver Interfaz ClientContext.
Solicitar plantilla
Cualquier valor que especifique en Solicitar plantilla estará disponible en el evento parámetro de la función AWS Lambda invocada.

Solicitar plantilla de URL
Colocar Solicitar plantilla de URL al punto final remoto al que llega su solicitud HTTP.
tipo de solicitud
Colocar Solicitud Escribe para CORREO. Este método HTTP garantiza que la acción envíe cualquier cuerpo de solicitud con la configuración de la solicitud.
Encabezados
Pares clave-valor que se agregan a un personalizado mapa en el clientContext objeto. los clientContext el objeto es a su vez un valor en la invocación contexto objeto. Si existen los siguientes atributos, se establecen automáticamente en el contexto objeto:
- ID-organización-ININ
- ININ-Home-Organization-Id
- ID de correlación ININ
- ID de usuario ININ
Para un ejemplo de Java del clientContext objeto, ver Interfaz ClientContext.
Solicitar plantilla
Cualquier valor que especifique en Request Template estará disponible en el parámetro event de la función AWS Lambda invocada. El clientContext tiene límites de longitud y no se puede utilizar para pasar certificados necesarios para las acciones de datos de Genesys Cloud Function. Para incluir los certificados configurados en credenciales, utilice el cuerpo de la plantilla de solicitud que no tiene restricciones de tamaño.

Solicitar plantilla de URL
Colocar Solicitar plantilla de URL a la ubicación de Google Cloud Function que desea que ejecute la acción de datos: https://{location-of-function}-{project-owning-function}/{function-name}.
tipo de solicitud
Colocar Solicitud Escribe para CORREO.
Solicitar plantilla
Establezca Plantilla de solicitud a ${input.rawRequest}.

Para obtener una explicación detallada de las partes de la solicitud, consulte Solicitar configuración para acciones de datos.

Usuarios avanzados (JSON)

Las personas con conocimientos sobre JSON pueden usar la opción de entrada JSON. Utilice solicitudes en otras acciones o el siguiente ejemplo como guía para crear JSON.

{
  "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}

Debajo Respuesta, agregue la configuración JSON.
La configuración JSON define cómo se procesa la respuesta del servicio web o la función AWS Lambda.

Puede utilizar la respuesta en otras acciones o el siguiente ejemplo como guía para crear el JSON. Para obtener más información sobre el uso de macros con la plantilla de éxito, consulte Macros de velocidad para acciones de datos.

Propina: Haga clic en las propiedades debajo de Salidas disponibles para copiarlos y pegarlos rápidamente en la respuesta. Estas propiedades provienen de su contrato de salida. Para más información, ver Agregar contratos a acciones personalizadas.
```
{
      "translationMap": {
          "buildNumber": "$.Build-Version",
          "serviceName": "$.name",
          "status": "$.Status"
      },
      "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
 }
```
Para obtener una explicación detallada de las partes de la respuesta, consulte Configuración de respuesta para acciones de datos.

A continuación, añada la función para Genesys Cloud Function. Para otras acciones de datos, prueba la acción en busca de errores de validación y ejecución.

Para más información, ver Acerca de las acciones personalizadas para integraciones.

Para obtener más información sobre las integraciones, consulte Acerca de las integraciones de acciones de datos.