マルケトとChatWork（チャットワーク）の連携方法（メッセージ投稿、タスクの追加）
- December 7, 2020
- 1 reply
- 150 views
始めまして。㈱プロテラスの中村と申します🤗
当社では2020年9月からマルケトをはじめまして、営業部からマーケティングに異動しマルケト担当となりました。
元々プログラミング等が出来るわけではないため💦皆さんのナレッジを参考にしながら手探りでやっております。
マルケト内でスコアリングが一定以上になったリードを営業にパスするために、
社内ネットワークとして使用しているチャットワークと連携した際の内容を共有します。
内容的には難しくない物だと思いますが、調べても見つからなかったので👍
①ChatWork（チャットワーク）側の設定確認
必要な要素は以下の3つです。確認方法も併せて書いておきます。
・ユーザーaid（数字列）
登録したいユーザーの投稿を「引用」した際に表示される「aid=」に続く7桁の数字です。
・グループチャットのURL末尾数字
「chatwork.com/#!rid」に続く9桁の数字です。
・API Token
一番右上の自分の名前からメニューを開き「サービス連携」「API Token」と進んでパスワードを入力すると表示されます。
この3つをメモしておきます。
②マルケト側の設定（新規メッセージの投稿）
チャットワーク側が記載してくれているAPIドキュメント一覧にならって設定していきます。
https://developer.chatwork.com/ja/endpoint_rooms.html#POST-rooms-room_id-messages
１：「管理」から「ウェブフック」を選択します。
２：「新規ウェブフック」を選択し、以下の内容を入力します。
ウェブフック名：見分けがつきやすい名前を付けましょう
詳細：メモとして使用してください
URL：https://api.chatwork.com/v2/rooms/{room_id}/messages
{room_id}の箇所に①の9桁の数字を代入してください
リクエストタイプ：POST
テンプレート：body={本文}&self_unread=0
{本文}の中はトークンを使えるので、当社では以下のような感じにしています。
body=スコアが○○点を超えました。アタックをお願いします。
会社名：{{company.Company Name:default=}}
所在地：{{lead.State:default=}}{{lead.City:default=}}{{lead.Address:default=}}
部署名・役職：{{lead.Department:default=}}
氏名：{{lead.Last Name:default=}}{{lead.First Name:default=}} 様
電話：{{company.Main Phone:default=記載なし}}
メール：{{lead.Email Address:default=}}
&self_unread=1
self_unread=を1にすると未読状態で投稿できます。私も確認したいので1にして気づきやすいようにしています。
リクエストトークンのエンコード：POST
応答タイプ：JSON
３：２で新規作成したウェブフックを選択し、「ウェブフックアクション」「カスタムヘッダの設定」を選択します。
ヘッダ：X-ChatWorkToken
値：①で確認した「API Token」
をそれぞれ入力し保存します。
ウェブフックごとに設定する必要があり、一つだけ違う画面に存在しているので見落としやすいです⚠️
③新規タスクの追加
同様に新規タスク追加のウェブフックを作成します。違う部分だけ記載します。
https://developer.chatwork.com/ja/endpoint_rooms.html#POST-rooms-room_id-tasks
２：「新規ウェブフック」を選択し、以下の内容を入力します。
URL：https://api.chatwork.com/v2/rooms/{room_id}/tasks
{room_id}の箇所に①の9桁の数字を代入してください
テンプレート：body={本文}&limit_type=none&to_ids={ユーザーaid}
末尾の{ユーザーaid}に対してタスクが作成されます。これを「,」で区切って複数入力すると、タスクが複数個作成されます。
{本文}はこんな感じにしています。
body=スコアが○○点を超えました。アタックをお願いします。
会社名：{{company.Company Name:default=}}
所在地：{{lead.State:default=}}{{lead.City:default=}}{{lead.Address:default=}}
部署名・役職：{{lead.Department:default=}}
氏名：{{lead.Last Name:default=}}{{lead.First Name:default=}} 様
電話：{{company.Main Phone:default=記載なし}}
携帯電話：{{lead.Mobile Phone Number:default=記載なし}}
メール：{{lead.Email Address:default=記載なし}}
&limit_type=none&to_ids=1234567
&limit_type=noneでタスクの期日を空白にできます。
④ウェブフックの仕込み
新規スマートキャンペーンを作成し、トリガーに「スコア変更」「指定の値より大きい：○○」でスマートリスト設定、
フローに「ウェブフックを呼び出し」を追加して、先ほどの２つを設定します。
頻度は現状「1回のみ」で設定しています。
⑤適当な新規リードを作成してテスト送信してみる
テストと分かる名前・内容できちんと作動するか確認しましょう。
チャットワーク以外でもAPI連携できるチャットツールは大まかに同じ動きになると思います。
ウェブフックでの連携はかなり拡張性が高そうなので、面白い使い方があったら教えて頂けると助かります。
以上、新参者からでした👐