Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gpailler/cestkiki
Azure Functions to keep track of the stand-up meeting presenter
https://github.com/gpailler/cestkiki
azure-functions slack zoom
Last synced: 16 days ago
JSON representation
Azure Functions to keep track of the stand-up meeting presenter
- Host: GitHub
- URL: https://github.com/gpailler/cestkiki
- Owner: gpailler
- License: mit
- Created: 2022-08-30T01:16:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-17T13:27:22.000Z (about 2 years ago)
- Last Synced: 2024-11-10T19:57:25.194Z (2 months ago)
- Topics: azure-functions, slack, zoom
- Language: C#
- Homepage:
- Size: 63.5 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# CestKiKi Azure functions
[](https://github.com/gpailler/CestKiKi/actions/workflows/main.yml)
[](https://sonarcloud.io/summary/new_code?id=gpailler_CestKiKi)
## Summary
You are running a daily stand-up meeting on Zoom with a rolling presenter and you always forget who was presenting the day before?
This project is for you!
## General design
CestKiki runs serverless, on the cloud. It uses webhooks to receive notifications about Zoom screen sharings and stores needed infos into an Azure Table. Once a day, it queries the Table to find who was sharing his screen during the stand-up and send a Slack notification.
```mermaid
sequenceDiagram
participant A as Zoom
WebHook app
participant B as Azure Function
ZoomWebHookFunction
participant C as Azure
Tables
participant D as Azure Function
NotificationFunction
participant E as Slack
Incoming Webhook
rect rgb(191, 223, 255)
note right of A: Continuously
A->>B: Send sharing_started event
B->>C: Add sharing info entity
(user, start time...)
A->>B: Send sharing_ended event
B->>C: Update sharing info entity
(end time...)
end
rect rgb(191, 223, 255)
note right of C: Once a day
D->>C: Query sharing entities
and find who was sharing
his screen during the stand-up
D->>E: Send notification
end
```
## Configuration
### Azure
- Create a new Azure Function App (a new Storage account should be automatically created)
### Zoom
- Create a [Webhook only app](https://marketplace.zoom.us/docs/guides/build/webhook-only-app/) on the [Zoom Marketplace](https://marketplace.zoom.us/develop/create)
- Use the generated **Secret Token** for the Azure Function configuration below
- Use the *https://[AZURE_FUNCTION_NAME].azurewebsites.net/api/ZoomWebHook* URL for the **Event notification endpoint**
- Enable **Event Subscriptions** for the following events:
- Participant/Host left meeting
- Meeting Sharing Started
- Meeting Sharing Ended
### Slack
- Create a [new App](https://api.slack.com/apps) in your workspace
- Activate the [Incoming Webhooks](https://api.slack.com/messaging/webhooks), create a new Webhook for your channel and use the generated URL for the Azure Function configuration below
### Azure
- Edit the Function App Configuration and add the following settings:
- `Notification:StandUpTimeZone = Europe/Paris` *(Zone ID from https://nodatime.org/TimeZones)*
- `Notification:StandUpStartTime = 10:15:00`
- `Notification:StandUpEndTime = 10:30:00`
- `Notification:NotificationTime = 10:30:00`
- `NotificationCron = 0 30 * * * *` *(The Azure function should run at the same time as the NotificationTime)*
- `Notification:WebHook = https://hooks.slack.com/services/[...]` *(Slack Incoming Webhook configured above)*
- `Zoom:MonitoredRoom = 123456789` *(Zoom room id where the stand-up occurs)*
- `Zoom:WebHookSecret = [...]` *(Secret Token from Zoom generated above)*
- Edit Networking -> Inbound Traffic -> Access restriction and add the [Zoom IP ranges](https://marketplace.zoom.us/docs/api-reference/webhook-reference/#ip-addresses)
- Deploy CestKiKi app on Azure
## Compilation and Deployment
CestKiKi requires the following components:
- [.NET 6.0 SDK](https://dotnet.microsoft.com/download/dotnet/6.0)
- [Azure Functions Core Tools V4](https://docs.microsoft.com/en-us/azure/azure-functions/functions-run-local#install-the-azure-functions-core-tools)
The solution can be loaded and published as-is to the Azure Function App. A fair amount of unit tests are written as debugging Azure Function live could be tedious.