Replace envelope status polling with Connect webhook

.env_example

@@ -27,6 +27,7 @@ CLICKWRAP_ID={CLICKWRAP_ID}
 # UI and BE links
 REACT_APP_DS_RETURN_URL=http://localhost
 REACT_APP_API_BASE_URL=http://localhost/api
+REACT_APP_WEB_SOCKET_LINK=ws://localhost/api/ws/envelopes
 
 # The DS Authentication server
 DS_AUTH_SERVER=https://account-d.docusign.com

.gitignore

@@ -18,3 +18,5 @@ flask_session/
 /node_modules
 /build
 client/node_modules
+
+client/build/

README.MD

@@ -48,10 +48,12 @@ The Insurance Sample App demonstrates the following:
 * **CLICKWRAP_ID** - The ID of clickwrap with dynamic content properties
 * **DS_PRIVATE_KEY** - Private key string, source or path; for instance: /app/id_rsa
 * **REACT_APP_DS_RETURN_URL** - URL where the back end of the application is located (If you run it locally, use `http://localhost:3000`)
+* **REACT_APP_WEB_SOCKET_LINK** - Public base URL used by the Docusign Events webhook (e.g. http://localhost:5000)
 * **REACT_APP_API_BASE_URL** - URL where the front end of the application is located; will be used by Docusign to redirect back after signing ceremony (If you run it locally, use `http://localhost:5001/api`)
 * **DS_AUTH_SERVER** - The Docusign authentication server (for testing purposes, use `https://account-d.docusign.com`)
 * **REACT_APP_DS_DEMO_SERVER** - Link to the Docusign demo server (for testing purposes, use `https://demo.docusign.net`)
 * **REACT_APP_DS_CLICKWRAP_URL** - Link to the hosted clickwrap client (for testing purposes, use `//demo.docusign.net/clickapi/sdk/latest/docusign-click.js`)
+* **MONITOR_CALLBACK_URL** - Link to the Monitor events listener endpoint
 
 ### Installation steps
 
@@ -83,6 +85,24 @@ The Insurance Sample App demonstrates the following:
     cp private.key server/private.key
     ```
 
+### Create a webhook listener (for local development)
+Create a secure URL for your app to receive webhook notifications using ngrok.
+
+#### Install Ngrok Tunnel (for local development)
+```
+https://ngrok.com/download
+```
+#### Run Ngrok Tunnel (for local development)
+```
+ngrok http 5001
+```
+#### Add your secure ngrok URL as an authorized host
+* open `server/.env`
+* Change {MONITOR_CALLBACK_URL} to the URL generated by ngrok in the previous step
+```
+MONITOR_CALLBACK_URL=https://xxxx-xxx-xx-xxx-xxx.ngrok-free.app
+```
+
 **Using installation scripts**
 
 1. Download or clone this repository to your workstation in a new folder named **sample-app-insurance-python**.