# 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2Fy8ByQWDzQKyYIPyoe92v%2F2024-05-03_11h35_44.png?alt=media&#x26;token=61a0a9fc-753d-4ca5-8acc-4f0082fb2306" alt=""><figcaption></figcaption></figure>

Clique na opção de aplicativo Jira.

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FI7PenlgHBtNdwHRQWk3U%2F2024-05-03_11h36_24.png?alt=media&#x26;token=b8929a0a-e67c-424d-ab29-015dde630390" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FeLWifXRWLCOBgb01nrQU%2F2024-05-03_11h40_13.png?alt=media&#x26;token=b787afdc-88a9-45ab-b750-8f15428e6db0" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2Fwyo5DiKju1qKJb7xQCHp%2F2024-05-03_11h41_07.png?alt=media&#x26;token=e5e0a0e8-75e8-400c-8fcb-d1deffbc73ad" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FfKOaszRbaH73ET6ja0dk%2F2024-05-03_11h42_07.png?alt=media&#x26;token=2e4fa7df-dc77-41a5-8c57-a763d92a476d" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FFy0mrkUbDNQBvhPgU7sU%2F1.jpg?alt=media&#x26;token=d82ee7f7-8020-47a8-81bf-c258600428bf" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FhM9b0xyOyEa4T4Zd46dY%2F2024-05-03_11h43_44.png?alt=media&#x26;token=00b07cae-6c5c-4cf5-a438-9f8693a30cb3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FvRvDzorBc2TdNtzWb1Mc%2F2024-05-03_11h44_56.png?alt=media&#x26;token=9a2fd4fc-ccf7-49c2-be27-1e1756144c42" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FiHNGAVJOe92z248RKQqE%2Fimage.png?alt=media&#x26;token=41e1a69d-96c3-4970-8cab-2c2432bae235" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FM0daro2SbQJcDAP2gH0l%2F2024-05-03_11h46_49.png?alt=media&#x26;token=aeb9d4da-ca86-4204-a5d3-c24103348bdf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FGR5VG29Ol6f4AuhJvdSj%2F2024-05-03_11h47_57.png?alt=media&#x26;token=3eda7736-7da5-4c23-bc72-e0e1f43dc427" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2F8tSkwVXI3aAIbLSsmErT%2F2024-05-03_11h50_03.png?alt=media&#x26;token=fc5b8dfb-0293-4f4a-b5f9-fb7162427fff" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FPO0gH2wT9fEw9IslAp7K%2F2024-05-03_11h51_24.png?alt=media&#x26;token=2d2954b9-d94f-423f-ad50-e52b5b58e6f4" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FrpzuszIO9ptMfCB64TpG%2F2024-05-03_11h54_48.png?alt=media&#x26;token=59982157-8d87-4b9b-8ea5-1a5a8ed61c81" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FkRJFuCJXZ9p7DyWPCpNo%2F2024-05-03_11h55_41.png?alt=media&#x26;token=244430e3-643f-47dc-8031-81d340c00fd0" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2Fi2UHmwpmuHz8gWucYmVx%2F2024-05-03_11h57_22.png?alt=media&#x26;token=83b4b372-bc2f-4c0f-8005-62cbc280d4d3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FzRo29LPFD1FDY7LuHLN0%2F2024-05-03_11h58_40.png?alt=media&#x26;token=c43a1079-10c3-4541-96ae-799b034e0a0f" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FKZOEg6u5I1JKqTRRU2xz%2F2024-05-03_12h00_49.png?alt=media&#x26;token=1c8345b0-2aed-4827-a595-5223294ddd8b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FzDPXER2eYp8j9OZRTmE0%2F2024-05-03_12h01_52.png?alt=media&#x26;token=72f68374-3e5a-46c3-bdca-6926723fd7ab" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FG6NxOuVYTOQaeWySgh37%2Fimage.png?alt=media&#x26;token=97d61601-ce63-4791-8197-4d4c68b81308" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2F9DAD6zJMWamAnDXkSOUl%2Fimage.png?alt=media&#x26;token=cef37d15-5eaa-40c0-a005-e9e33d688475" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FquJfdk6YMO94zBtCxAmg%2Fimage.png?alt=media&#x26;token=6a3f4827-bd85-45ea-8f13-1497659d95fd" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FGHMzPvywH1IZ44sZ8X52%2Fimage.png?alt=media&#x26;token=6fb63fc1-8566-4e29-a8ca-0e40638b9203" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FW5W1p6HBXuQS1MtHWGrt%2Fimage.png?alt=media&#x26;token=b866013f-f135-4635-855c-ee6a62f8614c" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FpBeQMdAil5PCprYqoJn3%2Fimage.png?alt=media&#x26;token=db380d18-1a4d-4a17-8e15-745945a33e5b" alt=""><figcaption></figcaption></figure>

Em seguida, clique em “Get app”.

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2F8UGtskr7vycoNXqKHNLI%2Fimage.png?alt=media&#x26;token=28145f9e-3671-4c8c-8176-4dfd5dc92d40" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2F7SsHu1mvAnPqLhknCIfT%2Fimage.png?alt=media&#x26;token=d26473cc-fb0f-49d1-9065-acfed2c2cd9c" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FXoyaQLeecIuQOdYmPnWh%2Fimage.png?alt=media&#x26;token=11912af3-f0d4-4afa-8e08-a524231f16fd" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2Fo2SLb8rCbshyM2YLJ2zx%2Fimage.png?alt=media&#x26;token=6df350be-d125-4de7-9730-7c623f9b48a6" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FX1Rd8XPB9KbLcLyAsN5l%2FCaptura%20de%20tela%202025-10-17%20131918.png?alt=media&#x26;token=13f9aaac-46c1-4f75-bf84-54a63c093d5d" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FC44ykw5HTUJ78AFfsya4%2FCaptura%20de%20tela%202025-10-17%20132221.png?alt=media&#x26;token=94233d55-9214-4e8b-8835-bfe2db75001c" alt=""><figcaption></figcaption></figure>

&#x20;

#### 3. Acesse as permissões

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

<figure><img src="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2F1evwCON4tXGgCpWwdWAZ%2FCaptura%20de%20tela%202025-10-17%20132630.png?alt=media&#x26;token=0ac1b801-1511-48e9-8f46-4411e175490c" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FUcDERiqWqlXSaRE9Smbw%2FCaptura%20de%20tela%202025-10-17%20132922.png?alt=media&#x26;token=cc61d8c4-8f67-4998-b8fd-f6bf4b7f1c90" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FDlEdzGbJO1TsGGJGKLOd%2FCaptura%20de%20tela%202025-10-17%20133805.png?alt=media&#x26;token=15876963-709f-4443-832e-13d093176ba0" 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="https://4050229060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9S40FZfzyAlITOMv5vk1%2Fuploads%2FeBLbSI3liTf3fnka4AD3%2FCaptura%20de%20tela%202025-10-17%20134056.png?alt=media&#x26;token=eebb3238-2866-4fd8-a1b0-ee865e7eb2ef" 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.