shuffle-cracked/functions/triggers/outlook/README.md

Outlook trigger

Makes it possible to trigger a workflow based on an email

Local testing - Same as ../webhook

mv ../main.go
go run main.go hook.go

Deploy gcloud

gcloud functions deploy outlooktrigger --runtime go111 --entry-point Authorization --trigger-http --project shuffler --memory=128 --set-env-vars=FUNCTION_APIKEY=asdasd,CALLBACKURL=shuffler.io,TRIGGERID=test123,WORKFLOW_ID=YOUR_WORKFLOW_ID

Build and deploy

1. Set hook.go line 1 from "package main" to "package function"
2. zip outlooktrigger.tar hook.go
3. Upload to bucket https://console.cloud.google.com/storage/browser/shuffler.appspot.com?project=shuffler
4. Go to the functions https://console.cloud.google.com/functions/list?project=shuffler

How it works (from frontend to backend)

Choose mailfolders

1. Use microsoft graph api to get the folders the user wants to listen to

• Have the user write their primary email (default) or another one
• Have it show the folders for the email with chooseable buttons somehow |inbox |-subinbox |--subsubinbox <-- choose e.g. this one |otherfolder

API: // requestUrl := fmt.Sprintf("https://graph.microsoft.com/v1.0/users/me/mailfolders")

Add callback subscription

2. Make an APIcall to ("https://outlook.office.com/api/v2.0/me/mailfolders('inbox')/messages") with callback url defined as "https://shuffler.io/api/v1/workflows/{key}/email/authorize"

• Should this be set up whenever the user clicked start or when the workflow is created?
• Start click ->

1. Add another cloud function for the item
2. When it's ready, deploy it to authorize
3. Show it as ready

Remove a subscription

• Since everything is already generated above, one would need to
• https://docs.microsoft.com/en-us/graph/api/subscription-delete?view=graph-rest-1.0&tabs=http
• DELETE https://graph.microsoft.com/v1.0/subscriptions/{id}

CREATE - Fixme: LIST all current subscriptions, and stop them if they're towards the same endpoint

• POST /api/v1/workflows/{key}/outlook
• createOutlookSub(resp, request)
• getOutlookSubscriptions(client) // Used to remove all existing for same endpoint
• makeOutlookSubscription(client, folderIds, notificationUrl)
• Add data from ^ to triggerAuth

DELETE

• DELETE /api/v1/workflows/{key}/outlook/{triggerId}
• handleDeleteOutlookSub(resp, request)
• handleOutlookSubRemoval(workflowId, triggerId)