Etapa 2: Configure o endpoint de saída para um chatbot do Amazon Chime - Amazon Chime
AWS CLIAmazon Chime APIAWS SDK para Java

Você deve ser administrador do sistema Amazon Chime para concluir as etapas deste guia. Se você precisar de ajuda com o cliente de desktop, a aplicação web ou aplicativo móvel do Amazon Chime, consulte Getting support no Guia do usuário do Amazon Chime.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Etapa 2: Configure o endpoint de saída para um chatbot do Amazon Chime

Depois de criar uma ID de chatbot para sua conta Amazon Chime Enterprise, configure seu endpoint de saída para o Amazon Chime usar para enviar mensagens para seu bot. O endpoint de saída pode ser um ARN de função AWS Lambda ou um endpoint HTTPS que você criou como parte dos pré-requisitos. Para obter mais informações sobre o Lambda, consulte o Manual do desenvolvedor do AWS Lambda.

nota

Se o endpoint HTTPS de saída para seu bot não estiver configurado ou estiver vazio, os administradores de sala de chat não poderão adicionar o bot a uma sala de chat. Além disso, os usuários da sala de bate-papo não podem interagir com o bot.

AWS CLI

Para configurar um endpoint de saída para seu chatbot, use o comando put-events-configuration no AWS CLI. Configure um ARN da função Lambda ou um endpoint HTTPS de saída.

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

O Amazon Chime responde com o ID do bot e o endpoint HTTPS.


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

Amazon Chime API

Para configurar o endpoint de saída do seu chatbot, use a operação da API Amazon Chime PutEventsConfiguration na Amazon Chime API Reference. Configure um ARN da função Lambda ou um endpoint HTTPS de saída.

  • Se você configurar um ARN de função do Lambda – o Amazon Chime chama o Lambda para adicionar permissão para permitir que a conta AWS do administrador do Amazon Chime invoque o ARN da função Lambda fornecida. Isso é seguido por uma invocação de simulação para verificar se o Amazon Chime tem permissão para invocar a função. Se houver falha na adição das permissões ou na invocação da simulação, a solicitação PutEventsConfiguration retornará um erro HTTP 4xx.

  • Se você configurar um endpoint HTTPS – o Amazon Chime verifica o endpoint enviando uma solicitação HTTP Post com uma carga JSON do Challenge para o endpoint HTTPS de saída que você forneceu na etapa anterior. Seu endpoint HTTPS de saída deve responder repetindo o parâmetro do Challenge no formato JSON. Os exemplos a seguir mostram a solicitação e uma resposta válida.

    Request
    
               HTTPS POST 

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

               {
                   "Challenge":"00000000000000000000"
               }

    Se houver falha no handshake do Challenge, a solicitação PutEventsConfiguration retornará um erro HTTP 4xx.

AWS SDK para Java

O código de exemplo a seguir demonstra como configurar um endpoint usando o SDK for Java da AWS.

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):