- The Welcome Screen
- Creating a new campaign in Talkpush
- The Campaign
- Setting up a job post for the Facebook Messenger
- The User Menu & Analytics
- Talkpush API Documentation
Talkpush’s API allows you to instantly plug your candidate source to our platform so you can enjoy the benefits of Talkpush immediately with your existing setup!
If you already have your own career website and it’s been generating a great flow, you can always integrate with us by having your career website send over some crucial candidate information we require, so your candidate can receive their Talkpush interview invitation as soon as they apply on your site!
To apply to a specific Talkpush Campaign externally via our API, simply send candidate information to the following URL:
|*You need to replace :id by the id of the campaign candidate is applying for|
The following parameters can be send during this API call:
|Yes||api_key||API KEY to identify who is using API|
|Yes||api_secret||API SECRET to identify who is using API|
|Yes||campaign_invitation[first_name]||First name of candidate|
|Yes||campaign_invitation[last_name]||Last name of candidate|
|Yes*||campaign_invitation[user_phone_number]||Phone number (without area code)|
|No||campaign_invitation[temporary_cv]||RAW file representing candidate resume|
|Yes||source||Name of the microsite sending information|
|No||campaign_invitation[others][referee_first_name]||First Name of Referee|
|No||campaign_invitation[others][referee_last_name]||Last Name of Referee|
|No||campaign_invitation[others][referee_id]||(Employee) ID of Referee|
|No||campaign_invitation[others][referee_email]||Email of Referee|
|No||campaign_invitation[others][referee_mobile]||Phone Number of Referee|
|No||campaign_invitation[others][referee_account]||Account of Referee|
|No||campaign_invitation[others][position]||Position of Referee|
|No||campaign_invitation[others][bpo_experience]||(BPO) Working experience of Refree|
|No||campaign_invitation[others][column_title]||Any extra data you wish to store|
*Candidate must input at least email OR user_phone_number otherwise he wont be created on Talkpush
If you are using one of the leading Applicant Tracking Systems (ATS) to capture and store all your candidate information, you may want to keep a record of their completed Talkpush interview for future reference.
Talkpush can be integrated with all the leading ATS (including but not limited to Taleo, SuccessFactors, iCIMS, Lumesse, Workday, Kenexa, Jobvite, Greenhouse) and make those completed audio profiles available to all your decision makers.
Pleaes contact us at firstname.lastname@example.org to find out more about ATS Integrations or contact your Account Manager
You can use pictures, text and buttons to deliver an engaging candidate experience.
This tab allows you to directly edit the code behind the messenger welcome text/actions. You can set the messages, the content, the button, etc. by simply altering the source code.
All this configuration pays off in a beautiful candidate Experience, which is effortless, seamless and offers candidates increased clarity, awareness & context about the role.
after these 3 questions, the following is optional
after this question, the following questions are only for running an ERP program
after that, you may ask for any additional details for your record
Here are some tips on how you should hint your candidates to fill out the form:
If you prefer to use a google sheet directly (Internal access between different recruiters)
You may do so, following the same google sheet format, as if they were created by a google form!
To do so,
**If you choose to manually edit the sheet, paste the information from an existing excel sheet. Typing it case by case may cause some system errors.
Understanding the relationship between Talkpush and a Facebook Lead Ad
Here’s how it works, as a Talkpush user, your company account is entitled to be integrated with 1 Facebook page. Once the Facebook Page & your Talkpush account are linked, you may then create some Facebook Lead Ads, provide Talkpush with your Lead Ad’s ID, so we can process your Leads and capture them into Talkpush.
To start using this feature, follow the steps below:
Step 1 Connect your Facebook Page into Talkpush
a) Select any campaign in Talkpush, click on Add Candidates > Integration tab
b) Scroll down to the section Lead Ads and click on Login with Facebook
c) Sign into Facebook or if you’re already signed in, click on continue with your identity
d) Allow Talkpush Lead Ads to access your Facebook Page
e) When you return back to Talkpush, you’ll see a list of Facebook Pages, select the right
f) Talkpush is now asking for an Ad ID
Step 2a) Create Facebook Lead Ad (if you don’t already have one)
Create an Ad Campaign and a Lead Ad connected to a Lead form that contains at least the
Once the Ad is created, it’ll have an Ad ID.
Step 2b) Locate the Ad ID
To find your App ID, we recommend going into your Ad’s manager and clicking into your Ad
In the Ad’s page, locate the Ad ID and copy it
Step 3 Connect the Ad to Talkpush
Once you have the ID copied, head back to Talkpush, where we left off in Step 1)
Paste the Ad ID in the field & click on submit
Once your Ad ID appears in the list below, your Ad has sucessfully inegrated with
Creating a new campaign
Click on +new campaign on the top right of the welcome screen.
1. Input the title of the campaign you want to create, this will be the title displayed on the welcome screen and the campaign selection
2. Choose a Country for the Hotline Number, we strongly suggest selecting the country that you will run the campaign in, as this will be deciding the phone number prefix displayed on your candidate’s phones when they receive a call
3.Interview language will decide the language model will be used for transcription of the audio to text (if applicable for your campaign
4. Webdialout:Provide candidates with the option to follow a link to initiate an interview call through their browser. This has to be set up by Talkpush Engineering team
5. Auto-call, if enabled a candidate will receive a call upon being added a campaign. Ex.g. when clicking on the apply button on your career site.
Through this drag-&-drop interface you may choose which members of your team will have access to the campaign and can thus see it and interactive with the candidates inside it.
1. Select the Messages that you want to edit:
The e-mails will be sent via a @talkpush.com address, but will have your company name as the “Sender Name”. All template options come with predefined standards that you may use.
2. Enable/disable the message type. If enabled, messages will be automatically sent out as specified above.
3. SMS Template: Here you may write the message content that will be sent via SMS. The number of characters is important as one SMS can only contain up to 160 characters, past that you will be charged for an additional SMS. The number of preview messages to the right equals the number of SMS that will be sent out for this message.
Keep in mind that you may use the Tokens in these message in order to personalize them for every candidate.
4. E-mail Template:
This template is editable from the graphic editor or by clicking on <> you can also directly edit the html. Elaborate designs are possible like this.
The Interview Creator
The interview is split into 3 main segments.
The opening Prompt is only used in the phone interview, not in the Messenger. However even with a chatbot campaign audio files have to be uploaded.
The Introduction serves to welcome the candidate to the campaign.
The Privacy statement serves to inform the candidate that this interview will be recorded and shared with your recruitment team. In order for the candidate to communicate his acceptance ask him to press any key on his phone.
The Instructions should explain to the user that he has 4 minutes to respond to a question after it was spoken. If he wishes to proceed he may press any button on his keyboard.
The questions consist in your selection of questions.
The general recommendation by Talkpush is to have 3 – 4 questions per Interview. More questions tend to have a negative impact on the completion rate.
By clicking on Upload you can create your questions.
The Input text of the question is the text that will be displayed in the Messenger Text and should contain the question text that is being spoken in the audio file.
When uploading a file it is important to keep in mind that Talkpush only accepts .wav & .mp3 files.
When selecting the type of answer you may choose between audio, audio/text & text. Candidates will be notified in the chatbot conversation which answer type is accepted for a given question.
The Closing prompt is meant to thank the candidate for the application and inform him about the processing thereof.