Administrator Guide

How to install this add-on?

Install from the Universal Plugin Manager

  1. Login with a JIRA administrator account in your JIRA instance.

  2. Click the  from the top menu and choose Add-ons
    >> The Manage add-ons screen loads.

  3. Select Find new add-ons from the left-hand menu.

  4. Locate ReceiveMe! via search.
    >> Results include add-on versions compatible with your JIRA instance. You will not find the add-on if your JIRA version is not supported.

  5. Click Install to download and install your add-on.

  6. You're all set!
    >> Click Close in the Installed and ready to go dialog.

Alternative: Download ReceiveMe! from Atlassian Marketplace

  1. Download ReceiveMe! from the Atlassian Marketplace.

  2. Login with a JIRA administrator account in your JIRA instance.

  3. Click the  from the top menu and choose Add-ons
    >> The Manage add-ons screen loads.

  4. Select Manage Add-ons from the left-hand side of the page.

  5. Click Upload Add-on in the Universal Plugin Manager screen.

  6. Locate the ReceiveMe! jar you downloaded in step 1 upload it.

  7. You're all set!


To find older ReceiveMe!  versions compatible with your JIRA instance, you can look through our version history page.


On this page

Setup

  1. Login with a JIRA administrator account in your JIRA instance.

  2. Click the  from the top menu and choose Add-ons
    >> The Manage add-ons screen loads.

  3. Select Configuration to configure ReceiveMe! from the left-hand side of the page. 

  4. Add an administrator or a usser with suffient permissions to create new users, issues, comments.

  5. Click on Send button.

  6. Click the  from the top menu and choose System


  7. Click Incoming Mail under the Mail section, from the left hand menu


  8. Click the button Add incoming mail handler. 


  9. Give your mail handler a meaningful name and select a Server. Use the Handler option (ReceiveMe!) Create a new issue or add a comment to an existing issue and click Next.
     

  10. Select the Project for which you want to create issues, as well as the types of issues to create. You can also indicate whether you want to create the user in JIRA and other options.
     

  11. Click Save to start using ReceiveMe!

Users created by ReceiveMe! will not count against the your Jira's user license and therefore they won't be able to access Jira but they will be able to comment and create issues by email.

Configure a superuser

ReceiveMe! performs automatically some actions behind the scenes, such as create users, issues, comments or execute transitions. Therefore, it is required to specify a user with all those permissions in order to ensure that ReceiveMe! works correctly.

To do that you only need to click in the Configure Button after installing the app:

Then, simply use the group picker to select the desired user:


Disable message Id logging

ReceiveMe uses Jira's internal database to save the id of the incoming emails. This is a procedure that emulates default Jira's mail handler. This helps to identify if a given email is related to an issue even if no issue key appears in the subject. You can switch it off by checking this option. This could prevent a higher database consumption in some configurations. In case of doubt leave it unchecked.


Create user names

If checked, ReceiveMe will try to create the display name for the users created by the mail handler using the name of the address instead of the email. For example if an email is received with this from Tania Jones<tjones@mycompany.com> then ReceiveMe will create an user with the display name "Tania Jones". Otherwise, ReceiveMe will create the users with the sender email address as display name.


Disable Description Check Size

If checked, ReceiveMe will no truncate the description when creating an issue or comment, although it exceeds the default description field size limit (32767). It should be checked when the field description has been customized. It apply only for HTML format.