Premissas:
Para utilizar alguns recursos do Zapier dentro do Microsoft Teams é necessário a instalação do plugin.
Na mensagem de texto deve conter palavras-chaves que serão utilizadas para configuração da integração.
No aplicativo no Microsoft Teams vá até aplicativo e procure por Zapier.
Para o exemplo que vamos apresentar precisamos criar canais dentro de equipes.
Vá até opção de equipes, e crie um canal que será utilizado para comunicação com Zapier.
Configurando o Zapier:
Vamos configurar uma integração para que toda vez que seja enviado uma nova mensagem no canal do Microsoft Teams, seja criado então aberto uma nova instancia de processo na Plataforma Lecom.
Na ferramenta Zapier, crie um “Zaps"
...
Vamos iniciar configurando um novo gatilho “Trigger”
Na sessão de Setup:
Inserir um novo gatilho “Trigger”: Microsoft Teams
Selecionar o evento de gatilho “Trigger event”: “New Channel Message”
Incluir a conta de autenticação com Teams
...
Na sessão de Configure:
Selecionar a equipe da conta do Teams
Selecionar o canal a ser utilizado na integração
...
Na sessão Test;
Nesse momento o Zapier realiza o teste com as configurações realizada e retorna alguns valores. Essas informações variam conforme a ferramenta seleciona, no caso do Teams esse é um exemplo de dados que são retornados que poderão ser utilizados em uma nova etapa.
Caso ocorra qualquer erro, os dados não serão retornados e um erro será apresentado. Nesse caso é preciso revisar as configurações dos passos anteriores.
...
Vamos agora incluir uma ação com a ferramenta integrada do próprio Zapier
Esse componente é um componente de IA que irá pegar os valores do conteúdo do e-mail e retornar os campos com valores para abertura da instancia de processo na plataforma Lecom.
Sessão Setup:
Incluir em App: AI by Zapier
Incluir Action event: Analyze and Return Data
...
Sessão Configure:
No campo de prompt, vamos selecionar o conteúdo (Body Plain) do e-mail e vamos antes adicionar a instrução para remover conteúdo HTML.
Em Output Fields, vamos criar os campos de saída pegando o valor das palavras chaves.
Importante: O nome de saída dos campos, podem ser configurados conforme achar adequado. Na descrição a consulta deve seguir “value *palavra-chave*”, pois é dessa forma que o componente irá tratar os dados para montar o valor de saída.
Segue exemplo abaixo:
...
Sessão Test:
Na aba de Data in, será apresentado os campos configurados.
Na aba de Data out, será apresentado os campos configurados para saída.
Perceba que os campos recebem os valores contidos na mensagem de texto.
...
Vamos agora configurar a nossa ação “Action”
Na sessão setup:
Inserir a ação Plataforma Lecom
Selecione o evento da ação “Action event”: Open Process
Insira os dados de autenticação da plataforma:
...
Pré-requisito:
Antes de iniciar a configuração no Zapier, é necessário instalar o plugin do Microsoft Teams. Siga os passos abaixo:
Passo 1: Acessar a Loja de Aplicativos do Teams
No menu lateral esquerdo, clique em “Apps”
Passo 2: Buscar o Plugin Zapier
Utilize a barra de pesquisa para encontrar o plugin
Passo 3: Instalar o Plugin
Clique em “Adicionar” para instalar o plugin no seu Teams.
Siga as instruções na tela para concluir a instalação
Passo 4: Configurar o Plugin
Após a instalação, você pode precisar configurar o plugin. Siga as instruções fornecida pelo plugin para configurá-lo de acordo com a necessidades.
...
Configuração Zapier:
Passo 1: Criar uma Conta no Zapier
Acesse o site do Zapier e crie uma conta ou faça o login se já tiver uma.
Passo 2: Criar um Novo Zap
No painel do Zapier, clique em “Zaps”
...
Passo 3: Configurar o Trigger (Microsoft Teams)
Escolha o App e Evento:
Selecione Microsoft Teams como o aplicativo.
Escolha o evento que deseja usar como gatilho, como “New Channel Message”
Conectar a Conta:
Conecte sua conta do Microsoft Teams ao Zapier.
...
Configurar o Trigger:
Selecione o canal que deseja monitorar.
...
Passo 4: Configurar a Ação (Lecom)
Escolha o App e Evento:
Selecione Lecom como aplicativo.
Escolha a ação desejada, como “Open Process”.
Conectar a conta:
Conecte sua conta Lecom utilizando a apikey e o X_Server.
Obter X_Server: https://lecomsa.readme.io/reference/obter-x-server-do-seu-ambiente
...
...
Obter apikey
...
...
...
Na sessão configure:
Vamos agora definir qual é a instancia de processo que iremos abrir na plataforma.
Os dados podem ser preenchidos manualmente, más também os valore podem ser vinculados com dados do item anterior.
Nesse caso você pode realizar tratamentos utilizando os próprios recursos do Zapier para incluir fluxos alternativos etc.
Os campos obrigatórios devem ser preenchidos:
Process ID – mesmo valor utilizado nas rotas de open api
Version – mesmo valor utilizado nas rotas de open api
Language – mesmo valor utilizado nas rotas de open api. Esse campo é selecionável.
Os campos opcionais (Test mode e Test user) são dinâmicos, ou seja, caso selecione o campo Test mode igual a sim, então o campo Test user será apresentado para caso queira preencher.
...
Na sessão test:
Na aba Data in, serão apresentados os dados preenchidos na configuração e que serão utilizados para realizar a chamada de integração.
...
Na aba Data out, será apresentado o resultado de retorno caso a ação seja realizada com sucesso.
| Nota |
|---|
Importante! O Zapier para garantir o funcionamento no momento do teste, realiza uma chamada real para plataforma. Dessa forma o processo identificado no resultado do teste irá aparecer na plataforma como aberto. Nesse caso o indicado que entre na plataforma e cancele caso não veja a utilização para ele. |
...
Após isso essa etapa, já se torna possível a publicação da integração.
Caso não tenha ocorrido corretamente alguma configuração nas etapas anteriores um erro será apresentado. Será necessária uma revisão no dado preenchido.
...
Configurar a Ação:
Estático: Selecione na lista o processo que será utilizado fixo para essa integração.
...
Custom: Customize o campo para que receber o valor necessário para realizar a ação criando assim uma integração dinâmica. Para este exemplo de abertura de processo, o valor a ser recebido deve ser o ID do processo.
...
Passo 5: Testar e Ativar o “Zap”
Execute um teste para garantir que os dados estão sendo enviados corretamente para Plataforma Lecom.
Ações realizadas como processo de teste no Zapier serão aplicadas no ambiente configurado, ou seja, um teste de abertura de processo irá abrir uma nova instância de processo na Plataforma Lecom.