hubot-totango v1.5.1

hubot-totango

A hubot script that interfaces with the organization's Totango and responds with key information about customers

See src/totango.js for full documentation.

Installation

In hubot project repo, run:

npm install hubot-totango --save

Then add hubot-totango to your external-scripts.json:

[
  "hubot-totango"
]

make sure you export TOTANGO_API_TOKEN in your environment with your Totango API token see: http://support.totango.com/hc/en-us/articles/204174135-Search-API#toc-your-authentication-key

export TOTANGO_API_TOKEN=xxxxxxxxxxxxxxxxxxemail@domian.com

Sample Interaction

user1>> hubot totango 'ACME Inc.'
hubot>> Acme Inc (123567): 
$5,000 - Paying|Good Health|12 Active users
Avon Barksdale http://app.totango.com/#/accounts/1234567

Customizing

You can cusotmize the bot to output any data field (attribute, metric) from your Totango. To customize, open the totango.js file installed by this package (normally under project-root/node-modules/hubot-totango/src ) and modify CUSTOM_ATTRIBUTE_LIST with the attribute or metric name you want the bot to printout.

var CUSTOM_ATTRIBUTE_LIST = [
        {"type":"number_attribute","attribute":"API-name-of-the-attribute","field_display_name":"Label totango-bot should use"},
        {"type":"string_attribute","attribute":"API-name-of-the-attribute","field_display_name":"Label totango-bot should use"},
        ];

The easiest way to fill in the values is to use the Totango UI and generate them

1) Login to Totango and create a new Account Segment (https://app.totango.com/#/segment/new/account) 2) Add the Columns you want using the + button. 3) Generate an API Endpoint (option in the advance menu) 4) Look for your fields in the "fields" param in the generated cURL call... use them in the script...