- CategoryCRM
- AuthAPI key
Overview
Connect Hercules to import your Hercules contacts and candidates into MessageMind, and to add new MessageMind contacts to Hercules. Hercules is an applicant tracking system (ATS) and is listed under CRM on the Integrations page. You connect it with an API key and your Workspace ID, then start the first import yourself from Workspace > Contacts.
What MessageMind can do with it
- Import the contacts and candidates in your Hercules workspace into your MessageMind contacts.
- Keep the extra details from each Hercules record, such as location, current role, skills and pipeline stage, as custom fields on the contact.
- Bring in new Hercules contacts automatically from time to time after you connect. Running the import again brings them in straight away.
- Add new MessageMind contacts to Hercules, for example someone who messages you for the first time or a contact you add with New contact.
Requirements
- A Hercules account where you can create an API key under Settings > API Keys.
- Your Hercules Workspace ID, shown under Settings > Workspace in Hercules.
- A MessageMind Starter, Professional or Enterprise plan.
- To run the import, a team role that allows adding contacts.
How to connect
- In Hercules, go to Settings > API Keys, create a new API key and copy it.
- In Hercules, go to Settings > Workspace and copy your Workspace ID.
- In MessageMind, open Connections > Integrations.
- Click CRM in the left rail, or type Hercules in the search box.
- Click Connect on the Hercules row. The Connect Hercules window opens.
- Paste the key into API Key and the ID into Workspace ID. Both fields are required.
- Click Connect. MessageMind checks the key with Hercules before saving it, and the button shows Connecting… while it does.
- When the key is accepted, the window closes and the Hercules row shows a tick.
- Go to Workspace > Contacts and run your first import (see Example workflows below).
Authentication and permissions
- Mechanism
- You paste a Hercules API key and your Workspace ID into the Connect Hercules window.
- Credentials
- API Key: create it in Hercules under Settings > API Keys. Workspace ID: copy it from Settings > Workspace in Hercules, so MessageMind reads the right workspace.
Available data and actions
Reads
- Contacts and candidates in your Hercules workspace: name, email address and phone number.
- Other details on each Hercules record, such as location, current role, skills and pipeline stage. They are saved as custom fields on the contact, with names that start with hercules_ (for example hercules_location).
Writes
- A new contact in Hercules for each new MessageMind contact, with first name, last name, email and phone when MessageMind has them, plus a location based on the phone number.
Example workflows
Import your Hercules contacts
- Open the Workspace and click Contacts in the left rail.
- Click Import at the top of the contact list.
- Click the Hercules tile, then click Continue.
- In the Import from Hercules window, click Start import.
- Watch the progress bar. The status goes from Queued to Importing to Completed, with the number of contacts inserted.
- Close the window whenever you like. The import keeps running.
- When it says "Import finished.", your Hercules contacts are in the contact list.
A new person messages you
- Someone who is not in your contacts writes to one of your connected channels.
- MessageMind creates a contact for them.
- The same person is added to Hercules as a new contact, with whatever name, email and phone number MessageMind has for them.
Disconnect and reconnect
- Open Connections > Integrations and click Disconnect on the Hercules row. It disconnects straight away and shows "Integration Successfully Removed".
- Contacts you already imported stay in MessageMind with their Hercules custom fields.
- To reconnect, click Connect on the Hercules row and paste your API key and Workspace ID again. If you run the import again afterwards, contacts already in MessageMind are skipped.