# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://meloqa.gitbook.io/documentacao-meloqa-v2/documentacao/integracoes/integracao-com-jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.