The Attachment Manager app  allows you to manage ticket attachments. It combines the former Attachment Library, Attachment Restriction, Attachment Tagger (formerly Attachment Finder), and the Redact Attachments app into one sidebar experience. An agent can open and close these features using an accordion-style interface.

This article contains the following topics:

  • Installing the app
    • Understanding the tags added by the Attachment Manager app
  • Using the app 
    • Redacting ticket attachments
    • Redacting restricted ticket attachments
    • Adding attachments to the attachment library

Installing the app

The Attachment Manager app is installed from the Zendesk Marketplace. 

To install the app

  1. In Admin Center, click the Apps and integrations icon () in the sidebar, then select Apps > Zendesk Support apps.
  2. Click Marketplace at the top of the page and then enter "Attachment Manager" in the Marketplace search bar. Or, simply follow the marketplace link above.
  3. Double-click on the Attachment Manager app icon, and click Install.
  4. In the installation section, enter a name for the app.
    attachment_manager_install.png
  5. Enter the tags to be added to existing tickets and new tickets with attachments. See Understanding the tags added by the app.
  6. Specify any whitelist or blacklist options for allowing or blocking file extensions. 
  7. Enable group and role restrictions if required.
  8. Click Install.

The app settings can be changed after installation by navigating to Admin > Apps > Manage, and under the Currently installed tab, click the Attachment Manager app dropdown options, and select Change settings.

Understanding the tags added by the Attachment Manager app

  • The tag provided in the Attachment tag field (e.g., has_attachment) is added when an agent updates a ticket with existing attachments.
  • The tag provided in the New attachment field (e.g., has_new_attachment) is added when an agent adds a new attachment to an existing ticket through Zendesk Support.
  • If you just want the app to track attachments regardless if they are added by agent or end user, you can set same value for New attachment tag and Attachment tag.

Be aware of some limitations when using tags generated by the Attachment Manager app for reporting and business rules:

  • The app runs on the Zendesk Apps framework, and therefore only adds tags to the ticket when an agent updates a ticket in the Zendesk Support UI. Consider this if you build business rules or reporting around the tags added by the app.
  • The app doesn't tag tickets when they are created by an agent in Zendesk Support. It only adds tags when a ticket is updated by an agent in Zendesk Support.

Using the app 

The Attachment Manager app is accessed in the app sidebar when viewing tickets in Support. It contains three features: All attachments, Restricted attachments, and Library.

Redacting ticket attachments

The first item in the accordion list is All attachments, which shows the number of attachments within the current ticket.

To redact ticket attachments

  1. Open the accordion to view all attachments on the ticket.
  2. Check any of the attachments you would like to remove or click the checkmark to the left of Name if you would like to select all attachments.
  3. Click on the Redact attachments button.
  4. A pop-up confirmation window will appear to allow you to confirm your choice. 
  5. Type in the confirmation text and click Redact. 

Note: Attachments cannot be retrieved once they have been redacted and will be replaced in the interface with an empty text file named "redacted.txt."

Redacting restricted ticket attachments

The second item in the app accordion list is Restricted attachments, which shows the number of invalid attachments.

To redact restricted ticket attachments

  1. Open the accordion to view all attachments on the ticket that violate any whitelist or blacklist rules that were specified in the app settings.
  2. Select the attachments you would like to remove, or select the checkmark to the left of Name if you would like to select all attachments.
  3. Click Redact attachments.
  4. A pop-up confirmation window appears to confirm your changes. 
  5. Type confirmation text and click Redact. 

Adding attachments to the attachment library

The third item in the app's accordion list is Library which allows you to manage attachments in the library. There are three tabs within this feature.

The first tab, Library, shows all attachments that are in the library.

To add attachments from the library into the current ticket

  1. Click on the attachments in the app to highlight them.
  2. Click Embed image to embed the image in the ticket, Embed link to embed a link to the attachment, or Remove to remove the item from the library.

The second tab, Ticket, shows all attachments on the current ticket.

To add attachments from the ticket into the library or into another place in the same ticket

  1. To add an attachment from this ticket to the current comment, click on the attachment and then click on Embed image to embed the image or Embed link to embed a link to the attachment.
  2. To add the attachment to the library, click Add to library. 

The third tab, External, allows you to add attachments to the library from an external web page.

To add external files to the library

  1. To add an attachment from an external web page to the library, enter the full URL of the image into the External file URL field. The URL must contain a secure protocol "https://".
  2. Enter a name for the attachment. 
  3. If the item is an image, select the File type to Image toggle. 
  4. Cick Add to library.

  •  
Powered by Zendesk