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

Modo de foco

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

AWS CLI API do Amazon Chime AWS SDK for Java

Aviso de fim do suporte: em 20 de fevereiro de 2026, AWS encerrará o suporte para o serviço Amazon Chime. Depois de 20 de fevereiro de 2026, você não poderá mais acessar o console do Amazon Chime ou os recursos do aplicativo Amazon Chime. Para obter mais informações, acesse a postagem do blog. Nota: Isso não afeta a disponibilidade do serviço Amazon Chime SDK.

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á.

Depois de criar uma ID de chatbot para sua conta empresarial do Amazon Chime, configure o endpoint de saída para o Amazon Chime usar para enviar mensagens ao seu bot. O endpoint de saída pode ser um AWS Lambda ARN de função 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 chat 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 do Lambda ou um endpoint HTTPS de saída.

anchor anchor


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

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



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

API do Amazon Chime

Para configurar o endpoint de saída do seu chatbot, use a operação da API Amazon Chime na Amazon Chime PutEventsConfigurationAPI Reference. Configure um ARN da função do 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 útil 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.

anchor anchor



               HTTPS POST 

               JSON Payload:
               {
                  "Challenge":"00000000000000000000",
                  "EventType" : "HTTPSEndpointVerification"
               }

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

AWS SDK for Java

O código de exemplo a seguir demonstra como configurar um endpoint usando o AWS SDK for 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):