LINE Works Bot入門

メリークリスマス！若手エンジニアふんわりLT Night！の資料です。
https://wakate-funwari-study.connpass.com/event/333619/

Transcript

1. LINE Works Bot入門 2024/12/6 メリークリスマス！若手エンジニアふんわり LT Night！ マグロ
2. 自己紹介 名前：マグロ/佐々木陽貴(sasaki haruki) 所属：株式会社くふうカンパニー (24卒サーバーサイド) X(旧Twitter):@sigumataityouda GitHub:@maguro-alternative コメント：isucon間近でドキドキ
3. 皆さん突然ですが
4. メリークリスマス！！！
5. プレゼントもらいましたか？ 僕はこんなプレゼントが...
6. LINE Notify終了
7. LINE Notifyとは？ • LINEに通知を送るだけのサービス。 (画像はLINE Notify公式のもの)
8. LINE Notifyとは？ • Messaging APIよりも送れる件数が多く、重宝されていた。 ◦ Messaging APIは月200件、LINE Notifyは1時間に1000件。
9. LINE Notifyとは？ • 個人で作ってた Discord→LINEの連携で重宝してた ためショックが大きい。
10. 代替え探し • Discordは❌ ◦ 利用者の多くは Discordの通知はメンションだけにしたいと言う理由で利用。 • LINE Messaging APIも❌ ◦ 月200件の制約がきつく、代替が効かない。 • LINE front-end framework(LIFF)も❌ ◦ 通知としての利用は利用規約で禁止されている。 ▪ そういった挙動は見つけ次第 Banされる。
11. LINE Worksへ • LINEのビジネス用チャットツール。 • LINEと別物だが、LINEアカウントがあれば利用可能。 • 個人利用も可能。 • グループ内であればAPIに制限なし。 これだ！！！！！！！！！！！！！！！！！！！！
12. LINE Works Bot 入門 (とりあえず送受信)
13. APIの流れ • 参照：https://developers.worksmobile.com/jp/docs/api
14. APIの流れ • アクセストークンの発行は OAuth2.0の方針に従っている。 ◦ Botを仮想管理者として扱うためらしい。
15. APIの流れ • 有効期限があるため、無効になったら再発行をしなければならない。 ◦ アクセストークンの有効期限は 24時間、リフレッシュトークンの有効期限は 90日。 ◦ LINE NotifyやMessaging APIのトークンは期限が無かったので、ここが大きな違いかも。 •
16. APIの流れ • 認可はJWTで行う。
17. APIの流れ とりあえずJWT発行してトークンを取得してみる。
18. APIの流れ 無事発行出来たっぽい。 (アクセストークンは有効期限が切れているので隠してません。 )
19. APIの流れ • 発行したトークンでBotを操作する。
20. APIの流れ 「{Reply text}」というメッセージを送ってみる。
21. APIの流れ 無事出来たっぽい。 チャット画面
22. APIの流れ 次の日試したら無事失敗したっぽい。 (アクセストークンの有効期限が切れたため ) 送信用のコンソール
23. APIの流れ というわけでリフレッシュトークンを使って再発行もしてみ る。
24. APIの流れ 発行出来てそう。 (こちらもトークンの有効期限が切れているので隠しません。 )
25. メッセージ受信の流れ • 参考：https://developers.worksmobile.com/jp/docs/bot-callback
26. メッセージ受信の流れ • サーバー側でメッセージを受け取る。 ◦ この辺はMessaging APIと同じ。
27. メッセージ受信の流れ • 今回はこの署名検証で受け取れるか試す。
28. メッセージ受信の流れ • リクエストヘッダーの X-WORKS-Signature に含まれる署名を検証 ◦ Bot Secret を秘密鍵として利用し、メッセージサーバーから送られたリクエストボディを HMAC-SHA256 アルゴリズムでエンコード。 ◦ 上記をBase64 エンコード。 ◦ これをX-WORKS-Signaturetと比較。 サーバー側 署名検証
29. メッセージ受信の流れ いけてそう 送受信おっけい
30. まとめ • LINE Works Botは仮想管理者。 ◦ トークンには有効期限があるので、再発行の準備はすること。 • その他の使い勝手はMessaging APIに結構似ている。 ◦ Messaging APIになれてる人はトークン発行さえできれば使いやすいかも。