Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso. 

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

# GetBotChannelAssociation
<a name="API_GetBotChannelAssociation"></a>

Retorna informações sobre a associação entre um bot do Amazon Lex e uma plataforma de mensagens.

Essa operação exige permissões para a ação `lex:GetBotChannelAssociation`.

## Sintaxe da Solicitação
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
O nome do bot do Amazon Lex.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
O nome da associação entre o bot e o canal. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetBotChannelAssociation_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botConfiguration": { 
      "string" : "string" 
   },
   "botName": "string",
   "createdDate": number,
   "description": "string",
   "failureReason": "string",
   "name": "string",
   "status": "string",
   "type": "string"
}
```

## Elementos de resposta
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
Fornece as informações que a plataforma de mensagens precisa para se comunicar com o bot do Amazon Lex.  
Tipo: mapa de string para string  
Entradas do mapa: número máximo de 10 itens.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
O nome do bot do Amazon Lex.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
A data em que a associação entre o bot e o canal foi criada.  
Tipo: Timestamp

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
A descrição da associação entre o bot e o canal.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha na criação da associação.  
Tipo: string

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
O nome da associação entre o bot e o canal.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
O status do canal do bot.   
+  `CREATED` - O canal foi criado e está pronto para uso.
+  `IN_PROGRESS` - A criação do canal está em andamento.
+  `FAILED` - Houve um erro ao criar o canal. Para obter informações sobre o motivo da falha, consulte o campo `failureReason`.
Tipo: string  
Valores válidos: `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
O tipo da plataforma de mensagens.  
Tipo: string  
Valores válidos: `Facebook | Slack | Twilio-Sms | Kik` 

## Erros
<a name="API_GetBotChannelAssociation_Errors"></a>

 ** BadRequestException **   
A solicitação não está bem formada. Por exemplo, um valor é inválido ou um campo obrigatório está faltando. Verifique os valores dos campos e tente novamente.  
Código de status HTTP: 400

 ** InternalFailureException **   
Ocorreu um erro interno do Amazon Lex. Tente sua solicitação novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
A solicitação excedeu um limite. Tente sua solicitação novamente.  
Código de status HTTP: 429

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation)