BizDoc.Core.Slack 6.5.5

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 = "{token-here}";
	o.ChannelId = "{channel-id-here}";
});


app.UseBizDoc().UseSlack();

Form details

Implement the OnDeliverMessage option in AddSlack() to contribute message.

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

using BizDoc.Slack.Models;

builder.Services.AddBizDoc().AddSlack(o => {
	...
	o.OnDeliverMessage = e => {
		var model = e.Context.GetModel<MyModel>();
	
		var section = new Section("form_section");
		section.Fields.Add(new Text(model.Title));
		
		e.Request.Blocks.Add(section);
	}
});

Block can be one of Header, Section, Image, Input or Actions, which corresponds to Block Kit. Elemtn can be one of InputElement, DatePicker, Checkboxes, RadioButtons, Select, MultiSelect, ImageElement or Button. Use Text or Markdown to represent texts.

Commonly use Section block, possibly setting an Accessory element.

Socket

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

builder.Services.AddBizDoc().AddSlack(o => { ... }, 
	e => e.UseSocket());

You can configure ProxySettings on this.

Remember to enable Socket Mode in app config.

Responding to events

builder.Services.AddBizDoc().
	AddSlack(o => {
		...
		o.OnMessageReceived = e => {
			e.Response.GetActionValue("action-id");
		}
	});

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

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

Service

Inject SlackService service.