商談の前に「この会社の人と、社内の誰かがもう会っていないか」を確認したいことがあります。Sansan に名刺が入っていても、会社名で検索し、名刺を 1 枚ずつ開いて、持ち主と交換日を書き写すのは手間です。この記事は Sansan を使っている営業の人と、その設定をする管理者に向けて、Sansan の名刺とコンタクトの記録を AI チャットから調べる手順を説明します。
あわせて、Sansan の公式の API(Sansan Open API)の使い方と、AI からつなぐときに決めておくことも整理します。
結論
- Sansan には公式の API(Sansan Open API)があります。 使う人ごとに API キーを発行し、そのキーを発行した人の権限で名刺を読みます。発行するには、先に自社の Sansan 管理者から API を使う権限をもらう必要があります
- Samurai App の Sansan 連携は、名刺・人物・タグ・コンタクトの記録を読むだけ です。名刺やコンタクトの登録・編集・削除はしません。名刺の画像も扱いません
- 管理者かマネージャーが Sansan を有効にしたあと、使う人がそれぞれ自分の API キーを登録します。読める名刺の範囲は、Sansan での本人の権限と同じです
- 商談前の調べ物では、会社名で社内の名刺を検索する、同じ人の最新の名刺を見る、期間を決めて面会やメールの記録を並べる、の 3 つを組み合わせます
Sansan の名刺を調べる 3 つの方法
| Sansan の画面で調べる | Open API を自社のツールで使う | AI チャットから API で読む | |
|---|---|---|---|
| 必要なもの | Sansan のアカウント | API キーと、API を呼ぶ仕組み | API キーと、API 連携に対応した AI |
| 向いていること | 1 人の名刺を確認する | CRM などへ名刺を定期的に写す | 会話しながら条件を変えて調べる |
| まとめる手間 | 人が書き写す | 作った仕組みによる | AI が表や要約にする |
Sansan の画面 で調べるのが、いちばん確実です。名刺の画像も含めて確認できます。その代わり、会社名で検索した結果を並べ直したり、別の記録と突き合わせたりするのは人の仕事です。
Sansan Open API は、Sansan が公開している API です。公式のリファレンスでは、API キーをリクエストのヘッダに載せて呼び、名刺・人物・タグ・コンタクトなどを取得できます。API キーはユーザーごとに発行され、呼び出しは 1 つのキーにつき 1 秒に 10 回までです。API の利用には Sansan の API 利用規約が適用されます。
AI チャットから API で読む 方法は、Open API の読み取りを AI に任せる形です。「この会社の名刺を社内全体で」「先月の面会の記録を」と言い方を変えながら調べられます。Samurai App の Sansan 連携はこの方法です。
Samurai App でできること・できないこと
チャットからできること
- 自分がどの Sansan ユーザーとして操作するかを確認する
- 名刺を会社名・氏名・メール・電話番号・タグで検索する。会社名と電話番号は部分一致、氏名は前方一致、メールは完全一致です。並びは登録の新しい順で、1 回 100 件まで(既定は 25 件)
- 検索の範囲は、既定では自分が持っている名刺です。「社内全体で」と頼むと、自分が見られるすべての名刺から検索します
- 名刺 1 枚の内容を見る。会社名、部署、役職、氏名と読み、メール、電話、携帯、FAX、URL、住所、交換日、持ち主、メモ、タグが返ります
- 同じ人物としてまとめられた名刺のうち、最新の 1 枚を見る
- タグの一覧を見る
- 期間を決めて、コンタクト(面会・電話・メール・名刺交換など)の記録を一覧する。期間はその記録が更新された日時で指定し、新しく更新された順に並びます
できないこと
- 名刺やコンタクトの登録、編集、削除。Sansan の API には登録の API もありますが、Samurai App からは使いません
- 名刺の画像を見ること
- Sansan で本人に見えない名刺を見ること。範囲は登録した API キーの持ち主の権限で決まります
- 他の人の API キーで操作すること。登録した本人の会話からだけ使えます
検索結果の続きのページは最初のページを取ってから 6 時間を過ぎると取り直しになります。
商談前に相手との接点を調べる使い方
商談の前の調べ物は、次の 3 つを順に頼むと手戻りが少なくなります。
- 相手の会社の名刺を社内全体で検索する。 「株式会社〇〇商事の名刺を社内全体で検索して、持ち主、交換日、相手の部署と役職を表にして」と頼みます。この会社の人と誰が会ったことがあるかが分かり、商談の前に話を聞く相手を決められます
- 当日会う人の最新の名刺を見る。 「〇〇さんの名刺から、同じ人物の最新の名刺を見せて」と頼むと、Sansan が同じ人としてまとめた名刺のうち、最新の 1 枚が返ります。前に交換したときから部署や役職が変わっていないかを確認できます
- 最近の接点を並べる。 「この 3 か月に更新されたコンタクトの記録から、〇〇商事との面会とメールを並べて」と頼みます。コンタクトの記録は会社名では絞れないので、期間で一覧したものから AI が相手の会社の分を拾います。期間を長くすると件数が増えるので、まず数か月で頼みます
ここで分かるのは、社内に残っている接点です。相手の会社の事業や最近のニュースといった外の情報の調べ方は、商談前の企業の調べ方と準備の順番で説明しています。2 つを合わせてから、話すことを決めます。
用意するもの
- Samurai App の管理者かマネージャー(Sansan を有効にする人)
- Sansan のアカウントと、自社の Sansan 管理者からもらった API を使う権限(使う人ごと)
- 調べた結果をどこまで社内で共有してよいかの決まり。名刺には個人の連絡先が入っています
手順
1. 管理者が Sansan を有効にする
「コネクタ」の画面(/settings/connections)を開き、「API 連携」タブで「API 連携を追加」を押します。サービスの一覧から Sansan を選び、「Sansan を有効にする」を押します。
この時点では、まだ誰も名刺を読めません。Samurai App は会社のキーを持たず、使う人がそれぞれ自分の API キーを登録する形だからです。
2. 使う人が自分の API キーを登録する
名刺を調べる人は、それぞれ次の順で登録します。
- 自社の Sansan 管理者に、API を使う権限をもらう
- Sansan の右上のメニューから[設定] →[API キー]を開き、API キーを発行する
- Samurai App の「API 連携」タブで Sansan の行を開き、「API キー」の欄に貼って「Sansan の API キーを登録する」を押す
登録が済むと、「Sansan では(名前)として操作します」と表示されます。ここに出た人の権限で、名刺を読みます。
API キーは他の人と共有しないでください。 そのキーを持つ人は、発行した人と同じ範囲の名刺を読めます。チャットの入力欄にも貼りません。
3. チャットで頼む
チャットで、誰と会うのかと、何を知りたいのかを具体的に頼みます。
明日 14 時に株式会社〇〇商事の〇〇さんと商談があります。
Sansan で社内全体の名刺を検索して、この会社の人と会ったことがある社員、交換した日、相手の部署と役職を表にして
結果を見てから、続けて頼みます。
〇〇さんの最新の名刺で、部署と役職が前の名刺から変わっていないか確認して。
あわせて、この 3 か月に更新されたコンタクトの記録から、〇〇商事との面会を並べて
返った表は商談の準備メモに貼って使えます。持ち主の社員に前回の様子を聞くときにも、交換日とメモが手がかりになります。
注意点
読める名刺の範囲は、Sansan での本人の権限と同じです。 「社内全体で」と頼んでも、Sansan で自分が見られない名刺は返りません。人によって結果が違うのはこのためです。
API キーを Sansan 側で無効にすると、登録も使えなくなります。 使えないと返ったら、新しいキーを発行して登録し直します。管理者が Sansan を無効にすると、全員の API キーの登録が削除されます。Sansan の名刺やコンタクトはそのまま残ります。
名刺の内容が古いことがあります。 名刺は交換した時点の情報です。同じ人物の最新の名刺を見ても、その後の異動は分かりません。大事な商談の前は、相手の会社のサイトや本人からの連絡で確認します。
個人の連絡先を広く流さない。 名刺のメールや携帯の番号を、関係のないチャンネルや資料に貼らないでください。共有するのは、商談に必要な範囲だけにします。
よくある質問
Sansan の API はどの契約で使えますか
2026 年 11 月 9 日時点で、Sansan Open API の公式リファレンスには、どの契約やプランで使えるかは書かれていませんでした。API キーを発行するには、自社の Sansan 管理者から API を使う権限をもらう必要があります。契約の条件は Sansan の管理者か Sansan の担当者に確認してください。
チャットから名刺を登録したり、メモを書き足したりできますか
できません。Samurai App の Sansan 連携は読み取りだけです。名刺の登録、メモやタグの編集は Sansan の画面で行います。
他の社員が交換した名刺も見られますか
Sansan で自分が見られる名刺なら読めます。「社内全体で」と頼むと、自分が持っている名刺に限らず、自分が見られるすべての名刺から検索します。見られる範囲は Sansan の権限の設定で決まります。
名刺の画像は見られますか
見られません。この連携は名刺の文字の情報だけを読みます。画像で確認したいときは、Sansan の画面で名刺を開きます。
商談のあとに、面会の記録を Sansan に残せますか
Samurai App からはできません。コンタクトの記録は一覧して読むだけです。面会の記録は Sansan の画面で残します。
出典
- Sansan Open API リファレンス v6.0(Sansan 株式会社)
- 外部サービスとの連携(Samurai App の使い方)
- API 連携の各サービスの繋ぎ方(Samurai App の使い方)
2026 年 11 月 9 日時点で、Sansan Open API の公式リファレンスを確認したものです。