WhatsApp: Templates and Messaging
18 min
this guide covers configuring message templates, sending whatsapp messages to candidates, and using whatsapp for automated interview reminders, booking confirmations, and workflow steps for candidates prerequisites you need to have whatsapp candidate messaging configured before you can send messages with whatsapp in ashby for more on configuring whatsapp candidate messaging, check out whatsapp setup docid\ xk2qn03z4yvc95mspmlni each message sent via whatsapp candidate texting uses credits that come from your candidate texting credit pool templates in the marketing category use 2 credits while other template types consume 1 credit categories are assigned by meta ashby does not use credits when a candidate responds permissions & access you need organization admin access and has candidate texting access permissions enabled on your employee profile to enable whatsapp messaging and configure whatsapp message templates you need the can add/edit jobs permission to edit a schedule interview activity you need the can email/schedule candidates permission to send a whatsapp message from the candidate profile to a consenting candidate you need to have has candidate texting access permissions enabled on your employee profile to send whatsapp messages to a candidate whatsapp message templates once you successfully connect your waba to ashby, seven pre approved built in templates are available in your account automatically these templates cover interview reminders, availability requests, booking links, take home notifications, and recruiter outreach you can start with those and add your own as needed meta only allows you to send candidates templates that have been reviewed and approved by them unless the candidate has messaged within the last 24 hours creating a new whatsapp message template meta must approve a template before you can send messages using it to a candidate approval typically takes five minutes to 24 hours you can only use templates with approved versions in automations check out twilio's documentation https //help twilio com/articles/360039737753 recommendations and best practices for creating whatsapp message templates for more on best practices for creating templates to create a new whatsapp message template navigate to admin > organization setup > candidate texting templates click the whatsapp template tab click + new to create a new template add your message body you can assign a category and language to your template meta requires every template to be classified as marketing, utility, or authentication meta is the one who designated the classification during approval, and they can re categorize an approved template to marketing on re review without notice the category of the template matters because credits are consumed based on the type of template you are sending a candidate marketing templates use 2 credits while other template types consume 1 credit you are not allowed to send templates in the marketing category to us and canada phone numbers this is a meta enforced restriction click the t icon to add a substitution token ashby replaces tokens with actual values when sending once your template is ready, click submit for approval whatsapp message templates can have the following states draft you have created or edited the template but not yet submitted it to meta these templates don't appear as an option to send to candidates or use in automations if this template has a version that was previously approved, you can still use that version submitted the template is with meta and awaiting review during this time, you can't edit the template these templates don't appear yet as an option to send to candidates or use in automations if this template has a version that was previously approved, you can still use that version approved meta has approved the template, and you can send it to candidates moving forward this approved template now appears in the whatsapp template dropdown for automations and in the whatsapp message composer on a candidate's profile rejected meta has rejected this template because of an issue it flagged, so you can't use the template you can fix these issues and resubmit until this template gets approved, you can't use it in automations or to message from the candidate profile if this template has a version that was previously approved, you can still use that version paused and suspended a template can also be paused (meta's response to candidate thumbs down feedback building up) or suspended (repeated pauses) you can't use that template moving forward for more information, check out twilio's guide message templates approvals & statuses https //www twilio com/docs/whatsapp/tutorial/message template approvals statuses editing a whatsapp message template you can't edit templates in the submitted state to edit an existing whatsapp message template navigate to admin > organization setup > candidate texting templates click the whatsapp template tab click the whatsapp template you want to change click edit within the template pop up and make your amendments if the template is a draft, you can make edits right away click submit for approval to re submit the message to meta editing an already approved template creates a new version under review in the meantime, the previously approved version stays live for automations, and you can send it from the whatsapp message composer on the candidate profile versioning is forward only you cannot revert to a prior approved version archiving and restoring a whatsapp message template to archive a whatsapp message template click the template you want to archive click more , then click archive click archive on the following pop up to confirm this screenshot shows the more, then archive option when archiving a message template to restore an archived template set the active dropdown on the whatsapp template tab to all the list of whatsapp messaging templates with the all dropdown highlighted click the template you want to restore click more , then click restore click restore on the following pop up to confirm sending a whatsapp message to a candidate to send a whatsapp message to a candidate navigate to the candidate profile click the whatsapp tab of the candidate feed click the + icon to select a whatsapp message template and review the message content the template content cannot be edited prior to sending click send a missing value for error means substitution tokens aren't resolving confirm that the relevant data is available for the candidate for direct booking or candidate availability links, confirm that you have generated these for the candidate's interview for take home submission links, confirm that a take home activity is on the candidate profile and that you have generated a take home activity self submission link candidate responses in whatsapp if a candidate responds to a message, the inbound message opens a 24 hour free form messaging window so you can respond without needing to use another template a free form response costs 1 credit you are not charged credits for receiving messages from the candidate the candidate's response will show in the whatsapp tab of the candidate feed you can opt to receive email or slack notifications for whatsapp responses within personal settings > notification settings to ensure you receive email or slack notifications when a candidate messages, enable the candidate replied to a text message and/or candidate replied to your text message toggles an inbound whatsapp message from a candidate opens a 24 hour free form messaging window if you receive a notification that the candidate has responded to your text message, then you can reply from the email or slack notification received if you are responding outside of the 24 hour window, you will only have the option to send an approved template using whatsapp templates in scheduling defaults and schedule interview activities to set whatsapp templates in scheduling defaults, navigate to admin > interviews & scheduling > scheduling defaults for more on scheduling defaults, check out setting scheduling defaults docid\ obyntivrg5pxertem4tml to set whatsapp templates in specific schedule interview activities, navigate to a job, click the interview plan tab, and then either click an existing activity or create a new one for more on overriding scheduling default settings in schedule interview activities, check out setting up schedule interview activities docid 0z5jm eqkvzq oqc03rer you can set whatsapp templates as defaults in the following cases when sending a direct booking link out for an interview when sending a confirmation message after you schedule the interview when sending interview reminders to the candidate on the communications tab of scheduling defaults or in your schedule interview activity use the direct booking whatsapp template dropdown to determine the template used when sending a direct booking link out for an interview the screenshot shows the direct booking whatsapp template dropdown use the candidate confirmation whatsapp template dropdown to determine the template used when sending an interview confirmation whatsapp message the screenshot shows the candidate confirmation whatsapp template dropdown on the reminders tab of scheduling defaults or in your schedule interview activity click + add candidate reminder in the candidate reminders section select whatsapp using the send selector use the when fields to determine when ashby sends the reminder select the template with the using template dropdown faqs do candidate replies use credits? no only messages your team sends (outbound messages) consume credits can i purchase additional texting credits? yes, you can find our guide on this at how do i purchase additional email lookups, ai credits or texting credits in app? docid\ edqz9zv9vdcljyzsxjdhe can i message a candidate who never saw the opt in question? not automatically the message waits, marked with a waiting for consent indicator to send it, consent would need to be gathered outside of ashby, then the user can override the consent status on the candidate profile once the candidate grants consent they can then re send a pending message with a waiting for consent indicator what happens if i try to message a candidate and they have opted out of whatsapp messaging? the message will not be sent to the candidate and a consent not given indicator will show beside the message a consent not given indicator will show if the candidate has opted out and you try to send a message are there restrictions on what tokens i can use in a template? yes the following restrictions are from meta a template can't start or end with a token two tokens can't be back to back tokens can't contain new lines every token needs an example value before submission templates are capped at 10 emojis can whatsapp conversations be filtered or reported on like other data in ashby? not currently what isn't supported with whatsapp messages? rich text messages can’t be sent inbound rich text messages will still show you can’t send or receive pictures or any non text content we currently do not support emoji reactions to messages if the candidate emoji reacts to a message, you will not see it or be notified support for your org to use non us/canada phone numbers please note, this will limit your ability to message candidates who have phone numbers from brazil and indonesia per brand whatsapp business accounts we currently support one whatsapp business account for the entire organization, but each brand is a phone number under the whatsapp business account ashby does not support using customer numbers