Usar variáveis em habilidades

O sistema contém muitos tipos diferentes de variável que podem ser usados em habilidades para uma mensagem, uma regra, um processamento ou uma integração. Este artigo aborda como e quando essas variáveis podem ser usadas e, sobretudo, o respectivo formato.

As variáveis podem ser usadas nos cenários a seguir:

Executar serviços web
Substituir serviços web em atributos
Substituir serviços web no processamento de habilidades
Definir respostas de texto da habilidade

Veja a seguir uma lista dos parâmetros e cenários nos quais elas são usadas.

Tipos de variável	Descrição	Exemplos	Variáveis OOTB (Out-of-the-Box - Prontas para Uso)
Atributo global	Os atributos globais armazenam dados extraídos da entrada do usuário, operações de integração de terceiros, respostas e muito mais. Os atributos globais são usados como espaços reservados em modelos de mensagem do usuário, regras, integrações, fluxos de trabalho de ação e mais.	@{global.<attributeIdentifier>} Por exemplo, @{global.itsm_ticketDescription} é usado para armazenar a descrição do ticket do ITSM, extraído da entrada do usuário.	@{global.itsm_instanceId} @{global.itsm_ticketDescription} @{global.itsm_ticketType}
Atributo local	Os atributos locais são usados para armazenar dados temporariamente durante a vida útil de uma habilidade ou operação. Diferentemente de um atributo global, que é válido para toda a sessão do usuário, um atributo local não está disponível fora da habilidade ou operação em que foi definida. Os atributos locais são usados como um espaço reservado em modelos de mensagem do usuário e regras no fluxo de trabalho de ação.	@{local.<localAttributeName>} Por exemplo, @{local.ticketId} é usado para armazenar a ID do ticket.	@{local.ticketId}
Atributo de usuário personalizado	Atributos de usuário personalizados armazenam Atributos de perfil do usuário definidos por um administrador de sistema. Geralmente, eles armazenam informações, como departamento, local, status VIP e muitas outras que as habilidades podem usar para regras e ramificação. Os atributos de usuário personalizados são usados como espaços reservados em modelos de mensagem do usuário, regras e muitos mais.	@{user.<userProfileAttributeName>} Por exemplo, @{user.firstName} é usado para armazenar o nome do usuário no canal atual.	@{user.firstName} @{user.middleName} @{user.lastName} @{user.email} @{user.userName} @{user.id} @{user.phone} @{user.timezone} @{user.title} @{user.contactExternalId} @{user.roleIds} @{user.roleNames} @{user.groupIds} @{user.groupNames} @{user.languageLocale} @{user.languageName} @{user.languageDisplayName} @{user.languageCode} Parâmetros de integração externos: @{user.location} @{user.employee id}
Atributo de canal	Um atributo de canal é usado para autenticar o usuário com base no canal usado para interagir com o bot. Ele armazena os detalhes de autenticação do usuário.	@{channel.<channelAttribute>} Por exemplo, @{channel.channelType} é usado para armazenar o tipo de canal atual, por exemplo, o WeChat.	@{channel.channelScopeContactId} @{channel.channelType} @{channel.channelAuthenticationId} @{channel.channelAuthenticationStatus} @{channel.channelAuthenticationMode}
Atributo de bot	Os atributos de bot armazenam os atributos específicos do bot atual.	@{bot.<botAttribute>} Por exemplo, @{bot.name} é usado para armazenar o nome do bot atual.	@{bot.name} @{bot.externalId} @{bot.symbol} @{bot.id} @{bot.languageLocales} @{bot.languageNames} @{bot.languageDisplayNames} @{bot.languageCodes}
Atributos de configuração da instância do aplicativo conectado	Os atributos de configuração da instância do aplicativo conectado armazenam os parâmetros configurados na instância do aplicativo conectado. Eles são utilizados como espaços reservados em modelos de mensagem do usuário, regras, integrações, fluxos de trabalho de ação e assim por diante.	@{app.<parameterName>} Por exemplo, @{app.headers.user_auth_token} é usado para armazenar o token de autenticação do usuário durante a integração do serviço web.	@{app.apiBaseUrl} @{app.headers.csm_app_url} @{app.headers.user_auth_token}
Solicitação HTTP da operação do aplicativo conectado	Esse atributo contém os valores das solicitações HTTP enviadas para outros sistemas.	@{solicitação.<parametername>} Por exemplo, @{request.timeout} é usado para o tempo limite da solicitação em uma chamada de API durante uma conversa do bot.	@{request.requestUri} @{request.method} @{request.requestUrl} @{request.headers.<headerName>} @{request.path.<pathParameterName>} @{request.query.<queryParameterName>} @{request.soapBinding} @{request.soapOperation} @{request.soapEndPoint} @{request.timeout} @{request.body}
Resposta HTTP da operação do aplicativo conectado	Esse atributo contém os valores das respostas HTTP recebidas de outros sistemas.	@{response.<parametername>} Por exemplo, @{response.statusCode} é usado para exibir o código de status da resposta em uma chamada de API durante uma conversa do bot.	@{response.statusCode} @{response.protocolVersion} @{response.reasonPhrase} @{response.statusLine} @{response.headers.<headerName>} @{response.body}