この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

EmailMessage

Salesforce のメールを表します。

サポートされているコール

create()、delete()、describeLayout()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()、search()、undelete()、update()、upsert()

特別なアクセスルール

EmailMessage は、メール-to-ケースまたは拡張メールを使用している組織でのみ使用可能です。これらは、ほとんどのお客様で自動的に有効になっています。

返信および転送機能を使用するには、EmailMessageRelation に存在するメールアドレスを FromAddress に指定し、RelationType を FromAddress にする必要があります。

カスタマーポータルユーザには、ParentID 項目の値がケースに関連付けられていれば、EmailMessage への参照アクセス権があります。それ以外の場合、アクセス権は関連付けられた ToDo の共有アクセス権によって決まります。

Status 項目はほとんどの場合、参照のみです。状況を New から Read に変更することのみ可能です。

update() がサポートされるのは、メールレコードが Draft 状況で IsPrivateDraft が false の場合です。また、Status と IsPrivateDraft が true で CreatedBy が現在のユーザに関連付けられている場合もサポートされます。メールレコードの状況が Draft でない場合は、IsExternallyVisible 項目とカスタム項目のみを更新できます。

項目

項目	詳細
ActivityId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明メールに関連付けられている活動の ID。通常、読み取られていない新しいメールメッセージが受信された場合にケース所有者に対して作成される進行中の ToDo を表します。ケースのメールに対してのみ ActivityId を指定できます。他のエンティティではこれは自動作成されます。
BccAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージの BCC が送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けらていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを BccAddress 項目に追加するのではなく、ID を BccIds 項目に追加します。ID を追加すると、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。Experience Cloud サイトユーザがメールの送信者ではない場合、この項目は null を返します。少なくとも 1 人の受信者がいない限り、メールを送信できません。
BccIds	型 JunctionIdList プロパティ Create、Update 説明メールメッセージの BCC が送信された取引先責任者、リード、およびユーザの ID の文字列配列。各 ID は EmailMessageRelation レコードにリンクされます。このレコードは、メールメッセージと取引先責任者、リード、またはユーザレコード間のリレーションを表します。Experience Cloud サイトユーザがメールの送信者ではない場合、このリストは空です。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
CcAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージの CC が送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けらていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを CcAddress 項目に追加するのではなく、ID を CcIds 項目に追加します。そうすることで、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。少なくとも 1 人の受信者がいない限り、メールを送信できません。
CcIds	型 JunctionIdList プロパティ Create、Update 説明メールメッセージの CC が送信された取引先責任者、リード、およびユーザの ID の文字列配列。各 ID は EmailMessageRelation レコードにリンクされます。このレコードは、メールメッセージと取引先責任者、リード、またはユーザレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
ClientThreadIdentifier	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールが属するスレッドを識別するサードパーティメールクライアントで使用される値。メールヘッダーで検出された場合にのみ保存されます。この項目がサードパーティのメールクライアントに固有の形式である場合は、メールスレッドを識別するために、メール-to-ケースでこの項目を使用できます。API バージョン 56.0 以降で利用できます。
ContentDocumentIds	型 JunctionIdList プロパティ Create、Update 説明メールに関連付けられた、ファイルや添付ファイルなどのコンテンツドキュメントの ID の文字列配列。ID はそれぞれ ContentDocumentLink レコードにリンクされます。このレコードはメールメッセージとコンテンツドキュメントレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
Division	型 picklist プロパティ Defaulted on create、Filter、Group、Restricted picklist、Sort 説明組織のデータの論理セグメントです。たとえば、会社がさまざまな事業単位によって構成されている場��、「北米」、「ヘルスケア」、「コンサルティグ」など、各事業単位のディビジョンを作成することができます。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
EmailTemplateId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明メールに選択されたメールテンプレート (存在する場合)。この項目は、Lightning Experience でのみ入力されます。これはリレーション項目です。リレーション名 EmailTemplate リレーション種別 Lookup 参照先 EmailTemplate
FirstOpenedDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが最初に開封された日付。この項目を表示するには、組織でメール追跡を有効にします。メモ
FromAddress	型 email プロパティ Create、Filter、Nillable、Sort、Update 説明メールが作成されたアドレス。この項目を使用する場合、EmailMessageRelation に存在するメールアドレスを指定し、RelationType を `FromAddress` にします。
FromName	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明送信者の名前。この項目を使用する場合、EmailMessageRelation に存在するメールアドレスを指定し、RelationType を `FromAddress` にします。
HasAttachment	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明メールがファイルを添付して送信されたか (`true`)、否か (`false`) を示します。
Headers	型 textarea プロパティ Create、Nillable、Update 説明受信メールのインターネットメッセージのヘッダー。デバッグおよび追跡の目的で使用されます。送信メールには適用されません。
HtmlBody	型 textarea プロパティ Create、Nillable、Update 説明メールの本文 (HTML 形式)。次の少なくとも 1 つの項目にコンテンツが含まれない限り、メールを送信できません。 [件名] 項目 [HTML 内容] または [テキスト内容] 項目送信者はコンテンツを提供できます。また、定義済みの値を使用してコンテンツを自動的に挿入することもできます。メールテンプレートにこれらの項目のコンテンツを含めることもできます。
Incoming	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明メールが受信されたか (`true`)、送信されたか (`false`) を示します。
IsBounced	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明メールがバウンスしたかどうかを示します。この項目を表示するには、組織で不達管理を有効にします。メモ
IsClientManaged	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明 IsClientManaged が true に設定されて EmailMessage が作成された場合、EmailMessage の Status が `Draft` に設定されていない場合でも、ユーザは EmailMessage.ContentDocumentIds を変更して添付ファイルをリンクできます。メールケースフィードに添付ファイルを表示するには、この項目を `true` に設定します。メモ
IsDeleted	型 boolean プロパティ Defaulted on create、Filter 説明オブジェクトがごみ箱に移動したか (`true`)、否か (`false`) を示します。表示ラベルは Deleted です。
IsExternallyVisible	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明 Experience Cloud サイトのケースフィードが有効化されている場合、IsExternallyVisible によってサイトでのメールの外部表示が制御されます。IsExternallyVisible がデフォルト値の `true` に設定されている場合、外部ユーザはケースフィードでメールを参照できます。この項目が `true` に設定されているかどうかにかかわらず、[メール] 関連リストにはメールが表示されます。必要に応じて、この関連リストを外部コミュニティユーザ用のケースページレイアウトから削除できます。 ParentId 項目に値があるメールのみをサイトで外部表示できます。メールの Status が `Draft` に設定されている場合、この項目は更新できません。メモ
IsOpened	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明メールが開封されたかどうかを示します。この項目を表示するには、組織でメール追跡を有効にします。メモ
IsPrivateDraft	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明 IsPrivateDraft が true に設定されている場合、CreatedById ユーザのみがこのメールドラフトを表示、更新、および送信できます。IsPrivateDraft が false に設定されている場合、ケースで作業するための権限を持つすべてのユーザがこのドラフトを表示できます。メールが送信されると、この項目は false に更新されます。公開ドラフトは Salesforce Classic に読み込まれて表示されますが、非公開ドラフトは Lightning Experience でのみ使用されます。
IsTracked	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明メールが追跡されているかどうかを示します。この項目を表示するには、組織でメール追跡を有効にします。メモ
LastOpenedDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが最後に開封された日付。この項目を表示するには、組織でメール追跡を有効にします。メモ
MessageDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが作成された日付。受信メールの場合、この項目は日付ヘッダーを使用してメール-to-ケースで設定されます。日付ヘッダーはメールクライアントによって設定され、送信者の時間設定が適用されます。
MessageIdentifier	型 string プロパティ Create、Filter、Group、idLookup、Nillable、Sort、Update 説明メールメッセージの ID。
Name	型 string プロパティ Filter、Group、idLookup、Sort 説明 [件名] 項目の最初の 255 文字から取得されるメールメッセージの名前。[件名] 項目が空の場合、`[No Subject]` のローカライズされた文字列が使用されます。この項目は参照のみで作成または更新できません。API バージョン 56.0 以降で利用できます。
ParentId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明メールに関連付けられたケースの ID。これはリレーション項目です。リレーション名 Parent リレーション種別 Lookup 参照先 Case
RelatedToId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 RelatedToId は、取引先、商談、キャンペーン、ケース、カスタムオブジェクトなど、人以外のオブジェクトを表します。RelatedToIds は多態的です。多態的とは、RelatedToId が関連オブジェクトの ID に相当することを意味します。これは多態的なリレーション項目です。リレーション名 RelatedTo リレーション種別 Lookup 参照先 Account、Accreditation、AssessmentIndicatorDefinition、AssessmentTask、AssessmentTaskContentDocument、AssessmentTaskDefinition、AssessmentTaskOrder、Asset、AssetRelationship、AssignedResource、Award、BoardCertification、BusinessLicense、BusinessMilestone、BusinessProfile、Campaign、CareBarrier、CareBarrierDeterminant、CareBarrierType、CareDeterminant、CareDeterminantType、CareDiagnosis、CareInterventionType、CareMetricTarget、CareObservation、CareObservationComponent、CarePgmProvHealthcareProvider、CarePreauth、CarePreauthItem、CareProgram、CareProgramCampaign、CareProgramEligibilityRule、CareProgramEnrollee、CareProgramEnrolleeProduct、CareProgramEnrollmentCard、CareProgramGoal、CareProgramProduct、CareProgramProvider、CareProgramTeamMember、CareProviderAdverseAction、CareProviderFacilitySpecialty、CareProviderSearchableField、CareRegisteredDevice、CareRequest、CareRequestDrug、CareRequestExtension、CareRequestItem、CareSpecialty、CareSpecialtyTaxonomy、CareTaxonomy、Case、CommSubscriptionConsent、ContactEncounter、ContactEncounterParticipant、ContactRequest、Contract、CoverageBenefit、CoverageBenefitItem、CreditMemo、DelegatedAccount、DocumentChecklistItem、EnrollmentEligibilityCriteria、HealthcareFacility、HealthcareFacilityNetwork、HealthcarePayerNetwork、HealthcarePractitionerFacility、HealthcareProvider、HealthcareProviderNpi、HealthcareProviderSpecialty、HealthcareProviderTaxonomy、IdentityDocument、Image、IndividualApplication、Invoice、ListEmail、Location、MemberPlan、Opportunity、Order、OtherComponentTask、PartyConsent、PersonLifeEvent、PlanBenefit、PlanBenefitItem、ProcessException、Product2、ProductItem、ProductRequest、ProductRequestLineItem、ProductTransfer、PurchaserPlan、ReceivedDocument、ResourceAbsence、ReturnOrder、ReturnOrderLineItem、ServiceAppointment、ServiceResource、Shift、Shipment、ShipmentItem、Solution、Visit、VisitedParty、VolunteerProject、WorkOrder、WorkOrderLineItem
ReplyToEmailMessageId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明現在のメールメッセージの返信先である受信または送信メールメッセージの ID。Status が `Draft` であるメッセージに返信することはできません。これはリレーション項目です。これは、設定時にケース関連メールの返信にのみ設定されます。リレーション名 ReplyToEmailMessage リレーション種別 Lookup 参照先 EmailMessage
Status	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明メールの状況。 Status 項目はほとんどの場合、参照のみです。状況を `New` から `Read` に変更することのみ可能です。可能な値は次のとおりです。 `0` (新規) `1` (既読) `2` (返信済み) `3` (送信済み) `4` (転送済み) `5` (下書き) ケースの一部として送信されないメールでは、`3` (送信済み) のみが有効です。
Subject	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールの件名行。次の少なくとも 1 つの項目にコンテンツが含まれない限り、メールを送信できません。 [件名] 項目 [HTML 内容] または [テキスト内容] 項目送信者はコンテンツを提供できます。また、定義済みの値を使用してコンテンツを自動的に挿入することもできます。メールテンプレートにこれらの項目のコンテンツを含めることもできます。
TextBody	型 textarea プロパティ Create、Nillable、Update 説明メールの本文 (平文テキスト形式)。TextBody が設定されていない場合、HtmlBody から抽出されます。次の少なくとも 1 つの項目にコンテンツが含まれない限り、メールを送信できません。 [件名] 項目 [HTML 内容] または [テキスト内容] 項目送信者はコンテンツを提供できます。また、定義済みの値を使用してコンテンツを自動的に挿入することもできます。メールテンプレートにこれらの項目のコンテンツを含めることもできます
ThreadIdentifier	型 string プロパティ Create、Filter、Group、idLookup、Nillable、Sort、Update 説明メールメッセージが属しているメールスレッドの ID。
ToAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージが送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けらていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを ToAddress 項目に追加するのではなく、ID を ToIds 項目に追加します。そうすることで、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。少なくとも 1 人の受信者がいない限り、メールを送信できません。
ToIds	型 JunctionIdList プロパティ Create、Update 説明メールメッセージの CC が送信された取引先責任者、リード、およびユーザの ID の文字列配列。各 ID は EmailMessageRelation レコードにリンクされます。このレコードは、メールメッセージと取引先責任者、リード、またはユーザレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
ValidatedFromAddress	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明送信者のアドレス、メールが作成された検証済みの組織の共有メールアドレス、またはメール-to-ケースのルーティングアドレスが含まれる選択リスト値。 ValidatedFromAddress は、Group By または Sort By ステートメントでの使用には適していません。代わりに FromAddress を使用します。メモ

使用方法

組織でメール-to-ケースを使用している場合、メールが会社のアドレスのいずれかに送信されるとケースが作成されます。メールは、ParentID 項目によってケースに関連付けられ、EmailMessage レコードに保存されます。ユーザがメールを参照すると、EmailMessage レコードが表示されます。

組織で拡張メールを使用している場合、各メールは EmailMessage レコードおよび ToDo レコードとして保存されます。ユーザがメールを参照すると、EmailMessage レコードが表示されます。

サンプルコード — Apex

このサンプルログでは、Salesforce での活動をメールで送信します。

1// if EnhancedEmail Perm is not enabled, continue logging the email as a task
2
3// if EnhancedEmail Perm is enabled, create an EmailMessage object
4EmailMessage emailMessage = new EmailMessage();
5emailMessage.status = '3'; // email was sent
6emailMessage.relatedToId = '006B0000003weZGIAY'; // related to record e.g. an opportunity
7emailMessage.fromAddress = 'sender@example.com'; // from address
8emailMessage.fromName = 'Dan Perkins'; // from name
9emailMessage.subject = 'This is the Subject!'; // email subject
10emailMessage.htmlBody = '<html><body><b>Hello</b></body></html>'; // email body
11// Contact, Lead or User Ids of recipients
12String[] toIds = new String[]{'003B000000AxcEjIAJ'}; 
13emailMessage.toIds = toIds;
14// additional recipients who don’t have a corresponding contact, lead or user id in the Salesforce org (optional)
15emailMessage.toAddress = 'emailnotinsalesforce@toexample.com, anotherone@toexample.com';
16insert emailMessage; // insert
17
18// Add Email Message Relation for id of the sender
19EmailMessageRelation emr = new EmailMessageRelation();
20emr.emailMessageId = emailMessage.id;
21emr.relationId = '005B0000003qHvOIAU'; // user id of the sender
22emr.relationType = 'FromAddress';
23insert emr;

Salesforce プラットフォームのオブジェクトリファレンス

EmailMessage

サポートされているコール

特別なアクセスルール

項目

使用方法

サンプルコード — Apex

関連付けられたオブジェクト

Salesforce プラットフォームのオブジェクトリファレンス

EmailMessage

サポートされているコール

特別なアクセスルール

項目

使用方法

サンプルコード — Apex

関連付けられたオブジェクト

関連項目: