Paso 2: Configurar el punto de conexión de salida de un chatbot de Amazon Chime - Amazon Chime
AWS CLIAPI de Amazon ChimeSDK de AWS para Java

Debe ser administrador del sistema Amazon Chime para completar los pasos de esta guía. Si necesita ayuda con el cliente de escritorio, la aplicación web o la aplicación móvil de Amazon Chime, consulte Obtener asistencia en la Guía del usuario de Amazon Chime.

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.

Paso 2: Configurar el punto de conexión de salida de un chatbot de Amazon Chime

Después de crear un ID de chatbot para su cuenta corporativa de Amazon Chime, configure el punto de conexión de salida para que Amazon Chime lo utilice para enviar mensajes a su bot. El punto de conexión de salida puede ser un ARN de función de AWS Lambda o un punto de conexión HTTPS que haya creado como parte de los requisitos previos. Para obtener más información acerca de Lambda, consulte la Guía para desarrolladores de AWS Lambda.

nota

Si el punto de conexión HTTPS de salida para su bot no está configurado o está vacío, los administradores de salas de chat no pueden añadir el bot a una sala de chat. Además, los usuarios de la sala de chat no pueden interactuar con el bot.

AWS CLI

Para configurar un punto de conexión de salida para su chatbot, utilice el comando put-events-configuration de AWS CLI. Configure un ARN de función de Lambda o un punto de conexión HTTPS de salida.

Lambda ARN
aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --lambda-function-arn arn:aws:lambda:us-east-1:111122223333:function:function-name
HTTPS endpoint
aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --outbound-events-https-endpoint https://example.com:8000

Amazon Chime responde con el ID del bot y el punto de conexión HTTPS.


{
    "EventsConfiguration": {
        "BotId": "BotId", 
        "OutboundEventsHTTPSEndpoint": "https://example.com:8000"
    }
}

API de Amazon Chime

Para configurar el punto de conexión de salida del chatbot, utilice la operación de la API PutEventsConfiguration de Amazon Chime en la Referencia de la API de Amazon Chime. Configure el ARN de una función de Lambda o un punto de conexión HTTPS de salida.

  • Si configura el ARN de una función de Lambda, Amazon Chime llama a Lambda para añadir un permiso que permita a la cuenta de AWS del administrador de Amazon Chime invocar el ARN de función de Lambda proporcionado. Esto va seguido de una invocación de simulacro para verificar que Amazon Chime tenga permiso para invocar la función. Si la adición de permisos o la invocación de simulacro devuelven un error, la solicitud PutEventsConfiguration devuelve un error HTTP 4xx.

  • Si configura un punto de conexión HTTPS de salida, Amazon Chime verifica su punto de conexión enviando una solicitud HTTP Post con una carga útil Challenge JSON al punto de conexión HTTPS de salida que proporcionó en el paso anterior. El punto de enlace HTTPS saliente debe responder devolviendo el parámetro Challenge en formato JSON. Los siguientes ejemplos muestran la solicitud y una respuesta válida.

    Request
    
               HTTPS POST 

               JSON Payload:
               {
                  "Challenge":"00000000000000000000",
                  "EventType" : "HTTPSEndpointVerification"
               }
    Response
    
               HTTP/1.1 200 OK
               Content-type: application/json

               {
                   "Challenge":"00000000000000000000"
               }

    Si el enlace por desafío mutuo devuelve un error, entonces la solicitud PutEventsConfiguration devuelve un error HTTP 4xx.

SDK de AWS para Java

En el siguiente código de ejemplo, se muestra cómo configurar un punto de conexión mediante el SDK de AWS para Java.

PutEventsConfigurationRequest putEventsConfigurationRequest = new PutEventsConfigurationRequest()
     .withAccountId("chimeAccountId")
     .withBotId("botId")
     .withOutboundEventsHTTPSEndpoint("https://www.example.com")
     .withLambdaFunctionArn("arn:aws:lambda:region:account-id:function:function-name");

 chime.putEventsConfiguration(putEventsConfigurationRequest):