diff --git a/README.md b/README.md
index ebae0f9..898267f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,14 @@
 # bitbot-modules
 
 custom modules for tildebot, our bitbot instance for the tildeverse
+
+rough diagram of webhook integrations
+```mermaid
+graph LR
+    A[azuracast] -- webhook --> B[nginx] 
+    B <--> G[bitbot http listener]
+    C[gitea] -- webhook --> B
+    D[github] -- webhook --> B
+    G --> E[Bitbot async thread]
+    E --> F[Your configured channel]
+```
\ No newline at end of file