Como integrar o Gemini ao Jira de graça, usando Google Tasks e Apps Script

Crie um fluxo de automação poderoso para transformar suas ideias em tarefas acionáveis, sem gastar nada com APIs


1. Introdução: O Problema e a Solução Criativa

  • O problema: Você está em uma conversa com o Gemini, surge uma ideia brilhante ou um bug é identificado. O processo de parar, abrir o Jira e criar o card manualmente quebra seu fluxo de trabalho e pode fazer com que boas ideias se percam.

  • A limitação: A API do Gemini (Google AI) pode ter custos associados e uma curva de aprendizado. Para uma tarefa simples como criar um card no Jira, podemos usar uma abordagem mais direta e gratuita. O Gemini App por padrão, não integra com o Jira, apenas com ferramentas do Google Workspace.

  • A solução: Vamos construir uma "ponte" entre o Gemini e o Jira usando ferramentas que você provavelmente já usa: Google Tasks e Google Apps Script. Com um simples comando de voz ou texto para o Gemini, uma tarefa será criada no Jira automaticamente.


2. A Arquitetura da Nossa Integração

Explique o fluxo de dados de forma simples. Uma imagem/diagrama aqui seria perfeita.

  1. Você & Gemini: Você pede ao Gemini para criar uma tarefa. Ex: "Lembre-me de corrigir o bug de login na home".

  2. Gemini & Google Tasks: O Gemini, por meio da sua integração nativa, cria um item no Google Tarefas.

  3. Google Apps Script (O Cérebro): Um script agendado roda a cada 5 minutos, buscando por novas tarefas em uma lista específica do Google Tasks.

  4. Apps Script & Jira API: Ao encontrar uma nova tarefa, o script formata os dados e chama a API REST do Jira para criar um novo "issue" (tarefa, bug, etc.) no seu projeto.

  5. Limpeza: Após criar o card no Jira, o script marca a tarefa no Google Tasks como concluída, para não ser processada novamente.

Vantagens desta abordagem:

  • Custo Zero: Utiliza apenas os planos gratuitos do Google e Jira.

  • Serverless: Não há necessidade de gerenciar servidores. O Google Apps Script cuida de tudo.

  • Simplicidade: A autenticação com as APIs do Google é simplificada dentro do Apps Script.


3. Pré-requisitos: O que Você Vai Precisar


4. Passo a Passo: Construindo a Ponte

Passo 1: Habilite a extensão do google tarefas no Gemini

Passo 2: Obtenha a Chave de Acesso do Jira (API Token)

Passo 3: Escrevendo o Código no Google Apps Script

Passo 4: Agendando a Automação (Triggers)

  • No app script configure para sua função main() executar a cada 5 minutos.


5. Testando e Colocando em Produção

  • Vou deixar a gem pronta pra você usar: https://gemini.google.com/gem/1-nH9qwhGJB2wUN3ZwYEh7PEgQf_iLcO-?usp=sharing

  • Execute a função main manualmente pela primeira vez para verificar a autorização das APIs, use console.log() para testar.

  • Peça ao Gemini para criar uma tarefa de teste. Veja se criou no google tarefas, edite a tarefa para conseguir pegar na execução manual.

  • Se a gem criou no google tarefas, o script manual pegou a tarefa criada e você agendou a execução em intervalos de 5 em 5 minutos, então tudo vai funcionar.