最近RaspberryPi上でpython走らせてDiscordにメッセージ投稿する・・・
みたいなのをチョコチョコ作ってるのに毎度毎度躓く。
悩みたいのはそこじゃない。

公式ちゃんと読めよって話ですが、サンプル殆ど載っていないので備忘録。

参考

DiscordにWebhookでいろいろ投稿する
 Webhook Resource
file
Visualizer and validator for Discord embeds.
Videos in Rich Embeds

材料

python3：3.7.3
json：2.0.9
requests：2.21.0
添付ファイルサンプルとして：ブランドガイドライン

メッセージだけ

import json
import requests

WEBHOOK_URL = "うえぶふっくURL?wait=true"

payload = {
	"username"		: "メッセージ",
	"content"		: "だけだよ。",
	"avatar_url"	: "https://github.com/qiita.png",
}

###	メッセージだけ
res = requests.post( WEBHOOK_URL, json=payload )
print( res.status_code )
print( json.dumps( json.loads(res.content), indent=4, ensure_ascii=False ) )

application/json、json指定するだけ。
webohook URL に?wait=trueを付けてあげるとcontent返してくれる。付けないとstatus_codeが204、content返ってこない。
チャンネル下のスレッドに投下したいなら、thread_idも付けてやる。アーカイブ済のスレッドは自動でアーカイブ解除してくれるらしい。
スレッドIDを取得するには「ユーザー設定」→「アプリの設定」→「詳細設定」で「開発者モード」をONにすると表示される「IDをコピー」メニューでコピーするのが手っ取り早い。
それぞれWebhookURLに繋げるとこんな感じ。
https://discord.com/api/webhooks/{webhookID}/{webhookトークン}?wait=true&thread_id={スレッドID}

添付ファイルだけ

import json
import requests

WEBHOOK_URL = "うえぶふっくURL?wait=true"

### 画像添付
with open("favicon.png", 'rb') as f:
	file_bin = f.read()
files_qiita = {
	"favicon" : ( "favicon.png", file_bin),
}
res = requests.post( WEBHOOK_URL, files = files_qiita )
print( res.status_code )
print( json.dumps( json.loads(res.content), indent=4, ensure_ascii=False ) )

multipart/form-data、バイナリreadしてfilesに指定するだけ。
wait付くなくてもcontent返ってくる。

メッセージ＋embed＋添付ファイル

import json
import requests

WEBHOOK_URL = "うえぶふっくURL?wait=true"

payload2 = {
	"payload_json" : {
		"username"		:"メッセージと、",
		"content"		:"添付ファイルと、",
		"avatar_url"	: "https://github.com/qiita.png",
		"embeds": [
			{
				"title"			: "payload_json",
				"description"	: "embedsそのまま使うと怒られる。代わりにpayload_jsonに全部ぶち込んで文字列にdumpしたら良さげ。ensure_ascii=False 無くても多分大丈夫。",
				"url"			: "https://birdie0.github.io/discord-webhooks-guide/structure/file.html",
				"timestamp"		: "2020-08-22T15:18:00+0900",
				"color"			: 5620992,
				"footer": {
					"icon_url"	: "attachment://favicon.png",
					"text"		: "Qiita",
				},
				"thumbnail": {
					"url"		: "attachment://logo-background-color.png"
				},
				"image": {
					"url"		: "attachment://logo-effect-background-color.png"
				},
				"author": {
					"name"		: "embedと。",
					"url"		: "https://qiita.com/",
					"icon_url"	: "attachment://favicon.png",
				},
				"video": {
					"url"		: "https://www.youtube.com/embed/q05aeEf17Kc"
				},
				"fields": [
					{
						"name"	: "添付画像を",
						"value"	: "embedsで使うと別表示しなくなるっぽい。",
						"inline": True,
					},
					{
						"name"	: "attachment:",
						"value"	: "embedの中でしか添付使えないっぽい。",
						"inline": True,
					},
					{
						"name"	: "Visualizer and validator for Discord embeds.",
						"value"	: "日本語入れたら怒らたけど、color pickerが地味に便利。",
					},
					{
						"name"	: "Youtubeの",
						"value"	: "[埋め込みは無理っぽい](https://support.discord.com/hc/en-us/community/posts/360037387352-Videos-in-Rich-Embeds)\nvideo URL 指定しても無視される。",
					},
				],
			}
		]
	}
}

### embed付き
with open("favicon.png", 'rb') as f:
	file_bin_favicon = f.read()
with open("logo-background-color.png", 'rb') as f:
	file_bin_logobg = f.read()
with open("logo-effect-background-color.png", 'rb') as f:
	file_bin_logoeffect = f.read()
files_qiita  = {
	"favicon" : ( "favicon.png", file_bin_favicon ),
	"logo_bg" : ( "logo-background-color.png", file_bin_logobg ),
	"logo_effect" : ( "logo-effect-background-color.png", file_bin_logoeffect ),
}
payload2['payload_json'] = json.dumps( payload2['payload_json'], ensure_ascii=False )
res = requests.post(WEBHOOK_URL, files = files_qiita  , data = payload2 )
print( res.status_code )
print( json.dumps( json.loads(res.content), indent=4, ensure_ascii=False ) )

multipart/form-data
添付ファイルは前項同様filesに指定。メッセージ内容の方は公式読んでもフワっとしててハッキリ分からない。
添付ファイルを付ける場合embedとかそのまま使うと怒られる。代わりにpayload_jsonに全部入れてdumpして文字列化、dataに指定。これで何とかなった。
添付した画像ファイルはembeds内では使えたが、avatar_urlには使えなかった。
Embed Objectにvideoは居たので youtube URL を試してみるが、現状webhookには使えなさそう。
wait付くなくてもcontent返ってくる。
実際に投稿するとこんな感じ。