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:
O modelo de autenticação é semelhante ao utilizado nas chamadas das rotas de open api.
Necessário obter o X-SERVER (https://lecomsa.readme.io/reference/obter-x-server-do-seu-ambiente )
Necessário obter apikey (https://lecomsa.readme.io/reference/obter-chave-key )
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.
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.
Adicionar Comentário