BizDoc.Social.Slack 6.8.3

Slack for BizDoc

BizDoc pushes messages and notifications into Slack and responds to actions in Slack on messages.

To utilize Slack messaging, add in program.cs.

builder.Services.AddBizDoc().AddSlack(o => {
	o.Token = "{bot-oauth-token}";
	o.ChannelId = e => "{channel-id}";
});


app.UseBizDoc().UseSlack();

Sockets

To enable socket for background communication, call UseSocket().

builder.Services.AddBizDoc().AddSlack(o => ..., 
	e => e.UseSocket(o => {
		Token = "{app-level-token}";
	}));

You can configure ProxySettings and retry policy on this option.

Remember to enable Socket Mode in app config. Use app-level token.

Responding to events

builder.Services.AddBizDoc().
	AddSlack(..., e =>
		e.UseSocket(o =>
			o.OnMessageReceived = e => {
				if(e.Message is EventCallback em && em.Payload.Event is NewMessage msg)
					Debug.Write($"Message text '{msg.Text}'");
			}));

You can notify the user by setting the event Response property.

	e.Response.Text = Markdown($"*{ctx.Document.Number}* success!");

Events.

Message types.

Service

Inject SlackService service.

await _slackService.PostMessageAsync("channel-id", "Message!");

Intercept outgoing messages

Implement the OnMessagePost option in AddSlack() to contribute an outgoing message.

Use the IDocumentContext to access form model using the GetModel() method.

using BizDoc.Slack.Models;

builder.Services.
	AddBizDoc(o => {
		o.ApplicationUrl = "{server-public-address}";
	}).
	AddSlack(o => {
		...
		o.OnMessagePost = e => {
			var formModel = e.Context.GetModel<MyFormModel>();
	
			var section = new Section("form_section");
			section.Fields.Add(new Text(formModel.Title));
		
			e.Request.Blocks.Add(section);
		}
	});

Block can be one of Section, ImageBlock, InputBlock, RichTextBlock or ActionsBlock, which corresponds to Block Kit.

Element can be one of Input, DatePicker, Checkboxes, RadioButtons, Select, MultiSelect, Image, OverflowMenu, Button, ConversationsSelect, MultiConversationsSelect, ChannelsSelect or MultiChannelsSelect.

Use Text or Markdown to represent texts.

Commonly use Section, and Button as section Accessory for interaction.

The ApplicationUrl is used to provide the Slack user links back to BizDoc.

Components

Components can be found in bizdoc.slack.json file.

Flow node

SlackMessge.

Post a message in a channel when workflow reaches the node.

Type source