Apex Primer

Examples

Apex Email Handler

Processing Inbound Emails

Apex email handler processes inbound emails with Messaging.

Introduction to Apex Email Handlers

Apex Email Handlers provide a way to process inbound emails in Salesforce. By using the Messaging.InboundEmailHandler interface, developers can create custom logic to handle various email scenarios. This feature is particularly useful for automating tasks triggered by incoming emails, such as creating records or sending automated replies.

Implementing the Inbound Email Handler Interface

To create an Apex Email Handler, you need to implement the Messaging.InboundEmailHandler interface in your Apex class. This interface requires you to define the handleInboundEmail method, which processes the incoming email message. Below is a step-by-step guide and example code to get you started.

Setting Up Email Services in Salesforce

Once you have written your Apex class, you need to set up an Email Service in Salesforce to link your handler with incoming emails. Follow these steps:

  • Navigate to Setup in Salesforce.
  • Search for and select Email Services.
  • Click New Email Service.
  • Enter a unique name for the service and choose your handler class.
  • Specify any additional settings, such as acceptable email addresses or limits.
  • Save the service and generate an email address that Salesforce will use to receive emails.

Testing Your Email Handler

After setting up your Email Service, it's crucial to test the email handler to ensure it processes emails as expected. You can do this by sending a test email to the generated Salesforce email address and verifying that the corresponding action (e.g., creating a Case) occurs in your Salesforce org.

Common Use Cases

Apex Email Handlers can be used in various scenarios, including:

  • Automatically creating records like Cases or Leads from incoming emails.
  • Parsing email content to extract and store data.
  • Sending automated responses based on email subject or content.
  • Logging email content to custom objects for analysis.

Examples

Next
Platform Event