Update Desk.com events in Totango

Use Totango's API to send an event to Totango each time a Desk.com case is created for a customer.


In order to send support data to Totango, the ticket needs to associate a user and account. With each new customer joining your organization this profile needs to be manually created or uploaded to Desk.com. They also offer API capabilities to fully automate this. Further automation around this can be accomplished by populating the domains field within the organization. This way, each new user originating from the same domain automatically gets associated to the account based on their email address domain.

Totango actually integrates neatly with Desk.com through their application installer. Once you have setup your admin account, select the drop down menu from the top left and click on the admin button. This brings you to the admin setup, where we will perform the necessary operations to onboard your Desk.com support with Totango.


You are viewing Desk.com in the "classic Agent view" (the default viewer). If viewing in Next Gen view, the steps are slightly different, so switch to that during setup. When you create/add a customer, make certain that you enter the orgid information under the company name (see step 3) for details.

1. Install Totango on Desk.com

  1. Log into Desk.com as an admin.
  2. From the main menu, click on the Apps tab, and select Browse Apps.
  3. Scroll down to the Totango app installer, and click Install under the Totango App logo.
  4. Click Install Totango.
  5. Accept the terms and conditions.

2. Calibrate Totango in Desk.com

The Totango app is available under the Installed Apps section of the Apps admin menu.

  1. Click on Settings.
  2. For Authentication Method, select service ID.
  3. In the Service ID box, input your totango instance service id (it takes the form SP-XXXX-XX).
  4. Select the Active check box button to activate the Totango application.
  5. Click on Totango and activate the action titled "Post an event to Totango".
  6. Click on Totango to trigger a popup wherein you can calibrate the app settings menu:

    Make certain the values are correct, otherwise the app will not properly connect.

    • Name: This is the ID of the Desk.com action item that references the Totango app. When you create a "Rule", this is the reference string you will select to action the installed Totango app.
    • Action Type: Select the pre-existing "Post an event to Totango"
    • Customer Username or Email: {{customer.email}
    • Unique customer account ID: {{company_object.custom_orgid}}
    • Account name (for Totango UI and reports): leave blank
    • Activity: Action ticket created by customer
    • Module:- Department receiving support ticket

    Example Calibration:

    Name:                        Post an event to Totango
    Action Type:                 Post an event to Totango
    Customer Username or Email:  {{customer.email}}
    Unique customer account ID:  {{company_object.custom_orgid}}
    Account name:                Aberdeen Fishing Company
    Activity:                    Created a ticket
    Module:                      Help Desk
  7. Click Save.

3. Add a company custom field

In the Cases field, go to "Companies" and click on Add Field. Input the following info:

Name           orgid
Key            orgid
Data Type      Text

When inputting new customers, you need to make certain that when you update orgid (in the company tab) and also input the company name (this attribute already exists in desk.com). Otherwise, the Totango app on desk.com won't notify your Totango instance.

4. Add a rule

  1. In the Admin tab menu, select the Cases tab.
  2. Under Case Management, click on Rules and select Case Created from child menu.
  3. Click on Add Rule.
  4. Type "Post event to Totango" into the rule name.
  5. We will only use "Add "ALL" Condition" and "Rule Actions".
    For "Add "ALL" Condition":
        Company orgid                   is not            ^$
        X - Use regular expression
        Customer Default Email          is not            ^$
        X - Use regular expression
  6. For "Rule Actions", select "Trigger an App Action," then click on "Totango: Post an event to Totango."
  7. Enable the rule and click on Update.

Congrats, you have now synced your desk support network with your Totango instance.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request