Cilantro IO: PaperCut MF & Smokeball — User Guide

Guidance for customers on authentication, activity code assignment, and webhook registration for the Smokeball integration.

Requires Smokeball & PaperCut MFLast updated: August 2024Setup Guide →Integration Overview →

1. Document Information

1.1 Introduction

Before attempting to action this guide, contact your PaperCut Reseller to purchase a license.

The purpose of this document is to provide guidance to customers for the steps required to permit Cilantro to communicate with their Firm in Smokeball.

Along with obtaining the Cilantro Instance credentials that are required by the Cilantro installer and how to map PaperCut MF's job type references with Activity codes within Smokeball.

2. Smokeball Integration

2.1 Authentication with Smokeball

As part of the installation process, a member of staff with full Smokeball privileges is required to authenticate Cilantro with Smokeball. It is through this user that the PaperCut MF information is passed to and from Smokeball.

You will receive credentials and a link from Taco or your reseller for your Vendor portal account. Please login, change your password and setup your MFA preference.

Once logged in, navigate to the "Cilantro Instance" Tile and click on the blue hyperlink. Beside the hyperlink, you will see an i button, click on this to obtain your unique Client ID and Secretkey. The person installing and configuring Cilantro for you will need these credentials

You will be taken to a Smokeball login screen as below, where your chosen user will enter their Smokeball credentials.

It is this user that uploaded scans are associated with if we are unable to match an account between PaperCut MF & Smokeball.

Note: If this user leaves the company or their Smokeball account is removed, a new user will have to be chosen and this process repeated.

Smokeball Sign In Screen
Sign in to Smokeball.

2.2 Assigning Activity Codes & Matter update webhook

Upon successful authentication, you will be redirected to a Taco page where you will:

  • Decide how disbursements are created
  • Assign Activity Codes to PaperCut MF job types (PRINT/COPY/SCAN/FAX)
  • Register your instance's webhook functionality

This aligns the data that comes from PaperCut MF with the values configured in Smokeball. It is important to ensure these are assigned correctly for your business.

Disbursement creation method

There are 3 methods to create disbursements in Smokeball:

  1. Each transaction in PaperCut MF results in a disbursement being created (default)

  2. Transactions of the same type are rolled into one disbursement

  3. All transactions, regardless of type, are rolled into one disbursement

Note: Transaction reports are run daily in the early morning and result in the creation of disbursements for the previous day's activity. A disbursement is created against the Matter referenced during the use of PaperCut MF Print/Copy/Scan/Fax functionality.

Activity Codes

In Smokeball, these Activity codes are created and configured under Smokeball Settings/Time & Billing/Activities.

Smokeball Activity Code Settings
Configure Activity Codes in Smokeball (e.g. PRT, CPY, FAX, SCN).

E.g align COPY from PaperCut with PHOTOCOPIES from Smokeball.

Taco Preference Settings for mapping codes
Map PaperCut Task Types to Smokeball Activity Codes and Register Webhook.

Webhook registration

A Smokeball webhook is utilised to keep PaperCut MF's Shared Accounts list updated as and when changes are made to Smokeball.

Please select "Register Webhook" to enable this functionality! It's important, so that your system is kept up to date.

Save and close the window, the authentication process with Smokeball is complete.

Essential storage remembers this choice. With your permission, Google Analytics 4 measures visits and Microsoft Clarity records interactions. These tools load only after you accept. Read our Cookie Policy.

Essential storageAlways active for site functions and your preference.
Always on