> For the complete documentation index, see [llms.txt](https://meloqa.gitbook.io/documentacao-meloqa-v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meloqa.gitbook.io/documentacao-meloqa-v2/documentacao/integracoes/integracao-com-jira.md).

# Integração com Jira

## Instalação 

Para integrar com o Jira, siga os seguintes passos:

Escolha uma Organização e vá até a aba “Integrações”.

<figure><img src="/files/bFRzTbKCccjag0SUbhjD" alt=""><figcaption></figcaption></figure>

Clique na opção de aplicativo Jira.

<figure><img src="/files/GklEsvKI5dgpDx3pXFlD" alt=""><figcaption></figcaption></figure>

Clique em “Instalar” e preencha as informações no modal:

<figure><img src="https://lh7-us.googleusercontent.com/RnfEMJCgYDw2wWaWL68gQkgdaf5RT8uvRPd6URYMEjbDN7wonL4lXcNcYF6Q6-aySNDKjBRk1-u0M8lk1lt4kHHZrxQTyTADH1mf6hJBOlkoLqTVhc971sgonEWQNvp35l8_2E6uHuKRBkaM6KUyzSE" alt=""><figcaption></figcaption></figure>

“Atlassian Host” é a URL base da sua conta Jira Cloud, por exemplo: meloQA.atlassian.net.

Deve ser informada somente a URL base, **sem** o "https" e sem o conteúdo após o "net".

O “E-mail utilizado no Jira” é o e-mail do usuário no Jira.

Para gerar o token, clique no seguinte link: <https://id.atlassian.com/manage/api-tokens>.

**Observações**

Para que a integração entre o **Jira** e o **MeloQA** funcione corretamente, especialmente no processo de **vinculação e gerenciamento de tarefas,** o usuário que realiza a conexão precisa possuir **três permissões** no projeto Jira:

* **Criar tarefas**
* **Editar tarefas**
* **Excluir tarefas**

Se qualquer uma dessas permissões não estiver habilitada (por exemplo, a de **exclusão**), a integração com o **MeloQA** poderá falhar, impedindo a sincronização ou o gerenciamento completo das tarefas.

Caso a integração apresente falhas, entre em contato com o **Administrador do projeto Jira** da sua equipe e solicite a concessão das três permissões acima para o seu usuário no projeto correspondente.

Após o ajuste das permissões, a integração deve funcionar normalmente.

Se o problema persistir mesmo após a verificação das permissões, entre em contato com o **Suporte MeloQA.**

Após instalar, escolha suas opções de configuração.

<figure><img src="/files/zixgDuG8Ek72E5zmsnc2" alt=""><figcaption></figcaption></figure>

Escolha qual projeto no MeloQA você deseja habilitar para integrar. Em seguida, escolha o projeto no Jira que deverá ser integrado.

<figure><img src="/files/7jzzciaBONwKU5cL1J87" alt=""><figcaption></figcaption></figure>

Habilite os toogles das opções de **Vinculação** e **Sincronização** de acordo com as suas necessidades.

<figure><img src="/files/wW6M1R04Af1VqJdJONQW" alt=""><figcaption></figcaption></figure>

A seguir, estão os detalhes sobre cada uma das opções.

## **Permitir a vinculação de Casos de Teste com Issues no Jira**

Ao habilitar essa opção, você poderá linkar seus Casos de teste no MeloQA a issues no Jira.

Na criação ou edição do Caso de Teste, clique em “Vincular a uma issue”.

<figure><img src="https://lh7-us.googleusercontent.com/AihGwhaB1yAmEu4ZRSaISLzCPNcjuT0ikkT0DegyjQmsjTrxlv4svzNbjjulPOQ5vHt0xJ5TdiiVFEQgDGT3qNXiUxf0XKM5liV2K4UMu_ZZ2KWV8obvNQO_ZAT2hOp6ou72ALMkziLumvE0urdNob4" alt=""><figcaption></figcaption></figure>

Escolha a issue que deseja vincular ao caso de teste, você pode pesquisá-la pelo título ou pelo ID no Jira.

<figure><img src="/files/hVpn0cpckGqmSgd8g0tq" alt=""><figcaption></figcaption></figure>

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Caso de Teste para ser direcionado para essa issue no Jira.

<figure><img src="/files/nDLQDYvJVJjnjcBVInFU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2D1tJIeYiRVJtpluI0Hb" alt=""><figcaption></figcaption></figure>

O usuário que vinculou o caso de teste é exibido nos comentários do **card no Jira**.

<div align="left"><figure><img src="/files/1RRZloh3krE83n0Zaq7C" alt=""><figcaption></figcaption></figure></div>

Se um Caso de Teste estiver vinculado a issues no Jira, a Execução desse Caso de Teste vai exibir essas vinculações também.

<figure><img src="/files/cdU1j5zf4G57wGdFHtGb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UWaF4WjomEZzUGxECh7P" alt=""><figcaption></figcaption></figure>

## Permitir a vinculação de Ciclos de Testes com Issues no Jira

É possível também vincular o Ciclo todo a issues no Jira.

Para isso, na criação ou edição do Ciclo, clique em “Vincular a uma issue”.

<figure><img src="https://lh7-us.googleusercontent.com/tpIemp22oV6YT4X_bJLXJwVicYvsYjrhNI4YonR_-QJOUMWXU5JuPDG1kQhY69RBr6prPJliTp1LhrX_idkqe5dHVROxzOzmPJ5RHHMd6rZj_RAUo4_5dFDeIiJeaNOB02FGmED_XuEZ3q1waAuV2lQ" alt=""><figcaption></figcaption></figure>

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Ciclo para ser direcionado para essa issue no Jira.

<figure><img src="/files/Y70vgbIjVaHqJhGsXcra" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/EYML7yoLOiyrh3zznS3g" alt=""><figcaption></figcaption></figure>

O usuário que vinculou o ciclo de testes é exibido nos comentários do **card no Jira**.

## Permitir a vinculação de Bugs com Issues no Jira

\
Ao habilitar essa opção, você poderá linkar seus Bugs no MeloQA a issues no Jira.

Na criação ou edição do Bug, clique em “Vincular a uma issue”.

<figure><img src="https://lh7-us.googleusercontent.com/6zBObt9YKxA9fF-NTJYQPpnb0nwCSlcZ6xKBboibtR6hUPF7XMPsd24mT8h7X6Jn33L312QiAHEZ41CZigKO6U5yTA2L_WFIADSXzi562kslJ6Vx16Bv9HRBpWZIHC7iDbtP7PHOAgy7v-CgkVRoWJM" alt=""><figcaption></figcaption></figure>

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Bug para ser direcionado para essa issue no Jira.

<figure><img src="/files/HRxc2xKJn7jkX7MJyILs" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/065hea34kbvza8Ai1y5z" alt=""><figcaption></figcaption></figure>

O usuário que vinculou o bug é exibido nos comentários do **card no Jira**.

## **Sincronizar a criação, edição e exclusão de Bugs do meloQA para o Jira**

Quando a sincronização de Bugs do MeloQA para o Jira está habilitada, ao criar um novo Bug no Melo, será criada também uma cópia no Jira.

<figure><img src="/files/mukXJH1aRePBX66dPx0C" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Egf861lQg7BhNQHsxbqM" alt=""><figcaption></figcaption></figure>

Se o projeto Jira for do tipo Scrum , o card será aberto no backlog; se o projeto for do tipo Kanban, o card será aberto na coluna de “Tarefas pendentes”.

Por padrão, o card aberto no Jira será do tipo "Bug".

Mas se o quadro do Jira não tiver o tipo "Bug" habilitado, será aberto como outro tipo disponível: Épico, História, Tarefa, etc.

Os campos sincronizados são o **título** e a **descrição**. Se você fizer alterações nessas informações no MeloQA, elas irão refletir no card do Jira.

A exclusão e conclusão do Bug no MeloQA também reflete no card no Jira.

<figure><img src="/files/k6MxbwPmJ6OIxSsSnsyo" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yjiXoZVpLsN0mX9VOBaG" alt=""><figcaption></figcaption></figure>

Importante:  a cópia do Bug no Jira terá como “Relator” o usuário que foi informado ao instalar a integração:

<figure><img src="https://lh7-us.googleusercontent.com/VxHea6H4F1M1Da2kUmF5JllmcLwo_3Zqe295Eab7r3nTJILtFx_Zqn_dCJcIYMiLTbges7FryRKV51MZuGiMT7zgV8RXhyaXqyUCoUCfMTxGLh15Rn1QkWWtIMVpEuogztp2dpsah519iWyR1BVbluw" alt=""><figcaption></figcaption></figure>

O usuário que fez a sincronização do bug é exibido nos comentários do **card no Jira**.

<div align="left"><figure><img src="/files/nZHfJOhKleJHMqb1pC8m" alt=""><figcaption></figcaption></figure></div>

## Sincronizar a edição e exclusão de Bugs do Jira para o meloQA

Quando a sincronização de Bugs do Jira para o MeloQA está habilitada, os campos **título** e **descrição** ficam sincronizados. Se você fizer alterações nessas informações no Jira, elas irão refletir no MeloQA.

A exclusão e conclusão do Bug no Jira também reflete no MeloQA.

## Campos personalizados na sincronização

Por padrão, apenas os campos **título** e **descrição** do **Bug** ficam sincronizados.

Mas se o card de bug no seu projeto do Jira possui campos personalizados e você deseja sincronizá-los também, siga os seguintes passos:

1. Vá até as configurações do projeto no meloQA para criar os campos personalizados:

<figure><img src="/files/TbsPeBQLfEuIjqRmBpyp" alt=""><figcaption></figcaption></figure>

2. Clique em “Novo Campo Personalizado”.
3. Selecione a opção “Bug” no campo “Entidade”.
4. Preencha o título do campo com o texto idêntico ao título do campo no Jira.  <mark style="color:red;">Atenção:</mark> se o texto não for idêntico, a integração vai falhar.
5. Escolha entre o tipo de campo: “Texto” ou “Seleção”.
6. Se for escolhido o tipo “Seleção”, informe as opções com texto idêntico às opções no Jira. <mark style="color:red;">Atenção:</mark> se os textos não forem idênticos, a integração vai falhar.
7. Marque “**Campo obrigatório**” se o campo no Jira for obrigatório também.

<figure><img src="/files/O9NQZmHhdtUQwMuQNdOw" alt=""><figcaption></figcaption></figure>

\
8\. Salve o novo campo personalizado no meloQA.&#x20;

Quando for registrado um bug no meloQA, as informações dos campos personalizados ficarão sincronizadas:

<figure><img src="/files/MUNvEC1PvZLrsbckwOdo" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/l7b6wqVdvVJiy1Z7qCtp" alt=""><figcaption></figcaption></figure>

&#x20;

<mark style="color:red;">**Importante**</mark><mark style="color:red;">:</mark> Para o funcionamento correto da sincronização, os campos personalizados no Jira devem ser do tipo **texto simples** ou **select simples**.<br>

## Plugin “meloqa-jira”&#x20;

Como parte da integração, oferecemos também o plugin “meloqa-jira” para facilitar a organização e rastreabilidade dos seus itens linkados.<br>

O uso do **plugin é opcional**.

*Se o seu projeto ainda não tem a integração com o Jira habilitada, por favor, confira o item* **Instalação** *deste tutorial.*

\
Caso deseje utilizar o plugin, acesse o link disponível na página de "Configurações" da integração.

<figure><img src="/files/LzbWYZHR4JAnP7DOWtly" alt=""><figcaption></figcaption></figure>

Em seguida, clique em “Get app”.

<figure><img src="/files/WprdsjgsLKnwqe4XwU1h" alt=""><figcaption></figcaption></figure>

Selecione o site (sua organização no Jira) onde o plugin será instalado.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXccRrA_LzHQniUEsQSeItf6SgjZoBqyciEDunrRDsOPvTl0z6zMalmq_-UQmpRhh9MPxermgYDmCVjrQNRNr3gyDit1JeXp93MuhxAKYa9_b3W2o_H4n2uBfwGr35g9qiSQBWcQq9HrGGz9wX_KHSh4yQM?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd2s27GK-xqHBz3uI1spMQjRHL8HEOVzX-w96xFAlvCoWlvhjWrEQ7posVs9qFcbzfF6N1nJud8kU-uToxoxqK8Ba8ndgMCboCbT4jF8P_IDlj8RCb9euwMpYjR6jtmGfc3kZHreA8wwhuFD84k5qggKQ2p?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

Em seguida, informe seus dados de acesso ao **MeloQA**.

Após a instalação, o card no Jira vai exibir um espaço com os itens linkados no meloQA.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeHdG3V5jfl8vvFwbVoAEsxR8dUQejkoeMbFPslPU_f5fKgiXX7WPSKb8mnS94vJ-EomFxfSKNg8X-sLkyfL_QaACugyZn6AhtlyxpRCP-eRbfN7zY4hbQzMhwxTwIcFS2WIH9fHXiepzu6mjhypSylV4d8?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

Selecione o projeto no MeloQA para qual deseja ver os itens linkados.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfvFU2E206v7Ga-ORyLygfT1ybQesr-ahKHHBpa_oTLyu9f2VlnM02-Bz4vneJSGPaPefRm7dpNKqpeJmlwKIhkwTj6d_OMmemG-CFCGS7rr-5sVZ5wXuK8psQVykConR9CG7_3ckSQ81Juu1kMdqdwbfU?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/skmXflotJUcr7eO9gueB" alt=""><figcaption></figcaption></figure>

Se desejar **linkar novos itens**, clique em “Link MeloQA item”.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf1Lv74PpranocBAp-VY1gEheP_sOULyYpo6qpfpgNBB6PNJdCxyONAq_aZ9ogVHfR80Lp5LzeqdJfKcQl9Q3s_9PmNtE9y7jxYn26ik7dZYyOFRNVnkVPcclYo--XQQQ9O1Dveun0yKI0tOMV-WzVvCgKj?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

Busque o item que precisa linkar e clique no +.

Após clicar no +,  o item já estará linkado.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe48R5cydbE3HD8D1DjU18XRWN-osNTgTIc0qgbhfbaNxvTmPTBc_w3oFldZNUFMa8geDbP68TjH4ZCb62AJXokPxmrxqWtPsx94LpWueZhMZv7jRD4syVk_1AJp4b1HQ3FXWSUug?key=yyQHUnihqhtXIru7KAGINw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3kYvN69uGxQDl18LJxNM" alt=""><figcaption></figcaption></figure>

Se quiser **excluir o link**, é só clicar no X na lista.

<figure><img src="/files/BXgPkUhBvd9oqFJHqkq9" alt=""><figcaption></figcaption></figure>

<mark style="color:red;">**Atenção**</mark>: Ao clicar no X, o link será excluído e não é possível desfazer a ação.

No caso de um bug sincronizado, se o link for removido, as atualizações de 2 vias deixarão de acontecer para esse bug.

## Como conceder permissões a um usuário em um projeto do Jira

Ao tentar integrar o **MeloQA** ao Jira, você pode receber a mensagem:

> *“Você não possui todas as permissões necessárias no Jira.*
>
> *Permissões ausentes: criar, editar, deletar”*

Essa mensagem indica que o usuário que está tentando realizar a conexão **não possui uma ou mais permissões obrigatórias** no projeto do Jira.\
Sem essas permissões, a integração **falha automaticamente**, impedindo a sincronização e o gerenciamento das tarefas entre as plataformas.

Siga as etapas abaixo para conceder as permissões necessárias e concluir a integração corretamente.

#### 1. Acesse o projeto desejado

Dentro da sua organização no Jira, vá até a aba **Espaços** e selecione o projeto no qual deseja configurar as permissões.

<figure><img src="/files/fFLUbRSLLoHdEPRRNOMo" alt=""><figcaption></figcaption></figure>

#### 2. Abra as configurações do espaço

Passe o mouse sobre o nome do projeto.\
Clique nos **três pontos (...)** que aparecem à direita e escolha **Configurações do espaço**.

<figure><img src="/files/wHX45M6aDVWecesXP2JE" alt=""><figcaption></figcaption></figure>

&#x20;

#### 3. Acesse as permissões

No menu lateral esquerdo, selecione **Permissões**.

<figure><img src="/files/0MTaeWezfIKDRj9H2L7d" alt=""><figcaption></figcaption></figure>

#### 4. Edite as permissões do Projeto

No canto superior direito da tela, clique em **Ações → Editar permissões**.\
A página será atualizada, permitindo que o administrador **atualize ou remova** as permissões do projeto.

Apenas **administradores do projeto** têm permissão para editar as configurações de permissões.

<figure><img src="/files/IbQhrvGRO1zevzguoEDA" alt=""><figcaption></figcaption></figure>

#### 5. Edite as permissões do Projeto

Nessa seção, você encontrará as três permissões necessárias para a integração:

* **Criar Itens**
* **Editar Itens**
* **Excluir Itens**

<figure><img src="/files/MI70QQulDnXTp4hi4G7c" alt=""><figcaption></figcaption></figure>

#### 6. Atualize as permissões

Clique em **Atualizar** ao lado de cada uma das permissões.\
Na janela que abrir, selecione o(s) usuário(s) que devem receber acesso, conforme a necessidade do projeto.

<figure><img src="/files/8JKuyRnmyI7Yq7nNGL5H" alt=""><figcaption></figcaption></figure>

Após conceder as três permissões (**Criar**, **Editar** e **Excluir Itens**), o usuário poderá integrar o Jira ao **MeloQA** normalmente.

Se você seguiu este passo a passo e ainda não conseguiu realizar a integração, entre em contato com o **suporte do MeloQA** para que possamos ajudar.