TextUs is a business-class messaging service that allows your organization to reach out to candidates via text message. With TextUs, users can use their existing desktop landline or a virtual number to send a message from their computer or smartphone. In this article, we will cover:
Set up the TextUs integration
Create a Harvest API key
To configure the Greenhouse Recruiting / TextUs integration, you'll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the TextUs integration.
In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: TextUs
- Description: TextUs Harvest API key
Verify that the following permissions are selected for the TextUs integration:
- All permissions
- GET: List Candidates
- POST: Add Note
- GET: Retrieve User
- GET: List Users
When finished, click Save.
Your Harvest API key for the Greenhouse Recruiting / TextUs integration is created and configured. Copy the Harvest API key to provide to TextUs in the next step.
Use the TextUs integration with Greenhouse Recruiting
Navigate to TextUs and Log in. on your web browser and stay in the Admin Level of your account.
The Admin level is the only place where you can integrate your company's accounts. To check you are placing your integration in the right place, navigate to Settings and verify where you are in the account tree.
Ensure that you place the integration at the highest level of your account tree as exampled below.
Once you have confirmed you are at the correct level of your account, click your profile image in the top-right corner and click Settings, then click Integrations in the menu on the left.
Click the Greenhouse icon, then enter the email address you use to sign into Greenhouse Recruiting, as well as the Harvest API key you generated in the previous step.
When finished, click Save.
Your team might also choose to install the TextUs Next Chrome extension, which allows you to import contacts right from their Greenhouse Recruiting profile.
If you wish to install this extension, you can begin the process by clicking here. Please reach out to the TextUs team to learn more about installing and using the TextUs Next Chrome extension.
Opt-in consent for Application-to-Person (A2P) messaging
Application-to-Person (A2P) messaging allows organizations to send messages to standard 10-digit long code (10DLC) phone numbers.
New texting regulations for A2P 10DLC require candidates expressly opt-in when applying for jobs in order to receive A2P communications. If a candidate opts-out, these messages will be blocked.
To obtain this opt-in consent in Greenhouse Recruiting, create a custom application question using Yes/No as the configured answer type and then, apply this question to your job posts in bulk. Once created, you can then report on candidate application responses to locate the consent status.
To learn more on working with A2P 10DLC regulations in Greenhouse Recruiting, reach your Customer Success manager or open a ticket with Greenhouse Technical Support.
Why are my texts not sending?
Your text messages may not be sending for a number of reasons. Please reach out to TextUs support with the following information:
- Are your messages showing as "Delivered" or "Not Delivered" (red)?
- What are some of the numbers you are having trouble texting to?
How do I send a SMS message to a candidate when I am in Greenhouse Recruiting?
You will need to have the TextUs Next Chrome extension installed and make sure you are logged into TextUs for the extension to appear. Click here to install the extension and learn more.
Why are my SMS messages not tracking in Greenhouse Recruiting?
Be sure to check your account is correctly integrated by visiting the Integrations page. If it is not integrated please follow the instructions on how to integrate.
Where does the TextUs Chrome extension read a number from in Greenhouse Recruiting?
The TextUs Chrome Extension pulls the phone number listed below the candidate name by default.
How do I delete a contact?
TextUs rarely recommends deleting contacts! If a user has requested to be opted out, it is best practice to lock them so they cannot be texted but you have the message and contact history still visible for recording purposes.