- 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|
|No||campaign_invitation[ 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
Talkpush can integrate with any ATS as long as they expose an API on which we can access. The JSON structure of a candidate exchanged from Talkpush to an ATS is the following one:
"campaign_title": "Dynamic Retail Coordinator",
"company": "Sanin restaurant",
"organisation_name": "Sanin restaurant",
"description": "Département de communication Travail sur la stratgeie e-marketing Retranscription écrite Français/Anglais.",
"description": "Département Marketing PowerPoint présentation. Gestion du portefeuille client",
"description": "Département d'acuille * confirmation des réservation avec les clients.",
"description": "Travail en groupe.",
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.
The Company Profile
a) Follow this link to return to your campaigns
b) In the Team panel you can see all user accounts(Manager Accounts) for your company. The Owner column indicates which user has the administrative rights of this company account and thus may access all campaigns, edit the company settings and create new user accounts. You can activate the feature to Receive Weekly Statistics Email. The further options displayed Deactivate, Delete & Transfer Company Ownership can only be triggered by the Owner account. By deactivating an account the User data remains whilst this user account will however not be accessible anymore but may be reactivated at any given time.
c) The New Manager Account button allows you to add your colleagues to your company profile by sending them an invitation mail.
d)Just like the My Account option in the user menu, this will lead you to the panel where you may edit your own user account data.
e) Here you may change some of the basic company account settings, if your account has the ownership.
Domains on the Domain Whitelist will be the only ones permitted to acquire user accounts within your company account, this way you can ensure that only email addresses with @[yourcompanydomain] receive access.
IPs on the IP Whitelist are the only IPs that are permitted to access your company account, this way you may block outside access.
Analytics & Usage Data
The Analytics & Usage Data panels are accessible through the user menu (mentioned in the Welcome Screen Section) and provide you with a wealth of insights into your data and usage.
You can adjust the time frame of the statistics and you’ll be able to export the data. SMS Breakdown will offer a Excel file containing information on the SMS usage per campaign.
The Overview indicates the daily added, completed, shortlisted & rejected candidates across all campaigns.
Pass & Participation Rate
The Pass Rate gives you an idea on the quality of the incoming candidates over time: Shortlisted / completed
The Participation Rate tells you the how many of the applied candidates are willing to complete the interview over time: completed / invited
This graph shows you the average number of completed interviews at a given hour of the day. This insight is very useful to understand your candidates and gives you an opportunity to optimize your ads and engagement efforts.
Processing Volume by User
This graph will show you how many candidates have been process broken down by your users. Indicating who’s the most active recruiter
Processing time by Recruiter
This will show you how responsive each on of your users are. The shorter the processing time, the more responsive the user it. The recommended maximum processing time is 24 hours.
Processing time by campaign
This will show you how long it takes for the candidates to be processed by your recruiters in respect to the days by campaign. The shorter the time, the more responsive your recruiters are on the given day.
Shows you the time of day or hour of the day when your recruiters are most active (measured in shortlisting/rejecting etc. actions)
The User Account panel lets you edit your Manager Account data.
By selecting another language the entire interface of the software will be displayed in that language for your user account.
Welcome to the campaign view. We’ll go through it from left to right.
Candidate Profile Panel
a) Campaign Options
b) Candidate Data
The four buttons to the right of the candidate’s image are used to move the candidate into different folders throughout the recruitment process. You may move a candidate to the Shortlist, Rejected, On Hold or Hired folders