Skip Navigation
Show nav
Heroku Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
View categories

Categories

  • Heroku Architecture
    • Dynos (app containers)
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Command Line
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery
    • Continuous Integration
  • Language Support
    • Node.js
    • Ruby
      • Rails Support
      • Working with Bundler
    • Python
      • Background Jobs in Python
      • Working with Django
    • Java
      • Working with Maven
      • Java Database Operations
      • Working with the Play Framework
      • Working with Spring Boot
      • Java Advanced Topics
    • PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
    • Heroku Data For Redis
    • Apache Kafka on Heroku
    • Other Data Stores
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
    • Compliance
  • Heroku Enterprise
    • Private Spaces
      • Infrastructure Networking
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
    • Single Sign-on (SSO)
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Add-ons
  • All Add-ons
  • CloudSponge Contact Importer
CloudSponge Contact Importer

This add-on is operated by Cloud Copy, LLC

Import address books from Yahoo, Gmail, Outlook.com, AOL, Outlook and Mac OS X.

CloudSponge Contact Importer

Last updated November 20, 2020

Table of Contents

  • Provisioning the add-on
  • Local setup
  • Setup The Contact Picker
  • Dashboard
  • Adding a new domain
  • Removing the add-on
  • Support

The CloudSponge Contact Picker is a Heroku add-on to import address books from Gmail, Yahoo, Outlook.com, iCloud, AOL, LinkedIn, Outlook desktop, Mac OS X Address Book and many others.

You can use these email addresses to invite Friends, find Friends, or whatever other application you need.

The simplest way to use CloudSponge is using the JavaScript widget importer with our default snippet: it will add an “Add from Address Book” link to your email form, allowing the user to click, select an address book provider (Gmail, Yahoo, Hotmail, Windows Live, etc.) and then select contacts to automatically fill your email recipient field.

list of contacts with some highlighted and a button to import them
Our contact Picker in action

You can see it in action on our test drive page.

Additionally, our HTML widget importer can easily be plugged into your website in less than 5 minutes, just using a simple copy/paste.

Later, you can replace our branding with your own company name in addition to several other customization options. You can even use one of supported APIs to take full control of the importer process.

Provisioning the add-on

The CloudSponge Contact Picker can be attached to a Heroku application via the CLI:

$ heroku addons:create cloudsponge
-----> Adding cloudsponge to sharp-mountain-4005... done, v18 (free)

Once it has been provisioned, a CLOUDSPONGE_KEY setting will be available in the app configuration and will contain your Account Key. This can be confirmed using the heroku config:get command.

$ heroku config:get CLOUDSPONGE_KEY
1234

After installing CloudSponge, the application should be configured to fully integrate with the add-on.

Because your CLOUDSPONGE_KEY is generated asynchronously after the add-on has been provisioned, there will be a short delay before it is available. If you get an empty value for CLOUDSPONGE_KEY, wait a moment and try again.

Local setup

At Heroku, the config var CLOUDSPONGE_KEY is now automatically filled after install. In this sample, our CLOUDSPONGE_KEY is 1234.

You can now simulate the same Heroku behavior in your local environment, specifying your key when running the application (or any other command) by prepending the shell command:

$ CLOUDSPONGE_KEY="1234" rails s

If you need a different way to setup your local config vars, visit the Heroku Local article.

Now it’s time to setup your importer.

Setup The Contact Picker

Our Contact Picker is appropriate for developers who want to get up and running quickly. You can see it in action on our test drive page.

Basic installation

Add this script to your site in the HEAD of the page:

<script src="//api.cloudsponge.com/widget/<%= ENV['CLOUDSPONGE_KEY'] %>.js"></script>

Provide a widget launcher hyperlink:

<!-- Any link with a class="cloudsponge-launch" will start the import process -->
<a class="cloudsponge-launch">Add From Address Book</a>

Display user’s selected contacts:

<input type="textarea" class="cloudsponge-contacts"/>

Customization

The user experience is fully customizable to suit your needs.

The CloudSponge widget’s look and behavior can be customized in many ways to blend in with your application. Read more about our current widget customizations in our documentation.

The user experience can also be white-labeled so that your users don’t see the CloudSponge brand anywhere. You can read more about this advanced topic on our online documentation.

Our server API eases the burden of maintaining multiple provider integrations while giving you full control over every pixel of the user experience.

Dashboard

The CloudSponge Contact Picker dashboard allows you to manage your sites, manage users and check address books import statistics.

settings dashboard showing a list of keys and sites
CloudSponge Dashboard at Heroku

The dashboard can be accessed via the CLI:

$ heroku addons:open cloudsponge
Opening cloudsponge for sharp-mountain-4005…

or by visiting the Heroku Dashboard and selecting the application in question. Select CloudSponge Contact Picker from the Add-ons menu.

Adding a new domain

If you Heroku app has a top level domain, like example.com, you’re not required to do any changes to your code.

Once you test the widget in your new domain, it’ll be automatically recognized and added to your domain list.

See your domain list in your CloudSponge Dashboard:

$ heroku addons:open cloudsponge
Opening cloudsponge for sharp-mountain-4005...

Removing the add-on

The CloudSponge Contact Picker can be removed via the CLI.

This will destroy all associated data and cannot be undone!

$ heroku addons:destroy cloudsponge
-----> Removing cloudsponge from sharp-mountain-4005... done, v20 (free)

Support

Heroku support should be sent via Heroku Support channels. CloudSponge Contact Picker related issues or product feedback is welcome at support@cloudsponge.com.

Keep reading

  • All Add-ons

Feedback

Log in to submit feedback.

Ziggeo Constructor.io Autocomplete

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Podcasts
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing

Subscribe to our monthly newsletter

Your email address:

  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Heroku Podcasts
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Facebook
  • Instagram
  • Github
  • LinkedIn
  • YouTube
Heroku is acompany

 © Salesforce.com

  • heroku.com
  • Terms of Service
  • Privacy
  • Cookies
  • Cookie Preferences