C# で Slack にメッセージを送信する方法

★★★ Live配信告知 ★★★ぜひお申込みください！
◆◇世界一わかりみの深いクラウドネイティブ on Azure◆◇
7/7(木) 19:00～　第15回：クラウド上でのライブ配信環境〜OBS on Azureで高速・堅牢なライブ配信環境を作る〜今回は、クラウドなライブ配信環境の構築方法をお届けします。
◆◇PS Live◆◇
7/15(金) 17:00～　第18回：アウトプットはイイぞ〜サイオステクノロジーLT大会〜エンジニア初級者向けから、個人ネタまで、エンジニア脳を体感できるプログラムです。

こんにちは。サイオステクノロジーの木村です。
今回は、Slack API を使用して、C# にて Slack にメッセージを送信する方法をご紹介します。

1 Slackの設定（Incoming Webhook）
2 Slackのへメッセージ送信
3 Slack API – Block Kit

Slackの設定（Incoming Webhook）

Slack APIには、外部からSlackに送信するための仕組みである Incoming Webhook があります。
以下の手順でアプリを作成し、 Incoming Webhook の設定を行います。

1. Slack API にアクセスし、「Create an app」をクリックします。

2. 「From scrach」をクリックします。

3. 「App Name」に任意のアプリ名を入力します。「Pick a workspace to develop your app in:」にてメッセージを送信したいworkspace名を選択し、「Create App」をクリックします。

4. 左側のメニューより「Incoming Webhooks」をクリックします。

5. Active Incoming Webhooksを「On」にします。

6. 下部にスクロールし、「Add New Webhook to Workspace」をクリックします。

7. 送信先のチャンネルを選択し「許可する」をクリックします。

8. Webhook URL の「Copy」をクリックし、コピーしたURLをメモしておきます。

Slackのへメッセージ送信

Slack へメッセージを送信するには、json形式で送信内容を作成し、先ほどメモした Webhook URL に POST送信するだけです。
コンソールアプリケーションを作成し、以下のように実装します。


using System;
using System.Text;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Net.Http;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            // Webhook URL
            var webhookUrl = "<先ほどメモしたWebhook URL>";

            var payload = new Payload { Text = "こんにちは。" };
            var json = JsonSerializer.Serialize(payload);

            var client = new HttpClient();
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var result = client.PostAsync(webhookUrl, content).Result;
            Console.WriteLine(result);
        }
    }

    public class Payload
    {
        [JsonPropertyName("text")] public string Text { get; set; }
    }
}

using System;

using System.Text;

using System.Text.Json;

using System.Text.Json.Serialization;

using System.Net.Http;

namespace ConsoleApp1

{

class Program

{

static void Main(string[] args)

{

// Webhook URL

var webhookUrl = "<先ほどメモしたWebhook URL>";

var payload = new Payload { Text = "こんにちは。" };

var json = JsonSerializer.Serialize(payload);

var client = new HttpClient();

var content = new StringContent(json, Encoding.UTF8, "application/json");

var result = client.PostAsync(webhookUrl, content).Result;

Console.WriteLine(result);

}

public class Payload

{

[JsonPropertyName("text")] public string Text { get; set; }

}

実行すると、送信先に指定したチャンネルにメッセージが送信されます。

Slack API – Block Kit

Slack API には、Block Kit というメッセージUIフレームワークがあり、Block Kit の形式に則ったjsonを構築して送信することで、よりリッチな表現のメッセージを送信することができます。
また、Block Kit Builderという、ブラウザにて Block Kit の表示を確認できるツールも用意されています。
以下は Block Kit Builder の画面です。
左ペインのボタンをクリックすると、クリックした項目に対応するブロックのjsonを作成して表示してくれます。
また、上部の「Send to Slack」をクリックすると、Block Kit Builder 上で表示した内容を、Slack に送信することもできます。

例えば、以下は Block Kit の Section、Driver、Context を使用して作成したメッセージです。

このメッセージを送信するには、以下のように実装します。


using System;
using System.Text;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Net.Http;
using System.Collections.Generic;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            // Webhook URL
            var webhookUrl = "<先ほどメモしたWebhook URL>";

            List<Object> blocks = new List<Object>();

            // section block
            blocks.Add(new Section { Type = "section", TypeText = new TypeText{ 
                Type = "mrkdwn",  
                Text = "*サイオステクノロジー技術ブログ* <https://tech-lab.sios.jp/|*SIOS Tech.Lab* :heart:>\nC# に関する記事"
            } });
            // divider
            blocks.Add(new Divider { Type = "divider" });

            // section block with an accessory image
            blocks.Add(GetSectionA(
                "*<https://tech-lab.sios.jp/archives/20603|C#でJSONのレスポンスを受け取るRest APIを書く方法>*\nTips\n*Last Update:*　July 10, 2020",
                "https://tech-lab.sios.jp/wp-content/uploads/2020/07/Screen-Shot-2020-07-10-at-0.30.54-326x245.png",
                "image1"));
            // divider
            blocks.Add(new Divider { Type = "divider" });
            // section block with an accessory image
            blocks.Add(GetSectionA(
                "*<https://tech-lab.sios.jp/archives/20438|C# LDAPSで Active Directory に接続>*\nTips\n*Last Update:*　July 1, 2020",
                "https://tech-lab.sios.jp/wp-content/uploads/2020/07/EFL_jellybeanshana_TP_V-326x245.jpg",
                "image2"));
            // divider
            blocks.Add(new Divider { Type = "divider" });
            // section block with an accessory image
            blocks.Add(GetSectionA(
                "*<https://tech-lab.sios.jp/archives/15986|C#のCalcellation Token>*\nTips\n*Last Update:*　June 10, 2019",
                "https://tech-lab.sios.jp/wp-content/uploads/2019/06/Screen-Shot-2019-06-10-at-8.16.52.png",
                "image3"));
            // divider
            blocks.Add(new Divider { Type = "divider" });

            // context block
            blocks.Add(new Context {
                Type = "context",
                Elements = new List<TypeText> { new TypeText { 
                    Type = "mrkdwn", 
                    Text = ":pushpin:上記は記事の一部です。他にもたくさん記事がありますので、是非 <https://tech-lab.sios.jp/|*SIOS Tech.Lab*> へアクセスしてください。" } } 
            });

            var payload = new Payload { Blocks = blocks };
            var json = JsonSerializer.Serialize(payload);
            var client = new HttpClient();
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var result = client.PostAsync(webhookUrl, content).Result;
            Console.WriteLine(result);

        }

        private static SectionA GetSectionA(string text, string imageUrl, string imageName)
        {
            var sectionA = new SectionA
            {
                Type = "section",
                TypeText = new TypeText{ Type = "mrkdwn", Text = text},
                Accessory = new Accessory { Type = "image", ImageUrl = imageUrl, AltText = imageName}
            };
            return sectionA;
        }
    }

    public class Payload
    {
        [JsonPropertyName("blocks")] public List<Object> Blocks { get; set; }
    }

    public class TypeText
    {
        [JsonPropertyName("type")] public string Type { get; set; }
        [JsonPropertyName("text")] public string Text { get; set; }
    }

    public class Section
    {
        [JsonPropertyName("type")] public string Type { get; set; }
        [JsonPropertyName("text")] public TypeText TypeText { get; set; }
    }

    public class SectionA
    {
        [JsonPropertyName("type")] public string Type { get; set; }
        [JsonPropertyName("text")] public TypeText TypeText { get; set; }
        [JsonPropertyName("accessory")] public Accessory Accessory { get; set; }
    }

    public class Divider 
    { 
        [JsonPropertyName("type")] public string Type { get; set; }
    }

    public class Accessory
    {
        [JsonPropertyName("type")] public string Type { get; set; }
        [JsonPropertyName("image_url")] public string ImageUrl { get; set; }
        [JsonPropertyName("alt_text")] public string AltText { get; set; }
    }

    public class Context
    {
        [JsonPropertyName("type")] public string Type { get; set; }
        [JsonPropertyName("elements")] public List<TypeText> Elements { get; set; }
    }

}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

using System;

using System.Text;

using System.Text.Json;

using System.Text.Json.Serialization;

using System.Net.Http;

using System.Collections.Generic;

namespace ConsoleApp1

{

class Program

{

static void Main(string[] args)

{

// Webhook URL

var webhookUrl = "<先ほどメモしたWebhook URL>";

List<Object> blocks = new List<Object>();

// section block

blocks.Add(new Section { Type = "section", TypeText = new TypeText{

Type = "mrkdwn",

Text = "*サイオステクノロジー技術ブログ* <https://tech-lab.sios.jp/|*SIOS Tech.Lab* :heart:>\nC# に関する記事"

} });

// divider

blocks.Add(new Divider { Type = "divider" });

// section block with an accessory image

blocks.Add(GetSectionA(

"*<https://tech-lab.sios.jp/archives/20603|C#でJSONのレスポンスを受け取るRest APIを書く方法>*\nTips\n*Last Update:*　July 10, 2020",

"https://tech-lab.sios.jp/wp-content/uploads/2020/07/Screen-Shot-2020-07-10-at-0.30.54-326x245.png",

"image1"));

// divider

blocks.Add(new Divider { Type = "divider" });

// section block with an accessory image

blocks.Add(GetSectionA(

"*<https://tech-lab.sios.jp/archives/20438|C# LDAPSで Active Directory に接続>*\nTips\n*Last Update:*　July 1, 2020",

"https://tech-lab.sios.jp/wp-content/uploads/2020/07/EFL_jellybeanshana_TP_V-326x245.jpg",

"image2"));

// divider

blocks.Add(new Divider { Type = "divider" });

// section block with an accessory image

blocks.Add(GetSectionA(

"*<https://tech-lab.sios.jp/archives/15986|C#のCalcellation Token>*\nTips\n*Last Update:*　June 10, 2019",

"https://tech-lab.sios.jp/wp-content/uploads/2019/06/Screen-Shot-2019-06-10-at-8.16.52.png",

"image3"));

// divider

blocks.Add(new Divider { Type = "divider" });

// context block

blocks.Add(new Context {

Type = "context",

Elements = new List<TypeText> { new TypeText {

Type = "mrkdwn",

Text = ":pushpin:上記は記事の一部です。他にもたくさん記事がありますので、是非 <https://tech-lab.sios.jp/|*SIOS Tech.Lab*> へアクセスしてください。" } }

});

var payload = new Payload { Blocks = blocks };

var json = JsonSerializer.Serialize(payload);

var client = new HttpClient();

var content = new StringContent(json, Encoding.UTF8, "application/json");

var result = client.PostAsync(webhookUrl, content).Result;

Console.WriteLine(result);

}

private static SectionA GetSectionA(string text, string imageUrl, string imageName)

{

var sectionA = new SectionA

{

Type = "section",

TypeText = new TypeText{ Type = "mrkdwn", Text = text},

Accessory = new Accessory { Type = "image", ImageUrl = imageUrl, AltText = imageName}

};

return sectionA;

}

public class Payload

{

[JsonPropertyName("blocks")] public List<Object> Blocks { get; set; }

}

public class TypeText

{