なにを作ったのか

簡単に説明すると「Backlog で起票された課題の内容/属性をコピーして、Zendesk のチケットとして起票する」を全て自動で行う仕組みを API Gateway と AWS Lambda を使って作りました。

なぜ作ったのか

サーバーワークスでは、お客様のAWS導入をお手伝いさせていただく際にお客様との連絡手段として Backlog ( プロジェクト管理ツール ) を利用しており、AWS運用代行をご利用いただくお客様との連絡には、Zendesk ( カスタマーサポートソフトウェア ) を利用しています。

通常、AWSの導入支援で環境/システムを構築した後は、弊社がそのまま運用/管理を担当させていただく場合が多いのですが、その際( 構築フェーズから運用フェーズに移行 )に上記で挙げた連絡ツールの変更 ( Backlog → Zendesk ) が発生します。
もちろん、その場合には弊社からお客様へアナウンスさせていただくのですが、運用フェーズに移行した後も Zendesk ではなく Backlog へ書き込んでしまうお客様もいらっしゃいます。
( Backlog は構築フェーズが終わった段階で閉じてしまいますが、情報参照用として期間を限定した上で閲覧/起票が可能な状態になっている場合があるため )

構築を担当したエンジニアや、運用チームのエンジニアは Backlog や Zendesk を常に見張っていますが、運用フェーズに移行したプロジェクトの Backlog はどうしても確認する頻度は落ちてしまいます。

お客様が Backlog で起票した課題を万が一でも見逃すことを避けるため、そして定期的に課題をチェックするという負荷を減らすために、今回の( Backlog の課題を Zendesk のチケットとして起票する )仕組みを作るに至りました。

全体構成図

冒頭でも書きましたが、API Gateway と AWS Lambda の2つで構成しています。

動作の仕組み

中身は非常に単純です。
Backlog は課題の起票/更新時に Webhook のイベントを発火させる事が出来るので、これを利用します。

まず、Backlog で課題起票/更新時に API Gateway のエンドポイントへ Webhook で POST します。 ( 下図の② )
そして、その POST を API Gateway が受け付けて、紐付けられた Lambda function が起動、Zendesk でチケットを起票する ( 下図の③, ⑤ )、という仕組みです。