# Guia Integração da Elven Platform ITSM Jira

A integração entre a **Elven Platform** e o Jira permite criar tickets diretamente a partir da tela de incidentes, oferecendo uma solução ágil e integrada para o gerenciamento de incidentes. Com essa funcionalidade, é possível sincronizar as ações realizadas na **Elven Platform** com os tickets do Jira, garantindo que todas as informações fiquem centralizadas e acessíveis para as equipes envolvidas.\
\
Ao abrir um ticket no Jira pela **Elven Platform**, todas as alterações feitas no incidente, como mudanças no status, título, descrição ou atribuições, serão automaticamente refletidas no ticket correspondente. Essa sincronização em tempo real elimina a necessidade de atualizações manuais, reduzindo erros e agilizando o fluxo de trabalho.\
\
Quando um incidente é resolvido na **Elven Platform**, o ticket no Jira também será atualizado automaticamente, indicando a conclusão do problema. Isso garante um registro preciso do ciclo de vida do incidente, facilitando o acompanhamento e a documentação das resoluções.

{% embed url="<https://demo.elven.works/demo/cmd3e147q00i8y80i6xkvxxxf>" %}

## **Acessando a Configuração de Integração do ITSM Jira**

* No canto superior direito da tela, clique no **ícone de perfil**. O ícone pode ser representado por um **avatar** ou a **inicial do seu nome**.
* No menu que será exibido, selecione a opção **Organization Settings**. Essa opção te levará às configurações da sua organização.
* Clique na aba **Integrations**. É aqui que você pode visualizar e gerenciar todas as integrações disponíveis.
* Na opção, **Jira Integration** podemos criar a integração com Jira. Para isso basta abrir o formulário de configuração (**Install new integration**), disponível no corpo dessa opção.&#x20;

## **Criando a Integração com ITSM Jira**

Conectar o **Jira** à **Elven Platform** é mais simples do que parece, e foi pensado justamente para tornar a rotina da sua equipe mais eficiente e integrada. Antes de tudo, é importante que você já tenha um **projeto do tipo Jira Service Management** criado em seu ambiente Jira. Esse projeto será o responsável por receber automaticamente os **tickets gerados pela Elven Platform**. Com o projeto pronto, acesse o **formulário de configuração da integração** e siga estas orientações:

* No campo **Integration name**, escolha um nome que ajude a identificar essa integração facilmente no futuro. Algo que faça sentido para a sua equipe.
* Em **Default Jira Language**, selecione o **idioma padrão** utilizado no seu projeto do Jira, garantindo que os dados sejam interpretados corretamente.
* No campo **Subdomain**, insira apenas o **subdomínio** do seu Jira (a parte que vem antes de **.atlassian.net**). Esse detalhe é essencial para estabelecer a conexão com a plataforma certa.
* Por fim, em **Project Key**, digite o **código do projeto Jira** onde os tickets devem ser criados. Você encontra essa informação dentro das configurações do seu projeto, no próprio Jira.

Com tudo isso preenchido, a integração estará pronta para funcionar, permitindo que os incidentes da **Elven Platform** se transformem automaticamente em tickets dentro do Jira, de forma fluida e centralizada.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F1vQb89c42ytT6zkAhV20%2Fij01.png?alt=media&#x26;token=d21c95c2-902d-413d-9e0b-5da5c6268ead" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FC73UNotlc87kqiK3G59j%2Fij02.png?alt=media&#x26;token=731bddc4-2175-4b7c-8e13-9776c91f0a0f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F8OvUQ5EckqrWOEUmJwti%2Fij03.png?alt=media&#x26;token=1a854d1f-5875-4150-91c6-4f6e1673ad5b" alt=""><figcaption></figcaption></figure>

A autenticação para a integração entre o Jira e a **Elven Platform** é realizada por meio de nome de usuário e token. Para configurar, preencha os campos **Username** e **Api Token**, utilizando o token gerado na página de segurança da sua conta Jira. Após preencher todos os campos obrigatórios, clique em **Save integration** para concluir a configuração. Com isso, a integração estará pronta, permitindo abrir tickets diretamente da tela de incidentes na **Elven Platform** e centralizar a gestão de informações de forma eficiente.&#x20;

Para verificar o **idioma configurado** no **Jira**, localize o seu **projeto** e clique no ícone de **três pontinhos** (**•••**). Em seguida, selecione a opção para acessar as **Configurações do projeto**. Dentro dessa área, procure por **Suporte a idiomas**, ali você verá o **idioma padrão** configurado. Isso garante que a integração com a **Elven Platform** esteja de acordo com as suas **preferências de idioma**.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fey9EG4EXX9yeYnTPoYvu%2Fij04.png?alt=media&#x26;token=e1b5e031-f8a9-491b-969e-4873dc3b1180" alt=""><figcaption></figcaption></figure>

Para obter seu **API Token** de forma simples, clique no seu **avatar** (ou nas suas **iniciais**) e acesse a opção **Configurações da conta**. Em seguida, vá até a aba **Security** e clique em **Create and manage API tokens**. Depois, selecione o botão **Create an API token**. Dê um **nome** para o token, algo que ajude a **identificá-lo no futuro,** e finalize clicando em **Create**. Pronto! Seu **token** foi gerado com sucesso e já está pronto para ser usado na **integração com a Elven Platform**.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FpJoQDRAaRSxsfQAwtVsd%2Fij05.png?alt=media&#x26;token=8ab2d1b0-56ec-4708-9ba9-3fa37fcc9f41" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FieLsDXJRn6QbzUymatOi%2Fij06.png?alt=media&#x26;token=2844458f-6fcc-4132-b811-322d76438ef9" alt=""><figcaption></figcaption></figure>

Se preferir, você pode garantir maior segurança armazenando o token como uma secret. Para isso, basta clicar no ícone de **chave** no campo **Api Token** ao configurar a integração. Assim, você protege suas credenciais e mantém o foco na eficiência e segurança do seu ambiente de trabalho.&#x20;

Além disso, após a conclusão do processo de integração entre **Elven Platform** e o Jira, deverá aparecer sua integração na lista da opção Integration Jira.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fl5413poWJbMdn6jKilMh%2Fij07.png?alt=media&#x26;token=80579814-8c9f-429e-b860-bde744bfb193" alt=""><figcaption></figcaption></figure>

## **Abrindo um Ticket no Jira**

Para criar um ticket no Jira partir da **Elven Platform**, basta localizar o incidente desejado e clicar no botão **Open Ticket** disponível na tela do incidente. Com isso, o ticket será aberto no Jira, mantendo ambas as plataformas alinhadas para uma gestão eficiente.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FxKzRXFMlE5K5DxVWxLCw%2Fj08.png?alt=media&#x26;token=0844a905-82cd-4570-974e-a0cfb3713315" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F769bmAgoRvRMsTBWVFBj%2Fij09.png?alt=media&#x26;token=1078023c-f799-463b-8999-9acd7fc8d9d2" alt=""><figcaption></figcaption></figure>

## **Resolução de Incidente**

Após a resolução do incidente, você pode atualizar o status do ticket no Jira diretamente pela **Elven Platform**. Basta localizar o incidente e clicar no botão **Update Ticket** disponível na tela do incidente. Essa ação sincronizará as informações e moverá automaticamente o ticket para a coluna **ITENS CONCLUÍDOS**, garantindo que o fluxo de trabalho esteja sempre atualizado e alinhado entre as duas plataformas.&#x20;

Essa funcionalidade facilita o acompanhamento do ciclo de vida dos tickets, reduzindo a necessidade de ajustes manuais e proporcionando maior eficiência na gestão de incidentes. Assim, sua equipe pode focar na resolução de problemas, enquanto a **Elven Platform** cuida da organização e da comunicação entre os sistemas integrados.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FMHRnwkvXtA5tClT8fUqJ%2Fij10.png?alt=media&#x26;token=359090a3-410b-4a4d-a6a2-f0b13aea6630" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FoiJIRiGKa0LwjIafiONV%2Fij11.png?alt=media&#x26;token=e82320f9-0ae8-47a9-95cf-720972771e3e" alt=""><figcaption></figcaption></figure>

## **Glossário de Termos Técnicos**

**ITSM (IT Service Management):** Gestão de serviços de TI que organiza e padroniza processos relacionados a incidentes, problemas e solicitações de serviço.&#x20;

**Jira:** Ferramenta de gerenciamento de projetos amplamente utilizada para rastreamento de tarefas, bugs e incidentes.&#x20;

**Integration Name:** Nome da integração configurada na **Elven Platform**, usado para identificá-la facilmente no menu de integrações.&#x20;

**Default Jira Language:** Idioma padrão configurado na instância Jira, que deve ser informado para alinhar a integração com as preferências do usuário.&#x20;

**Subdomain:** Parte do endereço da URL da sua instância Jira, usada para conectar corretamente a **Elven Platform** ao seu ambiente Jira. Exemplo: *subdomínio.atlassian.net*.&#x20;

**Project Key:** Código único do projeto no Jira, necessário para associar os tickets da **Elven Platform** ao projeto correto. Exemplo: “PROJ1”.&#x20;

**Username:** Nome de usuário utilizado para autenticação na integração com o Jira.&#x20;

**API Token:** Token gerado na conta Atlassian do Jira para autenticação segura entre a **Elven Platform** e o Jira.&#x20;

**Security:** Aba nas configurações da conta Atlassian onde você pode criar e gerenciar tokens de API para autenticação.&#x20;

**Open Ticket:** Botão disponível na tela de incidentes da **Elven Platform** para criar um novo ticket no Jira a partir de um incidente identificado.&#x20;

**Update Ticket:** Botão na tela de incidentes da **Elven Platform** que permite atualizar o status de um ticket já criado no Jira, sincronizando as informações e movendo-o para a coluna “ITENS CONCLUÍDOS”.&#x20;

**ITENS CONCLUÍDOS:** Coluna no Jira onde os tickets resolvidos são movidos automaticamente após a atualização do status pela **Elven Platform**.&#x20;

**Secret:** Opção de armazenamento seguro para o API Token durante a configuração da integração, disponível na **Elven Platform**.