Skip to content

A utility to handle the creation and processing of Slack Dialogs.

License

Notifications You must be signed in to change notification settings

The-Politico/django-slack-forms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

POLITICO

django-slack-forms

A utility to handle the creation and processing of Slack Dialogs.

Slack Dialogs (forms) are a great and easy way to get data from members of your Slack team. They can be called in a number of ways, they're designed to work on desktop and mobile, and they're already on a familiar platform.

Unfortunately making and sending forms to your users can require an elaborate knowledge of the often-arcane Slack API. Furthermore, validation beyond required fields and character limit has to be handled programmatically by your server which more often than not means you just don't do it.

Django Slack Forms is here to solve these and more hurtles by using a popular JSON Schema to shape and validate your data. New forms can be created in a Django admin with a number of ways to connect it to outside data and webhooks. The app is designed to be as flexible as possible to accommodate your individual data needs and data structures.

At its most basic level, the app works like the flowchart below with you, the developer, being responsible for installation, and all of the optional steps in the third column (labeled External). Due to it's flexibility, this app is not plug-and-play, but hopefully this guide will help you install it into your current infrastructure in no time.

In order to get django-slack-forms up and running you'll have to complete the following tasks:

  1. Create a Slack App on the Slack API Dashboard.

  2. Install this app into your Django application.

  3. Create a form in your Django admin.

  4. Configure an endpoint to receive your form data.

Once you have the basics down, you can move on to more advanced topics like:

  1. Configure external source data.

  2. Integrate with a REST API.

  3. Set up custom form triggers.

  4. Post feedback to Slack channels.

If you're already familiar with this app and you're looking for a quick reminder check out the Quick Reference guide.

If you're looking to develop this app you can check out the development docs.


How django-slack-forms works...

Flowchart

About

A utility to handle the creation and processing of Slack Dialogs.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published