To send individual and mass email with Apex, use the following classes:
- SingleEmailMessage
- Instantiates an email object used for sending a single email message.
The syntax is:
Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage(); - MassEmailMessage
- Instantiates an email object used for sending a mass email message.
The syntax is:
Messaging.MassEmailMessage mail = new Messaging.MassEmailMessage(); - Messaging
- Includes the static sendEmail method, which sends the email objects you instantiate with either
the SingleEmailMessage or MassEmailMessage classes, and returns
a SendEmailResult object.
The syntax for sending an email is:Messaging.sendEmail(new Messaging.Email[] { mail } , opt_allOrNone);where Email is either Messaging.SingleEmailMessage or Messaging.MassEmailMessage. - Includes the static reserveMassEmailCapacity and reserveSingleEmailCapacity methods, which can be called before sending any emails to ensure
that the sending organization won't exceed its daily email limit when
the transaction is committed and emails are sent. The syntax is:
Messaging.reserveMassEmailCapacity(count);
andMessaging.reserveSingleEmailCapacity(count);
where count indicates the total number of addresses that emails will be sent to.
Note the following:
- The email is not sent until the Apex transaction is committed.
- The email address of the user calling the sendEmail method is inserted in the From Address field of the email header. All email that is returned, bounced, or received out-of-office replies goes to the user calling the method.
- Maximum of 10 sendEmail methods per transaction. Use the Limits methods to verify the number of sendEmail methods in a transaction.
- Single email messages sent with the sendEmail method count against the sending organization's daily single email limit. When this limit is reached, calls to the sendEmail method using SingleEmailMessage are rejected, and the user receives a SINGLE_EMAIL_LIMIT_EXCEEDED error code. However, single emails sent through the application are allowed.
- Mass email messages sent with the sendEmail method count against the sending organization's daily mass email limit. When this limit is reached, calls to the sendEmail method using MassEmailMessage are rejected, and the user receives a MASS_MAIL_LIMIT_EXCEEDED error code.
- Any error returned in the SendEmailResult object indicates that no email was sent.
Example
// First, reserve email capacity for the current Apex transaction to ensure // that we won't exceed our daily email limits when sending email after // the current transaction is committed. Messaging.reserveSingleEmailCapacity(2); // Processes and actions involved in the Apex transaction occur next, // which conclude with sending a single email. // Now create a new single email message object // that will send out a single email to the addresses in the To, CC & BCC list. Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage(); // Strings to hold the email addresses to which you are sending the email. String[] toAddresses = new String[] {'user@acme.com'}; String[] ccAddresses = new String[] {'smith@gmail.com'}; // Assign the addresses for the To and CC lists to the mail object. mail.setToAddresses(toAddresses); mail.setCcAddresses(ccAddresses); // Specify the address used when the recipients reply to the email. mail.setReplyTo('support@acme.com'); // Specify the name used as the display name. mail.setSenderDisplayName('Salesforce Support'); // Specify the subject line for your email address. mail.setSubject('New Case Created : ' + case.Id);
//Required if using a template, optional otherwise. The ID of the contact, lead, or user to //which the email will be sent. The ID you specify sets the context and //ensures that merge fields in the template contain the correct data.
mail.SetTargetObjectId(userId);
// Set to True if you want to BCC yourself on the email. mail.setBccSender(false); // Optionally append the salesforce.com email signature to the email. // The email address of the user executing the Apex Code will be used. mail.setUseSignature(false); // Specify the text content of the email. mail.setPlainTextBody('Your Case: ' + case.Id +' has been created.'); mail.setHtmlBody('Your case:<b> ' + case.Id +' </b>has been created.<p>'+ 'To view your case <a href=https://na1.salesforce.com/'+case.Id+'>click here.</a>'); // Send the email you have created. Messaging.sendEmail(new Messaging.SingleEmailMessage[] { mail });
