SHANON MARKETING PLATFORM API GUIDE
  • APIの利用方法
    • APIの利用方法
    • 認証
    • APIコールとメソッドリファレンス
    • 検索
    • 登録・更新
  • クライアントアプリケーション認証
    • authentication.get
  • 画面ユーザ認証
    • authapi.login
    • authinfo.getToken
    • authinfo.getCheck
    • authinfo.logout
    • authapi.agencynavigation
    • authapi.agencynavigation.back
  • 管理者
    • admin.get
    • admin.post
    • admin.put
    • admin.delete
  • キャンペーン
    • seminar.get
    • seminar.post
    • seminar.put
    • seminar.delete
    • seminaritemsetting.get
    • seminar.getSession
    • seminar.postSession
    • seminar.putSession
    • seminar.deleteSession
    • sessionitemsetting.get
  • 担当者割当
    • admin.getAssinmentSeminar
    • admin.postAssinmentSeminar
    • admin.deleteAssinmentSeminar
  • アンケート
    • enquetetemplate.get
    • enquetetemplate.getQuestion
  • 講演者
    • speaker.get
    • speakersetting.get
  • 資料
    • document.get
  • リスト
    • staticlist.get
    • staticlist.post
    • staticlist.put
    • staticlist.delete
  • リスト・リード管理
    • staticlist.getVisitor
    • staticlist.postVisitor
    • staticlist.deleteVisitor
  • 企業
    • company.get
    • company.post
    • company.put
    • company.delete
  • 企業・リード管理
    • company.getVisitor
    • company.postVisitor
    • company.deleteVisitor
  • リード
    • visitor.get
    • visitor.post
    • visitor.put
    • visitor.delete
    • visitor.getFile
    • visitor.postFile
    • visitor.putFile
    • visitor.deleteFile
    • visitorsetting.get
  • 申込
    • application.post
    • application.delete
    • seminar.getDiscount
    • visitor.getDiscounthistory
    • visitor.getBilling
    • visitor.getApplication
    • visitor.putApplication
    • counting.getApplication
  • キャンペーン申込情報
    • visitor.getApplicationSeminar
    • visitor.getApplicationSession
  • 申込フロー
    • seminar.getFlow
  • 来場
    • visitor.getAttendance
    • visitor.getAttendanceSeminar
    • visitor.postAttendanceSeminar
    • visitor.deleteAttendanceSeminar
    • visitor.getAttendanceSession
    • visitor.postAttendanceSession
    • visitor.deleteAttendanceSession
    • counting.getAttendance
  • メール送信
    • visitor.postMail
    • 一斉メール送信APIの利用方法
    • mailtemplate.get
    • mailtemplate.post
    • mailtemplate.put
    • mailtemplate.delete
    • mailsender.get
    • mailsender.post
    • mailsender.delete
  • クリックカウント
    • clickcounturl.get
  • トラッキング
    • trackingurl.get
  • メール履歴情報
    • visitor.getMail
  • アンケート履歴情報
    • visitor.getEnquete
    • enquetehistory.get
  • クリックカウント履歴情報
    • visitor.getClickcount
  • トラッキング履歴情報
    • visitor.getTrackingaccesslog
    • visitor.getTrackingsession
  • 資料履歴情報
    • visitor.getDocumentdownload
  • 活動履歴情報
    • visitor.getActivity
    • visitor.postActivity
    • visitor.putActivity
    • visitor.deleteActivity
    • activitysetting.get
  • リード変更履歴情報
    • visitor.getChangelog
    • visitor.getAddlog
    • visitor.getDeletelog
    • visitor.getMergelog
  • DM個別送信履歴情報
    • visitor.getDirectMail
  • キャンペーン設定
    • seminarsettingdata.get
    • seminarsettingdata.put
  • メッセージ
    • messagestr.get
    • messagestr.put
  • ファイル情報
    • file.get
    • file.post
  • 検索条件
    • searchcondition.get
  • バルクAPI
    • 概要
    • bulkapi.get
    • bulkapi.post
  • APPENDIX
    • APIメソッドリファレンス
    • 用語について
    • 共通エラーコード一覧
    • 都道府県IDと都道府県名の対応表
    • タイムゾーンIDとタイムゾーン名の対応表
    • 非推奨API
    • 改訂履歴
Home >> Visitor.postMail

リード宛メール送信API

マーケティングプラットフォームのリード宛てにメール送信するためのAPIです。

メソッド名

visitor.postMail

リクエスト情報

アクセスURL

メソッド URL
POST https://{domainname}/services/rest/visitor/mail

URL部パラメータ

なし

HTTPリクエストヘッダ

なし

HTTPリクエストボディ

★ エレメント名:Mail ★ データ型:MailType

カラム名 必須 データ型 内容
VisitorId 必須 string 宛先リードID
MailType 必須 MailTypeType メールタイプ
MailTypeId:MailTypeName
1:テキスト形式
2:HTML形式
3:マルチパート形式
Title 必須 string タイトル
SenderAddress オプション string 送信者E-mailアドレス
SenderName オプション string 送信者名
Cc オプション string CC

※複数メールアドレスを指定する場合にはアドレスをカンマ区切りで指定してください。
Bcc オプション string BCC

※複数メールアドレスを指定する場合にはアドレスをカンマ区切りで指定してください。
ReplyTo オプション string 返信先
ReturnPath オプション string エラー時返信先
Body オプション string 本文
Body2 オプション string 本文2
(マルチパート形式におけるHTML文面)
Id オプション string メール情報ID
Charset オプション CharsetType 文字コード
CharsetId:CharsetName
文字コードID:文字コード名
AttachmentFile オプション AttachmentFileType 添付ファイル
AttachmentFileId:ファイルID
AttachmentFileName:ファイル名AttachmentFileExtension:ファイル拡張子
SenderDomainAuthentication オプション SenderDomainAuthenticationType 送信ドメイン
SenderDomainAuthenticationId:送信ドメイン ID
SenderDomainAuthenticationName:設定名

※こちらを指定された場合、SenderAddressの末尾に”@” + 送信ドメインのドメインを付与します。

レスポンス情報

なし

レスポンスコード

コード 内容
201 正常終了

HTTPレスポンスヘッダ

なし

HTTPレスポンスボディ

なし

XMLサンプル

なし

XMLサンプル

リクエストXMLサンプル

送信ドメインを指定しない場合

<?xml version='1.0' encoding='UTF-8'?>
<Mail xmlns="http://smartseminar.jp/">
 <AttachmentFile>
  <AttachmentFileId>6409</AttachmentFileId>
  <AttachmentFileName>プロモーション資料131118</AttachmentFileName>
  <AttachmentFileExtension>pdf</AttachmentFileExtension>
 </AttachmentFile>
 <Bcc>failurebcc@shanon.co.jp</Bcc>
 <Body>これはメールボディー</Body>
 <Body2>これはメールボディー2</Body2>
 <Cc>failfailure_cc@shanon.co.jp</Cc>
 <MailType>
  <MailTypeId>1</MailTypeId>
  <MailTypeName>マルチパート形式</MailTypeName>
 </MailType>
 <ReplyTo>failurefailure_reply_to@shanon.co.jp</ReplyTo>
 <ReturnPath>failurefailure_return_path@shanon.co.jp</ReturnPath>
 <SenderAddress>system@smartseminar.jp</SenderAddress>
 <SenderName>シャノン管理者</SenderName>
 <Title>タイトル</Title>
 <VisitorId>10</VisitorId>
</Mail>

送信ドメインを指定する場合

<?xml version='1.0' encoding='UTF-8'?>
<Mail xmlns="http://smartseminar.jp/">
 <AttachmentFile>
  <AttachmentFileId>6409</AttachmentFileId>
  <AttachmentFileName>プロモーション資料131118</AttachmentFileName>
  <AttachmentFileExtension>pdf</AttachmentFileExtension>
 </AttachmentFile>
 <Bcc>failurebcc@shanon.co.jp</Bcc>
 <Body>これはメールボディー</Body>
 <Body2>これはメールボディー2</Body2>
 <Cc>failfailure_cc@shanon.co.jp</Cc>
 <MailType>
  <MailTypeId>1</MailTypeId>
  <MailTypeName>マルチパート形式</MailTypeName>
 </MailType>
 <ReplyTo>failurefailure_reply_to@shanon.co.jp</ReplyTo>
 <ReturnPath>failurefailure_return_path@shanon.co.jp</ReturnPath>
 <SenderAddress>system</SenderAddress>
 <SenderName>シャノン管理者</SenderName>
 <Title>タイトル</Title>
 <VisitorId>10</VisitorId>
 <SenderDomainAuthentication>
  <SenderDomainAuthenticationId>2</SenderDomainAuthenticationId>
  <SenderDomainAuthenticationName>smartseminar.jpの設定</SenderDomainAuthenticationName>
 </SenderDomainAuthentication>
</Mail>

レスポンスXMLサンプル

なし

制限事項

  • メール本文へスクリプトタグの埋め込み() および半角カナ・記号(。「」、・)の入力はできません。
  • 添付ファイル (AttachmentFile) を利用する場合、ファイル情報API (file.post) を利用して予めファイルをアップロードする必要があります。一度使用したファイルは繰り返し指定できません。ファイルのサイズの上限は 2.5 MB です。
  • リード宛メール送信API(visitor.postMail)で送信したメールについては、クリックカウント履歴、メール開封履歴を取得することはできません。これらを取得する場合には、一斉メール配信情報登録API(mailsender.post)をご利用の上、メール送信を行ってください。
  • 詳しくは、APIの利用方法よりメール送信APIをご参照ください。

注意事項

  • 送信ドメイン(SenderDomainAuthentication)を指定された場合、登録時にSenderAddressの末尾に”@” + 送信ドメインのドメインを付与します。
    • そのため、SenderAddressに関してはメールアカウント部(@の前までの文字列)のみ指定してください。
    • また、DKIMの指定も不要となります。(送信ドメイン側でDKIMを指定しているため)