kintone と LINE の連携|問い合わせを顧客台帳の1行にする照合キーとつなぎ方

kintoneとLINE公式アカウントは、受け口を挟んでREST APIとWebhookでつなぎます。問い合わせを顧客台帳の1人1行に保つ照合キーとUPSERT、つなぎ方の選び方、料金の前提、通知の拾い直しを、デモと公式の仕様で。

この記事をシェア:
目次 クリックで開く

この記事の要点

  1. kintone に書き込む入口は REST API、外へ知らせる出口は Webhook です。LINE とは受け口(自作のサーバーか連携サービス)を挟んでつなぎます。ライトコースの契約では、どちらも使えません。
  2. 顧客台帳を1人1行に保つ鍵は、何で同じ人とみなすか(照合キー)です。LINE のユーザーIDを重複禁止の項目にすれば、UPSERT で「あれば更新・なければ追加」を1回で書けます。先に台帳にいた顧客は、フォームで聞くメールアドレスで拾います。
  3. つなぎ方は、4本の矢印と照合を誰が受け持つかで選びます。kintone の Webhook は1分60回までで、一括操作では送られないので、進み具合の通知には拾い直す仕組みを入れます。

LINE と kintone のあいだに受け口を置く:何が、どの向きで流れるか

LINE公式アカウントお客様の LINE
→↓メッセージ・フォーム・友だち追加(LINE の Webhook)
←↑受付の返信・進み具合・お知らせ(応答・プッシュ・マルチキャスト)
受け口署名の検証・保存・200・重複の除去・照合
→↓顧客の照合と追加・更新、問い合わせの起票(REST API)
←↑ステータス更新の通知(kintone の Webhook)
kintone顧客アプリ・問い合わせアプリ

結ぶキー:LINE のユーザーID(顧客アプリの、値の重複を禁止した項目)

LINE の Webhook の送信先は、1つのチャネルに1つだけ

出典:LINE Developers「メッセージ(Webhook)を受信する」、kintone ヘルプ「Webhookを設定する」、cybozu developer network「複数のレコードを更新する」

kintone と LINE公式アカウントをつなぐと、LINE で受けた問い合わせを kintone の顧客台帳の1行にまとめ、担当者が kintone で進めた状況を LINE に返せます。作るのは、受け口(自作のサーバーか連携サービス)と、kintone の顧客アプリ・問い合わせアプリの項目、API トークンと Webhook の設定です。つなぎ方より先に決めるのは、「何で同じ人とみなすか」です。ここが決まらないと、問い合わせのたびに台帳の行が増えます。

当社は LINE公式アカウントの運用を支援し、kintone のような業務システムと LINE をつなぐ連携も手がけています。連携の仕事では、LINE のユーザーIDを相手のシステムのどの項目に持ち、何で同じ人とみなすかを決める役になります。そのため、この記事もその照合キーを軸に書きます。読んでほしいのは、kintone を顧客台帳や案件管理に使っていて、LINE公式アカウントで受けた問い合わせを kintone に入れたい方です。料金の前提は、2026年10月1日に改定された LINE の追加メッセージ料金と、2026年10月末で経過措置の期間が終わった kintone の最小ユーザー数(10ユーザー)を踏まえた値で書いています。社内チャットの LINE WORKS と kintone をつなぐ話は扱いません。その話は「LINE Works × kintone連携ガイド」と「LINE WORKS と LINE の連携」にあります。Salesforce や HubSpot など、ほかの顧客管理とつなぐ作り方と費用の決まり方は「LINEと今の顧客管理をつなぐ3つの作り方と、費用が決まる所」にまとめています。

kintone の入口は REST API、出口は Webhook。LINE とは受け口を挟む

kintone の側で外とやり取りする公式の仕組みは2つです。外から kintone に書き込むのは REST API で、レコードの登録・更新・検索ができます。kintone で起きた操作を外に知らせるのは Webhook で、画面の操作でも REST API による操作でも、設定した URL へ JSON の通知を送ります(Webhookを設定する、Webhookを使ってみよう)。どちらも、ライトコースの契約では使えません(kintone 料金、APIトークンを生成する)。

LINE の側は、友だち追加やメッセージのたびに、LINE Developers コンソールの「Webhook URL」に指定した URL へ Webhook を送ります。受け口は署名を検証してから中身を処理し、ステータスコード200を返します(メッセージ(Webhook)を受信する、Messaging API リファレンス)。200番台を返さなかったときの再送は、既定では無効です。有効にしたときだけ送り直されますが、確実に再送されるとは限りません。再送では同じイベントが重なって届くことがあるので、イベントごとの webhookEventId で重複を見分けます(受け取りに失敗したWebhookを再送する)。受け口の作り方の細部は「LINE × Slack連携」に書いたので、この記事では kintone との間を扱います。

設定は、LINE Developers コンソールの[Messaging API設定]タブで[Webhook URL]に受け口の URL を入れ、[検証]で成功を確かめてから[Webhookの利用]を有効にします。ここに設定できる送信先は1つだけです(ボットを作成する)。配信ツールなどがすでにその URL を使っているチャネルなら、いまの送信先から受け口へ転送してもらうか、同じ受け口にまとめます。

同じ人を1行にする:照合キーを決める

LINE の Webhook で届くお客様の手がかりは、ユーザーIDです。U に16進数32字が続く値で、表示名や友だち検索に使う LINE ID とは別のものです(ユーザーIDを取得する)。表示名はプロフィールを取得する API で取れますが、会社名やメールアドレスは LINE からは届きません(プロフィール情報を取得する)。台帳に入れたい項目は、トークかフォームで聞きます。

ユーザーIDは、同じ人でもプロバイダーごとに別の値になります。同じプロバイダーの中なら、LINE ログインのチャネルでも Messaging API のチャネルでも同じ値です(同じページ)。連携サービスが別のプロバイダーのチャネルを使うと、そこで取れる ID は自社のチャネルの ID と一致しません。また、PC版の LINE だけを使っていてプロフィール情報の取得に同意できないユーザーの Webhook には、ユーザーIDが入りません(ユーザーのプロフィール情報取得の同意)。この人たちは、トークで聞いたメールアドレスなどで担当者が結びます。宛先のユーザーIDが無いので、この人たちへはプッシュで進み具合を返せません。

デモ「LINEの問い合わせが、CRMのリードになる」を試す手順

照合キーによる違いは、架空の会社・データで作った当社のデモで確かめられます。お客様の LINE の画面からお問い合わせフォームを送ると、CRM のリード一覧の画面が変わります。送る人を替えたときと「最初の状態に戻す」を押したときは、同意のチェックが外れます。

  1. 「送る人」で「田中 美咲」を選び、「お問い合わせ(フォームを開く)」から、同意のチェックを入れて「送信する」を押す。流入元「LINE」の行が1つ増えます。もう一度フォームを開いて送ると、行は増えず「問い合わせ(累計)」が2になります。
  2. 「送る人」を「鈴木 優」に替え、フォームを開いて同意のチェックを入れ直し、「送信する」を押す。照合のキーが「LINEのユーザーID(おすすめ)」のままだと、Webフォームで入っていた同じメールの行とは一致しません。別の行ができ、処理の流れに「△ 注意」が出ます。
  3. 「最初の状態に戻す」を押し、「送る人」が「鈴木 優」のまま、照合のキーを「メールアドレス」にする。フォームを開いて同意のチェックを入れ直し、送ると、既存の行に結びつきます。その行にユーザーIDが書き込まれます。

枠の中はスクロールできます。画面いっぱいで試すときは、別のタブで開いてください。

デモのリード一覧は一般的な CRM の画面で、kintone を再現したものではありません。kintone に置き換えて読むなら、リード一覧の1行が顧客アプリの1レコード、「照合のキー」が値の重複を禁止した項目、「問い合わせ(累計)」と活動履歴が問い合わせアプリの関連レコード一覧にあたります。ユーザーIDがプロバイダーごとに違うことは LINE の仕様で、同意の文言と照合のルールはデモの例です。デモは照合のキーを1つ選んで照合し、2段の照合はしません。同意の取り方は、自社のプライバシーポリシーに合わせて決めます。

照合キーによって、2回目と「初めての LINE」の扱いが変わる

例:田中さんが2回送る/Webフォームで先に入っていた鈴木さんが、初めて LINE から送る

LINE のユーザーID

Webhook で届く値(同意している人)

  • 同じ人の2回目以降は、同じ行に積み上がる
  • 打ち間違いが起きない
  • Webフォームなどで先に入っていた顧客は、IDが未登録なので一致しない

kintone:文字列(1行)で値の重複を禁止すれば、UPSERT のキーにできる

メールアドレス

フォームやトークで聞く値

  • Webフォーム・展示会で入った既存の行に結べる
  • 一致したら、その行にユーザーIDを書き込める
  • 違うメールや打ち間違いでは別の行になる

kintone:UPSERT のキーにできるのは、重複を禁止した文字列(1行)か数値の項目だけ

照合しない

毎回新しい行

  • 問い合わせのたびに行が増える
  • 顧客台帳ではなく、受付の記録になる

使う場所:1件1行の問い合わせアプリ

デモの動きと、cybozu developer network「複数のレコードを更新する」、LINE Developers「ユーザーIDを取得する」から

ユーザーIDとメールアドレスは、どちらかを選ぶより、順番に使うほうが台帳が割れません。打ち間違いの無いユーザーIDを1段目に、IDが未登録の既存の顧客を拾うメールアドレスを2段目に置きます。

問い合わせが届いたときの照合の順番

1

ユーザーIDで探す

  • 顧客アプリの「LINEユーザーID」と一致すれば、その行を更新する

2

無ければメールで探す

  • フォームで聞いたメールと一致すれば、その行にユーザーIDを書き込む

3

どちらも無ければ追加

  • 流入元を LINE にして、ユーザーIDとメールを入れた行を作る

4

問い合わせを起票

  • 問い合わせアプリに1件1行。顧客と同じユーザーIDを入れる

デモの注意に出る「メール併用の照合」を、ユーザーID→メールの2段にして kintone の2つのアプリに当てはめた当社の設計案(デモ自体は1つのキーで照合する)。API の仕様は「複数のレコードを更新する」と kintone ヘルプ「関連レコード一覧とは」による

kintone では、顧客アプリに「LINEユーザーID」を文字列(1行)で置き、[値の重複を禁止する]にチェックを入れます。重複を禁止した項目は64文字までになりますが、ユーザーIDは33文字なので収まります(文字列(1行))。この項目をキーにすると、「複数のレコードを更新する」API の UPSERT モード(upsert に true)で、updateKey に指定した値のレコードがあれば更新、なければ新しく登録できます。updateKey にできるのは、重複を禁止した文字列(1行)か数値の項目だけです。一度に更新できるのは100件までです。失敗すると、そのリクエストの更新はすべて取り消されます。編集権限に加えて、追加権限も要ります。「1件のレコードを更新する」API には UPSERT のパラメーターがありません(複数のレコードを更新する、1件のレコードを更新する)。

注意が1つあります。UPSERT は複数のレコードを一括操作する REST API なので、kintone の Webhook の通知が送られません(Webhookを設定する)。顧客アプリにレコードが追加されたことをきっかけに何かを動かすなら、UPSERT ではなく、検索してから1件ずつ登録・更新します。2段目のメールの照合も、メールを入れている項目が重複禁止の文字列(1行)でなければ updateKey にできないので、検索して見つけたレコードIDで更新します。

問い合わせの中身は顧客アプリには入れず、問い合わせアプリに1件1行で入れます。顧客アプリに関連レコード一覧を置き、LINE ユーザーIDで問い合わせアプリと結びつけると、顧客の画面にその人の問い合わせが一覧で出ます(関連レコード一覧とは)。自社サイトの会員番号と LINE のユーザーIDを、お客様のログインで結ぶなら、Messaging API のアカウント連携で作れます。連携トークンは10分間有効で、1回しか使えません(ユーザーアカウントの連携)。Salesforce を台帳にする場合の照合キーと名寄せは「LINEログインと Salesforce 会員ID連携とオフライン属性の名寄せ設計」に、問い合わせをリードにする流れは「LINEで受けた問い合わせを Salesforce のリードにする」にあります。

つなぎ方は、矢印と照合を誰が受け持つかで選ぶ

つなぎ方は、連携サービス・プラグイン、iPaaS(Zapier・Power Automate など)、自作の受け口の3つです。どれを選んでも、上の図の4本の矢印と照合の順番は同じです。違うのは、どの矢印と照合を誰が受け持ち、誰が保守するかです。

3つのつなぎ方を、誰が受け持ち、誰が保守するかで比べる

どれでも、LINE の Webhook URL は1つ。どれが受けるかを先に決める。

連携サービス・プラグイン

サイボウズの連携サービス一覧などにある製品

  • 保守:提供会社
  • 価格:各社の公開ページか見積り
  • 照合キーと起票先の項目を自社で決められるかは、製品ごとに違う

先に確かめる:4本のどれを受け持つか。LINE のチャネルとプロバイダーは自社のものか

iPaaS(Zapier・Power Automate など)

ノーコードのフロー

  • 保守:自社でフローを管理
  • kintone → 外部は、Webhook の送信先に指定できる
  • 外部 → kintone は、各ツールの kintone 用の部品か REST API を使う

分かれ目:LINE の署名を検証できるか。webhookEventId で重複を除けるか。2段の照合を分岐で組めるか

自作(受け口+REST API)

サーバーレス・自社サーバー

  • 保守:自社
  • 照合の順番も、項目の持ち方も自分で決める
  • kintone の同時実行100は自分で守り、Webhook の1分60回は前提に組む

向く場面:ユーザーID→メールの2段の照合や、既存の顧客アプリの項目に細かく合わせたいとき

出典:kintone ヘルプ「Webhookを設定する」、サイボウズ「プラグイン・連携サービス」、LINE Developers「ボットを作成する」

サイボウズの連携サービス一覧に載っている LINE 連携

サイボウズは、kintone と組み合わせて使う製品を「プラグイン・連携サービス」の一覧で紹介しています。載っている製品の多くはサイボウズとは別の会社のもので、契約や問い合わせもそれぞれの提供会社とのあいだになります。この一覧で「LINE」を含む製品は15件で、15件ともサイボウズとは別の会社の製品です。そのうち12件は、社内チャットの LINE WORKS との連携でした。LINE WORKS ではない LINE との連携に触れていたのは3件です。1件は、LINE公式アカウントでの配信と、LINE で取った回答の kintone への連携を主な機能に挙げていました。残りの2件は、オプションの1つとして LINE との連携(「LINE連携」「FAX・SMS・LINE・郵送連携」)を挙げていました。

サイボウズの連携サービス一覧で「LINE」を含む製品(15件)の内訳

一覧の全438件のうち

LINE WORKS との連携12件
LINE WORKS ではない LINE との連携に触れている3件

出典:サイボウズ「プラグイン・連携サービス」(当社が数えた)

LINE公式アカウントとの連携を主な機能にしている製品は一覧の中で1件なので、連携サービスで足りるかは件数では決まりません。候補の製品の掲載ページで、「特徴」と「利用シーン」に LINE公式アカウントとの連携が主な機能として書かれているか、「価格」やオプションの1つとして挙がっているだけかを見て、見当をつけます。一覧のページに書かれていない連携先に、提供会社のページで対応している製品もあります。どの製品も、4本の矢印のどれを受け持つか、照合キーをどこに持つか、LINE のチャネルが自社のプロバイダーのものかを、提供会社に確かめてから選びます。

ノーコードで組める範囲

kintone から外への向きは、Webhook の送信先に Zapier・Microsoft Power Automate・IFTTT などを指定すれば、ノーコードで組めます(kintone ヘルプ「Webhookを設定する」の例)。反対の、LINE から kintone に起票する向きには、署名の検証と重複の除去、照合の分岐が要ります。これをノーコードのツールで作れるかは、ツールごとに違います。作れないときは、署名の検証と保存だけを受け口に任せ、その後ろをノーコードのフローに渡します。

無料で試せる範囲と、本番の前提

無料で試せる範囲と、本番で変わること
項目無料で使える範囲本番で変わること
kintone30日間のお試し(スタンダードコース、ユーザー数の制限なし)。開発者ライセンスは12か月無料で、スタンダードコースとほぼ同等、ユーザー5人、本番の運用には使わないライトコース(月額1,000円/1ユーザー)は Webhook と API トークンが使えない。スタンダードコースは月額1,800円/1ユーザーで、最小10ユーザー、月額18,000円から(いずれも税抜)
LINEコミュニケーションプランは月額0円、無料メッセージは月200通。応答メッセージは通数に数えないプッシュとマルチキャストは通数に数える。無料分を超えて送れるのはスタンダードプラン(月額15,000円、無料30,000通)だけで、追加メッセージは月20万通までは1通3円、超えた分は1通2.5円(いずれも税別)
受け口置き場所(サーバーレス・自社サーバー)の料金は、それぞれの提供元の料金—

kintone の料金ページでは、外部サービス連携やプラグインはスタンダードコース以上の機能です。1アプリ1日の API リクエスト数は、スタンダードコースで1万回、ワイドコース(月額3,000円/1ユーザー、最小1,000ユーザー、税抜)で10万回です。開発者ライセンスは API の動作確認をする場所で、問い合わせを受ける本番の環境ではありません。

最小ユーザー数は、2024年10月以降の新しい契約とユーザー数・コースの変更から10になりました。2024年9月末の時点で10ユーザー未満だった月額契約には、ユーザー数やコースを変えなければ、2026年10月末まで契約した人数の料金で使える経過措置がありました。サイボウズの案内では、2026年11月(11月1日請求)以降の料金は、改定後の最小契約ユーザー数(10ユーザー)に自動で切り替わるとされています。10ユーザー未満で使っていた会社は、11月以降の請求が10ユーザー分になっているかを確かめてください。契約ユーザー数を10ユーザー未満へ減らすことはできません。ライトコースからスタンダードコースに上げるときも、その時点で10ユーザー以上が要ります。LINE 側は、2026年10月1日に追加メッセージの料金が改定されています。

この節の出典:kintone 料金、kintone 開発者ライセンス、サイボウズ「クラウドサービスの価格改定に関するご案内」、LINE公式アカウントの料金プラン、LINEヤフー for Business のお知らせ(2026年10月1日)

2つのアプリの項目:どこに何を入れ、誰が書くか

顧客アプリは1人1行、問い合わせアプリは1件1行です。問い合わせアプリの項目は、誰が書くかで3つに分けておきます。受け口が起票のときに書くもの(受付イベントID・ユーザーID・本文など)、担当者が書くもの(ステータス・作業者・対応メモ)、受け口が通知のあとに書き戻すもの(通知済みのステータス)です。こうしておくと、あとで「誰が書き換えたか」で迷いません。受付番号は、kintone のレコード番号をそのまま使えます。

2つのアプリの項目と、入れる値(重複禁止の設定は kintone ヘルプ「文字列(1行)」による)
項目型入れる値注意
顧客アプリ:LINE ユーザーID文字列(1行)・値の重複を禁止Webhook の source の userId(33文字)照合の1段目。UPSERT のキー
顧客アプリ:メールアドレス文字列(1行)などフォームやトークで聞いた値照合の2段目。一致したらユーザーIDを書き込む
顧客アプリ:流入元ドロップダウンLINE・Webフォーム・展示会などどこで最初に台帳に入ったか
顧客アプリ:LINE で連絡できるかドロップダウンフォロー/フォロー解除のイベントブロック中はプッシュが届かず、通数にも数えない
問い合わせ:受付イベントID文字列(1行)・値の重複を禁止Webhook の webhookEventId同じ値は2つのレコードに入らない。64文字まで
問い合わせ:LINE ユーザーID文字列(1行)顧客アプリと同じ値1人が何度も問い合わせるので、重複は許す。関連レコード一覧で顧客と結びつけるのに使う
問い合わせ:本文・メッセージID文字列(複数行)・文字列(1行)message.text と message.idテキストは受けた時点で保存する。メッセージIDは送信取消のときに使う
問い合わせ:受信日時日時イベントの timestamp再送で順番が前後しても、この値で前後を確かめられる
問い合わせ:ステータス・作業者プロセス管理担当者がアクションで進めるAPI でレコードを登録するとき、ステータスと作業者には値を入れられない
問い合わせ:通知済みのステータス文字列(1行)最後に LINE へ返したステータス名Webhook の取りこぼしを拾う目印

API でレコードを登録するときは、存在しないフィールドコードを指定しても、そのフィールドが無視されるだけでレコードは登録されます(1件のレコードを登録する)。打ち間違えてもエラーにならないので、登録したレコードを取り直して値を確かめる処理を、最初のテストに入れておきます。

画像は、受けたその場で kintone に入れる

LINE で受けた画像・動画・音声・ファイルは、メッセージIDを使って取得できます。ただし、送信から一定期間後に自動で削除され、保存期間は保証されません(コンテンツを取得する)。kintone に入れるときは、ファイルをアップロードする API で一時保管領域に置き、返ってきたファイルキーを、レコードの登録のときに添付ファイルフィールドの値にします。アップロードしたファイルは、レコードに添付しないと3日間で削除されます(ファイルをアップロードする、制限値一覧)。取得とアップロードと登録は、続けて行います。

1人が続けて送ったら、新しいレコードか、コメントか

メッセージのたびにレコードを作ると、1つの相談が何件にも割れます。そのお客様の未完了の問い合わせがあれば、既存のレコードにコメントで追記します。無いときだけ新しく起票すれば、1つの相談が1件にまとまります。コメントは、レコードにコメントを投稿する API で入れられます。最大65,535文字で、閲覧権限が要ります(レコードにコメントを投稿する)。重複禁止はレコードの項目に付ける設定で、コメントには使えません。そのため、コメントの二重投稿は、受け口の保存側で webhookEventId の処理済みを記録して防ぎます。未完了かどうかは、ステータスで見分けます。

お客様が送信を取り消したら

LINE では、お客様が送ったメッセージを、一定期間内なら取り消せます。取り消すと、受け口に送信取消イベントが届きます。LINE は、取り消されたメッセージを以降は見たり使ったりできないよう扱うことを勧めています(送信取消イベント受信時の処理)。kintone に写した本文やコメントからも該当のメッセージを消すか伏せられるよう、本文と一緒にメッセージIDを持っておきます。

kintone から LINE に返す・配る

進み具合を返す仕組みは、kintone の Webhook です。アプリの設定の[Webhook]で、送信先の URL と[通知を送信する条件]を設定し、[アプリを更新]で反映します。条件は、レコードの追加・編集・削除、コメントの書き込み、ステータスの更新から選びます。URL は、先頭の「https://」を除いて入れます(最大1,024文字)。1つのアプリに設定できる Webhook は10個までです。cybozu.com 共通管理者が Webhook の利用を禁止していると、[Webhook]のメニューが出ません(Webhookを設定する、Webhookを利用できないようにする)。

条件は「ステータスの更新」だけにします。受け口が REST API でレコードを追加したり、通知済みの項目を書き戻したりしたときも、条件に「レコードの追加」「レコードの編集」が入っていると、受け口に通知が戻ってきてループになるためです。

ステータスを変えたときの通知は type が UPDATE_STATUS で、レコードの内容(record)、アプリのID(app.id)、通知ごとの固有のIDなどが入っています(kintoneの操作で送信されるWebhookの通知内容)。公式の一覧に、署名にあたる項目はありません。偽の通知でお客様に誤った進み具合を送らないよう、受け口は通知の record を使いません。app.id とレコードのIDだけを受け取り、REST API でレコードを取り直して、現在のステータスを確かめてから送ります。送信先の URL に推測されにくい文字列を含めておくのも有効です。

ステータスを、お客様に送る文面に変える

kintone のステータス名は社内の言葉です。そのまま LINE に送らず、受け口で「ステータス名 → お客様向けの文面」の対応表を持ち、表に無いステータスは送りません。社内の差し戻しや保留を、お客様に届けないためです。コメントの書き込み(ADD_RECORD_COMMENT)も、社内のやり取りが混ざるので自動では転送しません。

ステータスと LINE の文面の対応(ステータス名と文面は当社の例)
ステータス(例)LINE に返す内容(例)送る手段
未対応(起票した直後)受け付けたことと、受付番号応答メッセージ。応答トークンは Webhook を受けてから1分以内に使う。過ぎたらプッシュ
対応中担当が決まり、確認を始めたことプッシュメッセージ
完了結果、または次の案内プッシュメッセージ
社内確認・保留など送らない—

返す手段で、通数が変わります。応答メッセージは通数に数えず、プッシュは数えます(Messaging APIの料金)。応答トークンは一度しか使えず、Webhook を受けてから1分以内に使う必要があります(応答トークン)。上の表どおりなら、通数に数えるのは1件の問い合わせで「対応中」「完了」の2通で、コミュニケーションプランの月200通は100件分です(200 ÷ 2 = 100)。応答トークンの1分を過ぎて受付の返信もプッシュになると3通で、66件分に減ります(200 ÷ 3 ≒ 66)。コミュニケーションプランでは無料分を超えて送れないので、通知の回数は問い合わせの数から逆算して決めます。

顧客アプリで絞り込んだお客様にお知らせを配るときは、ユーザーIDの一覧をマルチキャストで送ります。1回に指定できるユーザーIDは500までです。ブロック中の人や、別のプロバイダーで取ったIDなどチャネルに存在しないIDには、ステータスコード200が返っても届きません(マルチキャストメッセージを送る)。届かない宛先は、通数に数えません(料金のページ)。それでも、顧客アプリの「LINE で連絡できるか」をフォロー/フォロー解除のイベントで更新しておけば、配る前に宛先を絞れます。トーク画面を開くだけで進み具合が分かるようにするなら、デフォルトより優先して表示され、即時に切り替わるユーザー単位のリッチメニューも使えます(ユーザー単位のリッチメニューを使う)。

kintone の Webhook は、取りこぼす前提で組む

kintone の Webhook は、ドメイン単位で1分間に60回までしか送られず、61回目以降の操作では通知が送られません。Excel や CSV の読み込み、複数のレコードの一括削除、複数のレコードを一括操作する REST API で操作した場合も、通知は送られません(Webhookを設定する)。通知に失敗する原因として、ほかに、通知のデータが1MBを超えた、kintone のタイムアウト、受け口の停止やタイムアウトが挙がっています。実行ログで見られるのは、Webhook の設定ごとに直近10件までです(Webhookの実行ログを確認する)。

そこで、LINE に返したあとにレコードの「通知済みのステータス」を更新しておき、定期的に、現在のステータスと食い違うレコードを探して送り直します。二重送信を防ぐには、プッシュメッセージを最初に送るときから、X-Line-Retry-Key ヘッダーに16進表記の UUID を付けます。キーは自分で作り、最初のリクエストから24時間有効です。同じキー・同じ内容で送り直すと、すでに受理されていれば409が返り、重複して送られません。最初の送信にキーが無ければ、送り直しは普通の2回目の送信になります。使えるのはプッシュ・マルチキャスト・ナローキャスト・ブロードキャストで、応答メッセージに付けると400が返ります(失敗したAPIリクエストを再試行する)。たとえば、問い合わせのレコードIDとステータス名から、決まった手順で UUID を作ります。こうすると、LINE に送れたのに通知済みの書き戻しに失敗したレコードを拾い直しても、24時間以内なら同じキーで送ることになり、二重には届きません。24時間を過ぎたものはキーで重複を止められないので、送り直さずに担当者が LINE のトークを見て確かめる扱いにします。kintone の Webhook が来なかったレコードは、まだ送っていないので、普通に送ります。

通知の取りこぼしを、拾い直す

どちらの流れも、送れたら最後に通知済みの印を更新する。

通常

kintone の Webhook

  • ステータスが変わると、受け口に通知が届く
  • 受け口がレコードを取り直し、リトライキーを付けて LINE にプッシュを送る
  • 送れたら、通知済みのステータスを更新する

件数の上限:ドメインで1分60回

拾い直し

受け口の定期ジョブ

  • 現在のステータスと通知済みを比べる
  • 食い違うレコードにプッシュで送る。送信済みかもしれないものは、24時間以内なら最初と同じキー・同じ内容で送る。過ぎたら担当者が確かめる
  • 送れたら、通知済みを更新する

取りこぼす場面:1分60回の超過、一括操作、受け口の停止

出典:kintone ヘルプ「Webhookを設定する」・「Webhookの実行ログを確認する」、LINE Developers「失敗したAPIリクエストを再試行する」

うまく動かないとき:台帳が2行、通知が来ない、エラーで落ちる

症状ごとに、見る場所と直し方

例の続き:鈴木さんが2行になったら、照合の2段目を疑う。

同じ人が2行・同じ問い合わせが2件

照合と起票の側

  • 顧客アプリのユーザーIDの項目が、重複禁止になっているか
  • Webフォームで先に入っていた顧客を、メールで探しているか
  • 受付イベントIDが重複禁止になっているか

直し方:照合を2段にする。同じ webhookEventId の2度目は登録できない。断られたら読み取り用のトークンで検索し、あれば処理済みとして扱う

通知が LINE に届かない

進み具合の側

  • Webhook の実行ログ(直近10件)に成功・失敗が出ているか
  • 1分60回を超えていないか、一括操作ではなかったか
  • そのお客様がブロックしていないか

直し方:通知済みのステータスで拾い直す。ブロック中は別の手段で連絡する

API がエラーで落ちる

REST API

  • 同時実行が1ドメイン100を超えて、429が返っていないか
  • 1日の上限を超えていないか
  • 認証(トークンの権限・IP アドレス制限)で断られていないか

直し方:受け口が同時に送る数を絞り、429のときは待って、保存したイベントからやり直す

出典:kintone ヘルプ「制限値一覧」・「Webhookの実行ログを確認する」・「文字列(1行)」、cybozu developer network「kintoneの性能Vol.2」

同時実行は、ドメイン全体で100

kintone の REST API の同時実行は、1つのドメインにつき100までで、上限を超えると HTTP ステータスコード429が返ります(制限値一覧)。上限を超えると、原因になったアプリだけでなく、ドメイン全体で REST API のリクエストがエラーになります。性能の目安の「同時リクエスト数」には画面の操作も含まれるので、人が多く使う時間帯は REST API も遅くなります(kintoneの性能Vol.2)。お知らせを一斉に送ったあとに返信が集中しても、社内のほかの業務アプリが巻き込まれないよう、受け口が kintone に出す数は小さく絞ります。

一度に登録できるレコードは100件までで、処理に失敗すると、そのリクエストの登録はすべて取り消されます(複数のレコードを登録する)。受付イベントIDを重複禁止にしていると、すでに登録済みの1件が混ざっただけで、100件の登録全体が取り消されます。問い合わせの起票は1件ずつにするか、重複を先に除いてからまとめます。

1日の上限は、超えてもエラーにはならない

1日に実行できる API リクエスト数は、契約するコースで決まり、アプリごとに数えます(スタンダードコースは1アプリ1日1万回、ワイドコースは10万回)。数えるのは、リクエストで1つのアプリIDを指定する API で、複数の API をまとめて実行する bulkRequest では、実行した API の数だけ数えます。リセットは日本時間の毎日午前9時です(制限値一覧、料金)。上限を超えても、リクエストの実行はエラーになりません。翌日の午前9時ごろに、サイボウズドットコム ストアの管理者宛てに警告メールが届きます(kintoneの性能Vol.2)。

問い合わせアプリで数えてみます。上の表どおり、kintone の Webhook を通る通知が「対応中」「完了」の2回なら、1件の問い合わせで使うのは5回です。内訳は、起票が1回と、通知ごとに取り直し1回・通知済みの更新1回です。1万回は2,000件分です(1 + (1 + 1) × 2 = 5、10,000 ÷ 5 = 2,000)。顧客アプリへの照合と UPSERT は顧客アプリの側で数え、重複の検索や拾い直しの取得はこの5回に入っていません。

kintone 側の権限:連携用のトークンを、用途ごとに分ける

受け口が kintone に入るときの鍵は、API トークンが基本です。アプリごとに生成し、1つのアプリにつき20個まで作れます。生成したトークンには許可する操作を選び、ここで設定したアクセス権は、アプリ・レコード・フィールドのアクセス権の設定に関わらず優先されます。トークンを使った操作は Administrator による操作として扱われます。

トークンの権限がそのままアプリ全体への権限になるので、用途ごとに分けます。登録には追加権限が、更新には編集権限が、コメントの投稿には閲覧権限が要り、UPSERT は編集と追加の両方が要ります(各 API の「必要なアクセス権」)。この記事の設計では、次の4つになります。

トークンを用途で分ける(許可する操作の分け方は当社の案)
トークン許可する操作使う場面漏れたときに起きうること
顧客アプリ:台帳用レコードの閲覧・追加・編集ユーザーIDとメールでの照合、UPSERT、ユーザーIDの書き込み、連絡できるかの更新顧客の台帳が読め、書き換えられる。いちばん重い
問い合わせ:起票用レコードの追加問い合わせの起票偽の問い合わせが入る。既存のレコードは読めない
問い合わせ:読み取り用レコードの閲覧重複の検索、未完了の検索、コメントの投稿、通知後の取り直し問い合わせアプリのレコードがすべて読める
問い合わせ:書き戻し用レコードの編集通知済みのステータスの更新既存のレコードを書き換えられる

分けても「漏れても読めない」にはなりません。読める鍵と書ける鍵を、使う処理ごとに絞れるだけです。台帳用は照合の処理だけが持つようにし、LINE のチャネルシークレットとチャネルアクセストークンも受け口の中だけに置きます。問い合わせアプリの重複の確認を「起票を断られたら処理済みとして扱う」だけにすれば、起票用のトークンだけでも動きます。ただ、断られた理由が重複とは限らないので、検索で確かめる形をお勧めします。問い合わせアプリから顧客アプリをルックアップで参照して登録するときは、両方のアプリのトークンを指定します(1回に9個まで)。

ユーザーの権限で動かすなら、連携用のユーザーでパスワード認証にします。2要素認証を有効にしたユーザーでは実行できないので、2要素認証を無効にした連携用ユーザーを用意します。IP アドレス制限があるときは、受け口の IP アドレスを許可するか、Basic 認証・クライアント証明書で実行します。

Webhook の実行ログは設定ごとに直近10件までなので、それより古い通知は、cybozu.com 共通管理者が監査ログで確認します。受け口の側にもイベントのIDと処理の結果を残しておくと、「返事が来ない」と言われたときに、どこで止まったかをたどれます。

誰が、どの画面で、何を設定するか

1人が複数を受け持つことも多いが、画面ごとに権限が違う。

LINE の管理者LINE Developers コンソール
[Messaging API設定]タブ[Webhook URL]に受け口を入れ、[検証]で成功を確かめてから[Webhookの利用]を有効にする。再送を使うかは受け口の設計とそろえる
チャネルの鍵チャネルシークレットとチャネルアクセストークンは、受け口にだけ置く
cybozu.com 共通管理者cybozu.com 共通管理
Webhook の送信Webhook の利用を禁止していないか(禁止すると、アプリで設定できない)
IP アドレス制限制限があるときは、受け口の IP アドレスを許可する
連携用ユーザーパスワード認証にするなら、2要素認証を無効にしたユーザーを用意する
kintone のアプリ管理者アプリの設定
フォーム顧客アプリのユーザーIDと、問い合わせアプリの受付イベントIDを、重複を禁止した文字列(1行)にする
プロセス管理ステータスとアクション(社内の言葉でよい)
APIトークン台帳用・起票用・読み取り用・書き戻し用を生成する。組織間のアクセス権を有効にしていると、生成と確認は kintone システム管理権限を持つ人だけ
Webhook問い合わせアプリで、条件は「ステータスの更新」だけ。URL を入れ、アプリを更新する。組織間のアクセスを禁止していると、設定には kintone システム管理権限が要る
受け口の開発側受け口(サーバー)
LINE → kintone署名の検証、保存、200、重複の除去、照合、起票
kintone → LINEレコードを取り直して確認、ステータスを文面に変換、リトライキーを付けてプッシュ
拾い直し通知済みと現在のステータスを比べて送り直す
担当者kintone のレコード画面
アクションボタンステータスを進める。お客様に通知が行くことを前提に操作する
対応メモ社内向け。LINE には送られない

画面名は LINE Developers・kintone ヘルプ・cybozu developer network の表記に合わせた。出典はこの節の末尾

この節の出典:kintone ヘルプ「APIトークンを生成する」、cybozu developer network「kintone REST APIの認証」、「1件のレコードを登録する」・「1件のレコードを更新する」・「レコードにコメントを投稿する」・「複数のレコードを更新する」、kintone ヘルプ「Webhookの実行ログを確認する」、LINE Developers「ボットを作成する」、kintone ヘルプ「Webhookを設定する」、kintone ヘルプ「Webhookを利用できないようにする」

照合キーを決めてから、つなぎ方を選ぶ

最初に決めるのは、顧客アプリの照合キーです。LINE のユーザーIDは同じプロバイダーの中で変わらず、UPSERT のキーにもなります。一方、先に台帳にいた顧客はメールアドレスでしか拾えません。そのため、ユーザーIDを1段目、メールアドレスを2段目にする形をお勧めします。そのうえで、照合と4本の矢印を連携サービスに任せるか、自社で受け口を持つかを決めます。

kintone の顧客台帳と LINE のつなぎ方、照合キーと項目の設計は、LINE運用・伴走支援のページから相談できます。kintone のアプリの開発は、業務ツール開発のページも見てください。

仕様と料金は、2026年10月13日に kintone ヘルプ、cybozu developer network、kintone の料金ページ、サイボウズの価格改定の案内、LINE Developers、LINEヤフー for Business で確かめたものです。連携サービスの数は、同じ日にサイボウズの「プラグイン・連携サービス」の一覧が読み込むデータ(438件)を取り、製品名・説明・特徴・利用シーン・価格の欄に「LINE」を含む15件を当社が数えた結果です。LINE WORKS 以外の3件は、製品ページも開いて確かめました。

kintone 導入支援

何から作ればいいか分からない、標準機能では業務にはまらない、Salesforce や Excel・会計ソフトと二重管理になっている。kintone のアプリの全体設計から、プラグイン・API での連携、社内で作れる状態までを支援します。

AT
aurant technologies 編集

上場企業からスタートアップまで、数多くのデータ分析基盤構築・AI導入プロジェクトを主導。単なる技術提供にとどまらず、MA/CRM(Salesforce, Hubspot, kintone, LINE)導入によるマーケティング最適化やバックオフィス業務の自動化など、常に「事業数値(売上・利益)」に直結する改善実績多数。

この記事が役に立ったらシェア: