Vamos realizar a configuração para que quando receba um determinado e-mail contendo uma informação chave, seja aberto uma nova instância de processo na Plataforma Lecom.
Premissas:
No corpo do e-mail, deve conter palavras-chave que possam ser utilizados para configuração da integração.
No exemplo abaixo utilizaremos as palavras “processo”, “versão” e “modo teste”
Na sessão Setup deve-se seguir os seguintes passos:
Incluir App Gmail
Incluir Trigger event: New Email Matching Search
Account: realizar o login na conta do Gmail
...
Na sessão de configuração deve-se:
No campo Search keywords deve ser preenchido o critério de e-mail.
Nesse caso estamos usando “Abrir novo processo”
...
Para esse caso então, um e-mail com assunto abrir novo processo será recebido, contendo as palavras-chave no seu conteúdo.
...
Na sessão test:
Será apresentado os registros conforme o critério do passo anterior, contendo as informações do conteúdo do e-mail.
Caso não apresente nenhum registro, isso pode ser que não existe nenhum e-mail atendendo o critério configurado ainda na sua caixa de entrada.
...
Vamos agora incluir uma ação com a ferramenta integrada do próprio Zapier
Esse componente é um componente de IA que mapeará os valores do conteúdo do e-mail e retornar os campos com valores para abertura da instancia de processo na Plataforma Lecom.
Na sessão Setup deve-se:
Incluir em App: AI by Zapier
Incluir Action event: Analyze and Return Data
...
Na sessão Configure:
No campo de prompt, vamos selecionar o conteúdo (Body Plain) do e-mail.
Em Output Fields, vamos criar os campos de saída pegando o valor das palavras chaves.
| Nota |
|---|
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. |
Observe o exemplo abaixo:
...
Na 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 o valor contidos no conteúdo do e-mail.
...
Vamos agora inserir a ação da Plataforma Lecom
Sessão Setup:
Incluir App: Plataforma Lecom
Action event: Open Process
Account: Realizar autenticação na plataforma (semelhante ao item do Microsoft Teams)
...
Sessão Configure:
Vamos vincular os valores da ação anterior conforme os valores correspondentes a sua configuração.
O campo Test Mode, deve ser alterado para opção custom para que seja possível utilizar o valor do item anterior.
...
Sessão Test:
Na aba Data in será apresentado os dados configurados:
...
Na aba Data out será apresentado os dados do processo aberto:
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.
...
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 (Gmail)
Escolher o App e Evento:
Selecione Gmail como aplicativo.
Escolha evento que deseja usar como gatilho, como “New Email Matching Search”.
Conectar a conta:
Conecte a sua conta do Gmail ao Zapier.
...
Configurar o Trigger
Digite o critério de validação para o Email
...
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: https://lecomsa.readme.io/reference/obter-chave-key
...
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.