Visit Flock’s Developer Dashboard, and click on Start Creating a Flock App.
Fill in the information requested and Click on the Save button to create the app.
App Name: Todo
App URL: todo
Short Description: This app maintains todo list for chats.
Support Email: <Some email>
Support URL: <Some url>
Source code URL: <open source url>
App store Icon: Multi colored app icon in SVG format
App Background Color: Prominent color in app store icon
App icon used inside client: Single color icon in SVG format
Specify your App Service URL - This is an HTTPS endpoint provided by your App Service. Flock will send app.install event to this endpoint which provides app with user token for each user who installs your app. Using this user token, your app can send messages and attachments on user’s behalf.
Note: App service should respond to app.install event with HTTP 200 status code in order for installation to succeed.
For TODO app, we configure Launcher button functionality in the Advanced Info section with the following setting:
Tooltip text: View shared todos
Action:
"Open Widget"
Type of widget in Desktop: Sidebar
Action URL: “<Your app public IP>/view”
Todo app’s launcher button will open a widget (sidebar on Desktop and modal on mobile) showing todos related to a particular chat or todos for all chats.
Copy app secret and store this securely. This is a shared secret between Flock and your app. Your app service needs to verify validation token sent in event info to make sure request is sent from Flock.