お問い合わせの受信通知をChatworkで送信する
概要
Kurocoは自由にAPIを作成でき、さらに外部のAPIにリクエストを送るプラグインを持っているため、外部システム連携に表示されていないサービスについても、カスタム処理やバッチ処理に動作を記述することで利用が可能です。
本チュートリアルはその例として、ChatWorkに投稿をするカスタム処理を自作し、お問い合わせの受信通知をChatworkへ投稿する方法について説明します。
学べること
以下の手順でお問い合わせの受信通知をChatworkへ投稿します。
Chatworkの設定
ボット用のアカウントを作成する
Chatwork APIを利用した投稿の投稿者は、APIトークンを作成したアカウントになります。 そのため、まずはChatworkで、通知の送信元となるボット用のアカウントを作成してください。
アカウントができたら、プロフィールから写真と名前を設定しておきます。
通知が送付されるグループを作成する
つぎに、通知を受け取るためのグループチャットを作成します。
準備ができたらグループチャットの設定からルームIDを控えておきます。
APIトークンを取得する
Chatwork APIへようこそ！にアクセスし、画面下部の[APIの利用申請]をクリックします。
ボット用のアカウントでログインすると、APIトークンのページに遷移し、APIトークンの確認ができます。
Kurocoの設定
APIトークンを保存する
Kurocoの管理画面にアクセスし、[環境設定] -> [シークレット]をクリックします。
[追加]をクリックします。
以下のように入力して、[追加する]をクリックします。
| 項目 | 値 |
|---|---|
| 名前 | CHATWORK_API_TOKEN |
| 値 | Chatworkで取得したAPIトークン |
Chatworkに投稿をするカスタム処理を作成する
カスタム処理を利用して、Chatworkに投稿をする処理を自作します。
[オペレーション] -> [カスタム処理]をクリックします。
[追加]をクリックします。
以下のように設定します。
- カスタム処理は
{function}のSmartyプラグインを利用して他のカスタム処理やバッチ処理から呼び出されることを前提としています。 - 通知送信先のroom_idと、送信する本文を、
room_idとtextの変数で受け取ります。 {return value=$status}で処理の結果を返します。
| 項目 | 値 |
|---|---|
| タイトル | chatwork_post_message |
| 識別子 | chatwork_post_message |
| 処理 | 以下の内容 |
loading...
入力ができたら[追加する]をクリックしてカスタム処理を追加します。
メッセージひな形を調整する
[オペレーション]->[メッセージひな形]をクリックします。
[問い合わせ着信通知メール(管理者宛)]をクリックします。
本文の冒頭に以下の記述を追加します。
{*Chatwork通知*}
{capture name=chatwork_text_body}
[toall]
「{$inquiryHeader.inquiry_name}」へのお問い合わせが届きました。
内容を確認してください
{$smarty.const.ROOT_MNG_URL}/management/inquiry/inquiry_reply_edit/?inquiry_bn_id={$inquiry_bn_id}
{/capture}
{function name='chatwork_post_message' room_id="123456789" text=$smarty.capture.chatwork_text_body var=status}
{*メール通知*}
room_idはご自身の環境のIDを利用してください。
設定ができたら[更新する]をクリックして変更を反映します。
TIPS
- メール通知を止めてChatwork通知のみにしたい場合は、[独自設定]から[メールの送信停止]に1をセットします。
- Chatworkでメンションを
ToALLにする場合は[toall]と書きます。 - Chatworkでメンションを個人宛にする場合は
[To:{account_id}]と書きます。
フォーム基本設定を設定する
[キャンペーン]->[フォーム]をクリックします。
フォームのタイトルをクリックします。
基本設定タブの配信先メールアドレスで、[通知する]にチェックを入れてメールアドレスとタイトルを入力します。
動作確認
最後に動作確認をします。
管理者宛の通知を有効にしたフォームへ回答の送信をすると、メールの通知に加えて、Chatworkチャンネルへの通知が行われます。
以上でお問い合わせの受信通知をChatworkで送信できました。
同様の方法でKurocoの任意の動作をトリガーにChatWorkへ投稿できますのでお試しください。
関連ドキュメント
サポート
お探しのページは見つかりましたか？解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。