piazza-poster crossposts all posts and announcements from Piazza into Discord, with a button to view the original post in Piazza. Announcements are posted to an announcements channel, and other posts are posted to a feed channel.
Also see ed-poster and canvas-poster.
piazza-poster runs on Cloudflare Workers for free.
You will need:
- A Cloudflare account
- Node.js installed locally
- A Discord server, where you have Manage Webhook permissions
First, clone this repository and run pnpm i. (If pnpm isn't installed, run corepack enable first.) Copy wrangler.example.toml to wrangler.toml and courses.example.json to courses.json.
Run pnpm set-email and type in your Piazza account email when prompted. You may be prompted to log in to your Cloudflare account first. Then, run pnpm set-password and type in your Piazza account password.
Run pnpm create-kv, then copy the provided binding ID into wrangler.toml.
In courses.json, set the courseID to a unique string for the course, and set piazzaID to the generated course ID in the Piazza URL.
Use Webhook Creator to create a webhook in the announcements channel and get the URL. (Don't create the webhook in Discord settings, use this tool instead.) Copy the URL it gives you and set it as announcementWebhook in courses.json.
Do the same for the feed channel, setting the second webhook's url as feedWebhook.
When you're done, run pnpm run deploy. piazza-poster will now check every minute for new Piazza posts and send them to the appropriate Discord channel.