python

【python】webhookを受信する方法【→プログラム初心者でもできる!】

10月 23, 2019

how to receive webhook message on python
プログラム女子
チャットBOTってどうやって作るの?
チャットシステムにはwebhookというしくみがあって、それをうまく使いこなせると、プログラムでBOTをコントロールすることができるよ。今回はそのwebhookの使い方を説明するね。
Tommy

この記事で分かること

  • BOT(ボット)を使うシステムとwebhookの関係が分かる
  • webhookとトンネリングサービスの関係が分かる
  • トンネリングサービスの利用方法が分かる
  • pythonプログラムでトンネリングサービスの実装方法が分かる

pythonでwebhookを受信する概要

summary of receiving webhook message

社内LANなどインターネットから切り離されたネットワークを使っている場合に、外部(インターネット)からイベントを受信したい場合があります。例えば、チャットシステムのBOTなどのWebhookシステムなどは、チャット送信が一旦インターネット上のサービスで受信され、そこから所望のURLへと転送されるようになっていることが多いです。

ところが、メッセージを受信して処理するシステムが社内ネットワークのみで動作している場合は、このメッセージイベントを受信することができません。なぜなら、社内ネットワーク(イントラネット)と公共のネットワーク(インターネット)の間には、外部からのアクセスを遮断するファイヤーウォールがあるからです。

そのような場合には、ngrokのトンネリングサービスを利用することができます。トンネリングサービスとは、社内ネットワークと公共のネットワークをつなぐセッションを社内ネットワーク側から作り、その公共ネットワーク側に受信したデータを、社内ネットワークに取り込むというしくみのことです。

この記事では、トンネリングサービスの代表であるngrokの使い方を説明することによって、webhookを受信する方法を説明します。

pythonでwebhookを受信する前提環境

environment of receiving webhook message

webhookを受信する前提環境は、下の記事で説明している私の環境と同じ環境で確認しています。

オススメ
how to check version in python
【python】バージョン確認の方法【→プログラミング初心者向け】

続きを見る

また、レンタルサーバなどのLinuxサーバを使っている場合は、下の記事でプログラミングする環境の作り方を説明しています。

もし、まだプログラムする環境ができていない方は、先にこちらの記事を読んで、プログラミングできる環境をつくることをおすすめします。

オススメ
how to programming on rental server
レンタルサーバでプログラミングする方法【→ブログのサーバでできる!】

続きを見る

pythonでwebhookを受信する手順

step of receiving webhook message

ngrokのインストール

下記にアクセスしてシステムに応じた実行ファイルをインストールします。

ngrok - secure introspectable tunnels to localhost

ngrokのインストール手順は、

  1. ダウンロード
  2. zip解凍&インストール
  3. アカウントを作って、"Connect your account"を押する

になります。

pythonでwebhookを受信するサンプルプログラム

sample program of receiving webhook message

ここでは、さきほどインストールしたngrokをpythonプログラムから実行して、webhookを受信するサンプルプログラムを説明します。

ライブラリのインポート

import subprocess
import time
import shlex

  1. ライブラリ「subprocess」をインポートする。
  2. ライブラリ「time」をインポートする。
  3. ライブラリ「shlex」をインポートする。

Linuxコマンドの実行

ここでは、Linuxコマンドをpythonプログラムから呼び出す関数を定義します。その関数名を「exe_linux_command」とし、引数に、任意のLinuxコマンドのテキスト「commad」を取ります。

def exe_linux_command(command):
    tokens = shlex.split(command)
    p = subprocess.Popen(tokens)
    for line in iter(p.stdout.readline,b''):
        print(line.rstrip().decode("utf8"))

    return

  1. 関数「exe_linux_command」を定義宣言する。
  2. 変数「tokens」を「shlex」ライブラリの関数「split」の引数に変数「command」を指定した場合の戻り値で初期化する。
  3. 変数「p」をライブラリ「subprocesss」の関数「Popen」の戻り値で初期化する。
  4. 変数「p」に対して出力を確認する関数「stdout.readline」の結果を、変数「line」に格納しながら、以下の処理を繰り返す
    1. 「line」の内容を表示する。
  5. 関数「exe_linux_command」から戻る(リターンする)。

pythonプログラムからLinuxコマンドを呼び出す具体的な方法は、下の記事で解説していますので、こちらも合わせて読んでください。

オススメ
how to perform linux command on python
【python】linuxのコマンドを実行する【→プログラミング初心者向け】

続きを見る

ngrokの開始するプログラム

ここでは、カレントディレクトリの配下の「tools」というディレクトリにngrokをインストールしたとして、ngrokを開始する方法を説明します。

また、このURLは公共ネットワーク側にあります。このURLからトンネリングした社内ネットワーク側にhttpリクエストを受け取るためのHTTPサーバを立てる必要があります。この「HTTPサーバを立てる方法」に関しては、下記の記事を読んでください。

オススメ
how to build http server on python
【python】HTTPサーバを立てる【→業務改善したい人向け】

続きを見る

下のプログラムでは、htttpサーバーのポート4000番を指定しています。ngrokを開始すると、URLが発行されます。このURLをWebhookで指定するメッセージの転送先に設定することで、webhookからのメッセージを受け取ることができます。webhookからのメッセージはngrokから発行されたURL宛に送信されますが、送信されるメッセージはHTTPリクエストの形をしています。

def start_ngrok():
    ret = exe_linux_command('/tools/ngrok http 4000')
    print(ret)

  1. 関数「start_ngrok」を定義宣言する。
  2. 変数「ret」を文字列「/tools/ngrok http 4000」を引数に指定した関数「exe_linux_command」の戻り値で初期化する。
  3. 変数「ret」の内容を表示する。

ngrokの開始実行処理

下記のプログラムでは、main関数から上で定義したstart_ngrok()を呼び出します。

if __name__ == '__main__':
	start_ngrok()

関数「start_ngrok」を呼び出す。

-python
-

© 2021 Tommy's blog Powered by AFFINGER5