...
- Na página Aplicativos conectados , clique em Criar operação , como mostrado abaixo.
A página Criar operação é exibida, como mostrado abaixo.
- Na guia Detalhes da operação , informe o Nome da operação.
- O sistema exibe automaticamente o Domínio da habilidade padrão do tenant.
- O URI (Uniform Resource Identifier - Identificador de Recurso Uniforme) é usado para se referir ao recurso de informações. Insira o URI.
- Selecione o método da operação. Ele usa uma estrutura de encadeamento de solicitação de API para que os bots enviem ou solicitem dados dos sites, sistemas e aplicativos web usando serviços web.
Os seguintes métodos de operação estão disponíveis:- Get: para recuperar dados
- Post: para criar dados
- Put: para editar os dados
- Delete: para excluir os dados
- Patch: para fazer atualizações parciais no recurso
- O sistema exibe automaticamente a operação suportada conforme invoca a API REST.
- Especifique o Tempo limite (em milissegundos), isto é, por quanto tempo esperar por uma resposta do serviço web ao invocar uma solicitação de saída. O valor padrão é 10000 milissegundos, 10 segundos, e o valor máximo permitido é de 3 minutos, 180000 milissegundos.
- Clique em Avançar para especificar os detalhes da Configuração da solicitação .
A página Configuração da solicitação é solicitação é exibida, como mostrado abaixo. 
- Parâmetros de caminho: o parâmetro de caminho faz parte de um segmento de caminho que ocorre após seu nome. Os parâmetros de caminho oferecem uma oportunidade única de substituir dinamicamente os valores e passá-los no URL. Por exemplo, http://myserver.com/some-path/{parameter1}/path-continued/{parameter2}. É possível substituir a configuração definida no nível de instância ou continuar usando a mesma e talvez seja necessário adicionar valores e variáveis específicos da operação.
- Insira o Campo externo e o Valor.
- Parâmetros de consulta: os parâmetros de consulta, às vezes, são chamados de parâmetros opcionais. Os parâmetros de consulta são separados dos parâmetros hierárquicos pelo ponto de interrogação. Os parâmetros de consulta são exibidos no URL após o ponto de interrogação (
?) depois do nome do recurso. https://myserver.com/resource-name?param1=value1¶m2=value2. É possível substituir a configuração definida no nível de instância ou continuar usando a mesma e talvez seja necessário adicionar valores e variáveis específicos da operação.- Insira o Campo externo e o Valor.
- Cabeçalhos: cabeçalhos são, em sua maioria, classificados como cabeçalhos de solicitação. Será necessário definir os cabeçalhos de solicitação quando você estiver enviando a solicitação. É possível substituir a configuração definida no nível de instância ou continuar usando a mesma e talvez seja necessário adicionar valores e variáveis específicos da operação.
- Insira o Campo externo e o Valor.
Os cabeçalhos de amostra a seguir são os mais encontrados.- Autorização: inclui credenciais contendo as informações de autenticação do cliente para o recurso que está sendo solicitado.
Accept-Charset: esse é um cabeçalho que é definido com a solicitação e informa o servidor sobre quais conjuntos de caracteres são aceitáveis pelo cliente.
Content-Type: indica o tipo de mídia (texto/HTML, texto/JSON, XML/personalizado ou multipart/form-data) da resposta enviada ao cliente pelo servidor. Isso ajudará o cliente a processar o corpo da resposta corretamente.
Info - Use multipart/form-data como Content-Type para enviar um arquivo de anexo ao servidor do cliente.
- Se você deseja substituir as configurações do cabeçalho global definidas no nível da instância, selecione Ignorar cabeçalhos globais. Assim, o sistema vai considerar as configurações definidas no nível de operação. Da mesma forma, você também pode substituir o parâmetro de caminho e o parâmetro de consulta.
- Insira o Campo externo e o Valor.
- Carga de saída: a carga de solicitação precisa ser transmitida para conclusão da solicitação. FormData é a codificação padrão que um formulário da web usa para transferir dados. A área da caixa de texto aceita pares de chave-valor simples e JSON complexo/aninhado.
Para enviar um anexo como carga de saída, use Mapeamento de anexo. Insira um campo externo e selecione um atributo com o tipo de dado Arquivo como Valor.
- Clique em Avançar para criar a Configuração de resposta.
...
| Info |
|---|
|
Tratamento de erros
Essa seção é usada para definir o comportamento e a resposta do bot para o usuário quando a execução da operação resulta em um erro. Você pode criar várias regras de tratamento de erros a partir das operações de serviço web.
...
- No menu Tenant , clique em Integrações.
- Todos os aplicativos conectados são listados como mostrado abaixo, onde a opção de edição está disponível.
- Clique no botão Editar
. A página Aplicativo conectado é exibida. 
- Aqui, podemos editar os detalhes como tipo de integração, instância padrão, operação de logon e operação de logoff.
As operações de logon e logoff são úteis quando uma funcionalidade/operação exige uma condição de pré-logon e pós-logoff.
Por exemplo, as operações de logon e logoff podem ser usadas para controle de sessão. Ao executar uma operação por meio de uma habilidade, a operação de logon geraria um token e reservaria a sessão. Após a conclusão da tarefa, a operação de logoff vai liberar a sessão. Isso garante a utilização ideal das sessões alocadas ao usuário da API.
Depois que as operações necessárias forem selecionadas, clique no botão Atualizar para salvar as alterações.
...