Skip to main content

Inbound Email Parser

The inbound email parser is an Apex Inbound Email Handler which can be set up to receive emails, and then have them parsed by candidates. Once this has been set up, it is a completely automated mechanism for creating candidates from CVs.

Setup

The inbound email parser is setup by creating an Apex Inbound Email Service for the managed ParseCandidateEmailService apex class. The settings for this email service can be configured as desired, however the Accept Attachments setting must be set to All.

tip

It's best to configure a bounced address so any failed parses can be manually retried.

Parsing the email

When an email is received to the handler's inbox, it is checked for a binary attachment. If no attachment is found an error response is returned with the message "Email did not have any attachments".

The binary attachment is saved as a ContentVersion and a queueable is initialised to perform the actual parsing, a success response is then returned from the email handler at this point.

The CV is then parsed and a contact record is created, with the default candidate record type. Additionally, the education and employment history will be created as seven20__Education_History__c and seven20__Employment_History__c records respectively.

danger

If more than one attachment is present, only the first one is parsed and treated as a CV.

danger

Unlike the manual parsers, any failed insert will cause all records to not be created.