Joe Wegner
The Event Log
Published in
3 min readJul 9, 2015

--

We use Slack a lot at Keen IO. We’re constantly using and building Slack integrations to improve our workflow. We’re kind of obsessed. We realized we needed a way to aid our sales and customer success workflows on Slack, so we built a tool that lets people type a command that looks like this:

/company slack.com

and pulls up a response like this:

The company info is retrieved from Clearbit’s API. This has been incredibly useful for our Sales and Customer Success teams when they need to look up information about a new signup or an existing customer.

We’ve open sourced all of the code on Github. If you want to use this integration for your own company just follow these steps:

What you’ll need:

Step 1: Grab your Clearbit API key
Step 2: Create a Slack Incoming Webhook (you can reuse an existing one)
Step 3: Copy the webhook URL — you’ll need that later
Step 4: Create a Slack slash command. Preferably /company for the command. The URL should point to your Pushpop instance, on the /slack/company path. Copy the Token — you’ll need that later
Step 5: Create a new job in your Pushpop instance, using the company info source.
Step 6: Add all of the environment variables

  • CLEARBIT_KEY is the Clearbit API key from Step 1<
  • SLACK_WEBHOOK_URL is the webhook URL from Step 2
  • SLACK_TOKEN_COMPANY is the slash command token from Step 3

Step 7: Restart Pushpop (make sure you’re running pushpop as a webserver)
Step 8: Type /company keen.io into slack!

Person Info

We can also look up information on individual people.

This creates a slash command that will retrieve info about a person (via email address) from Clearbit, and send it back in to Slack.

The person info will look like this in Slack:

How to set up the /person command:

Step 1: Grab your Clearbit API key
Step 2: Create a Slack Incoming Webhook (you can reuse an existing one)
Step 3: Copy the webhook URL — you’ll need that later
Step 4: Create a Slack slash command Preferably /person for the command
Step 5: The URL should point to your Pushpop instance, on the /slack/person path. Copy the Token — you’ll need that later
Step 6: Create a new job in your Pushpop instance, using the person info source.
Step 7: Add all of the environment variables

  • CLEARBIT_KEY is the Clearbit API key from Step 1
  • SLACK_WEBHOOK_URL is the webhook URL from Step 2
  • SLACK_TOKEN_COMPANY is the slash command token from Step 3

Step 8: Restart Pushpop (make sure you’re running pushpop as a webserver)
Step 9: Type /person jack@squareup.com into slack!

That’s it! Check it out on github to learn more. If you have any questions or ideas of your own drop by our community Slack channel.

Joe

--

--

Joe Wegner
The Event Log

Career Nerd. Was an IT guy. Is a software engineer (@Keen_IO). Loves Christ. Married to @Erica_Wegner. http://t.co/yEBP9xbDiu