Port of function add_contact_to_webinar, endpoint /zoom_kit_integration/v2/zar2w from WordPress plugin zoom_kit_integration to AWS Lambda functions zoom-kit-add-contact-to-webinar (Node.js) and zoom-kit-add-contact-to-webinar-python (Python)

flowchart TD
    subgraph KitBox["Kit"]
        Rule["Automation Rule<br/>(webhook action)"]
    end

    subgraph AWS["AWS"]
        Lambda["Lambda<br/>zoom-kit-integration"]
        DDB[("DynamoDB<br/>zoom-kit-parameters")]
        SM[("Secrets Manager<br/>zoom-kit-integration/settings")]
        SNSTopic["SNS Topic<br/>failure notifications"]
    end

    subgraph ZoomBox["Zoom"]
        ZoomOAuth["OAuth token<br/>zoom.us/oauth/token"]
        ZoomAPI["Meetings/Webinars API<br/>add registrant"]
    end

    KitAPI["Kit API v4<br/>update subscriber"]
    Admin["Admin<br/>(email)"]

    Rule -->|"1. POST webhook<br/>(subscriber data)"| Lambda
    Lambda -->|"2. get meeting/webinar settings"| DDB
    Lambda -->|"3. get Zoom + Kit credentials"| SM
    Lambda -->|"4. request access token"| ZoomOAuth
    Lambda -->|"5. register subscriber"| ZoomAPI
    Lambda -->|"6. store join URL"| KitAPI
    Lambda -. "on failure: notify" .-> SNSTopic
    SNSTopic -. "email" .-> Admin
    Lambda -->|"7. response 200 / 503"| Rule

Loading

add_contact_to_webinar endpoint is triggered by an automated rule in Kit cms when a subscriber fills a form requesting to join a Zoom webinar or meeting.

Example Event JSON from Kit: { "subscriber": { "first_name": "Jo Clark", "email_address": "jo@email.co.uk", "id": "1234567890" } }

1. Request OAuth token from Zoom (client's Zoom account keys from Secrets Manager) https://zoom.us/oauth/token
2. Add subscriber to the meeting/webinar in Zoom (webinar ID from DynamoDB parameters table) https://api.zoom.us/v2/meetings//registrants OR https://api.zoom.us/v2/webinars//registrants Subscriber's individual Zoom meeting join URL is returned.
3. Store join URL in custom field on subscriber's record in Kit (client's Kit account key from Secrets Manager) https://api.kit.com/v4/subscribers/

Any errors are reported via SNS email to client's admin email address and logged to console (for CloudWatch)