自社サイト連携とはなんですか？

サイト上でのコンバージョンユーザーに自動でSales Docのビューアーを表示させ、閲覧状況をトラッキングすることができるようになる機能に用いるトークンのことです。

※ご留意事項※
下記に記載された連携を行うには、HTTPやJavaScriptに関する知識が必要です。もしご自身での作業に懸念があるようであれば、専門知識を持ったエンジニアやベンダーへご依頼ください。

まずは、[設定] ＞ [外部連携] ＞「トークン管理」より、トークンを発行します。

次に、トークンを組み込んだURLに対してPOSTリクエストを送信してください。
問題がなければ、URLが記載されたレスポンスが返却されます。

・リクエストするURL
https://www.sales-doc.com/api/v1/auto-url/[トークン]
※[トークン]の部分に、SalesDocで生成したトークンを入れてください。

・リクエストパラメータ
company_name : 会社名
name : 氏名
email : メールアドレス（必須）
department_name : 部署名
phone_number : 電話番号

・レスポンスの例

【成功時】

※ status = 200
{
    "url": "https://www.sales-doc.com/a1b2c3d4e5"
}

【失敗時（メールアドレスが入力されていない）】

※ status = 422
{
    "message": "The given data was invalid.",
    "errors": {
        "email": [
            "メールアドレスが必要です。"
        ]
    }
}

【失敗時（トークンが間違っている）】

※ status = 404
{
    "message": "",
}

・サンプルコード

const token = '[トークン]';
const companyName = '[会社名]';
const name = '[氏名]';
const email = '[メールアドレス]';
fetch(`https://www.sales-doc.com/api/v1/auto-url/${token}`, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json',
    },
    body: JSON.stringify({
        company_name: companyName,
        name: name,
        email: email,
    }),
}).then(function(res){
    return res.json()
}).then(function(data){
    //成功
}).catch(function(e){
    //失敗
});

# 連携