# expertjaved/servicecloudvoicelambdas architecture

> Architecture diagram of the GitHub repository expertjaved/servicecloudvoicelambdas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/expertjaved/servicecloudvoicelambdas
- Repository: https://github.com/expertjaved/servicecloudvoicelambdas

## Overview

ServiceCloudVoiceLambdas is a collection of AWS Lambda functions provisioned for Amazon Connect and used in Service Cloud Voice contact flows. Contact-flow requests dispatch to Salesforce, telephony, and voicemail services; stream and event handlers process contact records, live transcripts, and post-call analysis; voicemail audio is decoded, transcribed, and packaged for follow-up. The graph also preserves the repository’s streaming transcription and health-check subsystems. Edges cite shown calls or indexed imports; unsampled integrations and event wiring are not inferred.

Main entry points: [`invokeTelephonyIntegrationApi/handler.js`](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/handler.js) (Telephony Contact-flow API), [`contactDataSync/handler.js`](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/handler.js) (Transcript Sync), [`invokeSfRestApi/handler.js`](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeSfRestApi/handler.js) (Salesforce Contact-flow API), [`invokeTelephonyIntegrationApi/telephonyIntegrationApi.js`](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/telephonyIntegrationApi.js) (Telephony API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_contact["Contact Events &amp; Sync"]
  node_contact_events["Contact Event Handler<br/>[handler.js]"]
  node_multi_contact_events["Multi-org Event Handler<br/>[handler.js]"]
  node_ctr_sync["Contact Record Sync<br/>[handler.js]"]
  node_contact_sync["Transcript Sync<br/>[handler.js]"]
  node_contact_upload["Transcript Uploader"]
  node_upload_status["Upload Status Lookup"]
end

subgraph group_analysis["Conversation Processing"]
  node_lens_consumer["Contact Lens Consumer<br/>[handler.js]"]
  node_multi_lens["Multi-org Lens Consumer<br/>[handler.js]"]
  node_lens_processor["Live Conversation Processor<br/>[handler.js]"]
  node_postcall["Post-call Analysis<br/>[handler.js]"]
  node_multi_postcall["Multi-org Post-call Analysis<br/>[handler.js]"]
end

subgraph group_integrations["Service Integrations"]
  node_sf_flow["Salesforce Contact-flow API<br/>[handler.js]"]
  node_sf_query["Salesforce Query Engine<br/>[queryEngine.js]"]
  node_telephony_flow["Telephony Contact-flow API<br/>[handler.js]"]
  node_telephony_client["Telephony API Client"]
  node_vfs_flow["Voicemail Integration API<br/>[handler.js]"]
  node_vfs_client["VFS API Client"]
  node_jwt_rotate["JWT Token Rotator<br/>[handler.js]"]
end

subgraph group_voicemail["Voicemail Workflow"]
  node_vm_audio["Voicemail Audio Processor<br/>[handler.js]"]
  node_vm_transcribe["Voicemail Transcriber<br/>[handler.js]"]
  node_vm_package["Voicemail Packager<br/>[handler.js]"]
  node_multi_vm_package["Multi-org Voicemail Packager<br/>[handler.js]"]
end

subgraph group_streaming["Streaming &amp; Diagnostics"]
  node_kvs_service["KVS Streaming Transcriber"]
  node_kvs_retry["Transcription Retry Client"]
  node_segment_writer["Transcribed Segment Writer"]
  node_healthcheck["Health Check<br/>[healthcheck.py]"]
end

node_connect(("Amazon Connect"))

node_connect -.->|"invokes"| node_contact_events
node_connect -.->|"invokes"| node_contact_sync
node_connect -.->|"invokes"| node_sf_flow
node_connect -.->|"invokes"| node_telephony_flow
node_connect -.->|"invokes"| node_vfs_flow
node_multi_contact_events -->|"invokes Lambda"| node_telephony_flow
node_contact_sync -->|"calls"| node_contact_upload
node_contact_sync -->|"calls"| node_upload_status
node_contact_upload -->|"uses API"| node_sf_query
node_sf_flow -->|"uses query"| node_sf_query
node_telephony_flow -->|"dispatches"| node_telephony_client
node_vfs_flow -->|"dispatches"| node_vfs_client
node_postcall -->|"persists signals"| node_sf_flow
node_multi_postcall -->|"persists signals"| node_telephony_client
node_lens_processor -->|"sends events"| node_telephony_client
node_vm_audio -->|"reads KVS audio"| node_connect
node_multi_vm_package -->|"invokes Lambda"| node_telephony_flow
node_kvs_service -->|"uses client"| node_kvs_retry
node_kvs_service -->|"writes segments"| node_segment_writer

click node_contact_events "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/handleContactEvents/handler.js"
click node_multi_contact_events "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgHandleContactEvents/handler.js"
click node_ctr_sync "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/ctrDataSync/handler.js"
click node_contact_sync "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/handler.js"
click node_contact_upload "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/transcriptUploader.js"
click node_upload_status "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/fetchUploadIdsStatus.js"
click node_lens_consumer "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactLensConsumer/handler.js"
click node_multi_lens "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgContactLensConsumer/handler.js"
click node_lens_processor "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactLensProcessor/handler.js"
click node_postcall "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/postCallAnalysisTrigger/handler.js"
click node_multi_postcall "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgPostCallAnalysisTrigger/handler.js"
click node_sf_flow "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeSfRestApi/handler.js"
click node_sf_query "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeSfRestApi/queryEngine.js"
click node_telephony_flow "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/handler.js"
click node_telephony_client "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/telephonyIntegrationApi.js"
click node_vfs_flow "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeVfsIntegrationApi/handler.js"
click node_vfs_client "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeVfsIntegrationApi/vfsIntegrationApi.js"
click node_jwt_rotate "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/jwtTokenRotator/handler.js"
click node_vm_audio "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailAudioProcessing/handler.js"
click node_vm_transcribe "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailTranscribe/handler.js"
click node_vm_package "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailPackaging/handler.js"
click node_multi_vm_package "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgVoiceMailPackaging/handler.js"
click node_kvs_service "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/KVSTranscribeStreamingService.java"
click node_kvs_retry "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingRetryClient.java"
click node_segment_writer "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/TranscribedSegmentWriter.java"
click node_healthcheck "https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/healthCheck/healthcheck.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_contact_events,node_multi_contact_events,node_ctr_sync,node_contact_sync,node_contact_upload,node_upload_status toneBlue
class node_lens_consumer,node_multi_lens,node_lens_processor,node_postcall,node_multi_postcall toneAmber
class node_sf_flow,node_sf_query,node_telephony_flow,node_telephony_client,node_vfs_flow,node_vfs_client,node_jwt_rotate toneMint
class node_vm_audio,node_vm_transcribe,node_vm_package,node_multi_vm_package toneRose
class node_kvs_service,node_kvs_retry,node_segment_writer,node_healthcheck,node_connect toneIndigo
```

## Components

### Contact Events & Sync

- [Contact Event Handler](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/handleContactEvents/handler.js): `handleContactEvents/handler.js`
- [Multi-org Event Handler](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgHandleContactEvents/handler.js): `multiorgHandleContactEvents/handler.js`
- [Contact Record Sync](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/ctrDataSync/handler.js): `ctrDataSync/handler.js`
- [Transcript Sync](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/handler.js): `contactDataSync/handler.js`
- [Transcript Uploader](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/transcriptUploader.js): `contactDataSync/transcriptUploader.js`
- [Upload Status Lookup](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactDataSync/fetchUploadIdsStatus.js): `contactDataSync/fetchUploadIdsStatus.js`

### Conversation Processing

- [Contact Lens Consumer](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactLensConsumer/handler.js): `contactLensConsumer/handler.js`
- [Multi-org Lens Consumer](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgContactLensConsumer/handler.js): `multiorgContactLensConsumer/handler.js`
- [Live Conversation Processor](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/contactLensProcessor/handler.js): `contactLensProcessor/handler.js`
- [Post-call Analysis](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/postCallAnalysisTrigger/handler.js): `postCallAnalysisTrigger/handler.js`
- [Multi-org Post-call Analysis](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgPostCallAnalysisTrigger/handler.js): `multiorgPostCallAnalysisTrigger/handler.js`

### Service Integrations

- [Salesforce Contact-flow API](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeSfRestApi/handler.js): `invokeSfRestApi/handler.js`
- [Salesforce Query Engine](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeSfRestApi/queryEngine.js): `invokeSfRestApi/queryEngine.js`
- [Telephony Contact-flow API](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/handler.js): `invokeTelephonyIntegrationApi/handler.js`
- [Telephony API Client](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeTelephonyIntegrationApi/telephonyIntegrationApi.js): `invokeTelephonyIntegrationApi/telephonyIntegrationApi.js`
- [Voicemail Integration API](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeVfsIntegrationApi/handler.js): `invokeVfsIntegrationApi/handler.js`
- [VFS API Client](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/invokeVfsIntegrationApi/vfsIntegrationApi.js): `invokeVfsIntegrationApi/vfsIntegrationApi.js`
- [JWT Token Rotator](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/jwtTokenRotator/handler.js): `jwtTokenRotator/handler.js`

### Voicemail Workflow

- [Voicemail Audio Processor](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailAudioProcessing/handler.js): `voiceMailAudioProcessing/handler.js`
- [Voicemail Transcriber](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailTranscribe/handler.js): `voiceMailTranscribe/handler.js`
- [Voicemail Packager](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/voiceMailPackaging/handler.js): `voiceMailPackaging/handler.js`
- [Multi-org Voicemail Packager](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/multiorgVoiceMailPackaging/handler.js): `multiorgVoiceMailPackaging/handler.js`

### Streaming & Diagnostics

- [KVS Streaming Transcriber](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/KVSTranscribeStreamingService.java): `kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/KVSTranscribeStreamingService.java`
- [Transcription Retry Client](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingRetryClient.java): `kvsTranscriber/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingRetryClient.java`
- [Transcribed Segment Writer](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/TranscribedSegmentWriter.java): `kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/TranscribedSegmentWriter.java`
- [Health Check](https://github.com/expertjaved/servicecloudvoicelambdas/blob/master/healthCheck/healthcheck.py): `healthCheck/healthcheck.py`

### Other components

- **Amazon Connect**

## Connections

- Amazon Connect → Contact Event Handler: invokes
- Amazon Connect → Transcript Sync: invokes
- Amazon Connect → Salesforce Contact-flow API: invokes
- Amazon Connect → Telephony Contact-flow API: invokes
- Amazon Connect → Voicemail Integration API: invokes
- Multi-org Event Handler → Telephony Contact-flow API: invokes Lambda (evidence: `multiorgHandleContactEvents/handler.js`)
- Transcript Sync → Transcript Uploader: calls (evidence: `contactDataSync/handler.js`)
- Transcript Sync → Upload Status Lookup: calls (evidence: `contactDataSync/handler.js`)
- Transcript Uploader → Salesforce Query Engine: uses API (evidence: `contactDataSync/transcriptUploader.js`)
- Salesforce Contact-flow API → Salesforce Query Engine: uses query (evidence: `invokeSfRestApi/queryEngine.js`)
- Telephony Contact-flow API → Telephony API Client: dispatches (evidence: `invokeTelephonyIntegrationApi/handler.js`)
- Voicemail Integration API → VFS API Client: dispatches (evidence: `invokeVfsIntegrationApi/handler.js`)
- Post-call Analysis → Salesforce Contact-flow API: persists signals (evidence: `postCallAnalysisTrigger/handler.js`)
- Multi-org Post-call Analysis → Telephony API Client: persists signals (evidence: `multiorgPostCallAnalysisTrigger/handler.js`)
- Live Conversation Processor → Telephony API Client: sends events (evidence: `contactLensProcessor/handler.js`)
- Voicemail Audio Processor → Amazon Connect: reads KVS audio (evidence: `voiceMailAudioProcessing/handler.js`)
- Multi-org Voicemail Packager → Telephony Contact-flow API: invokes Lambda (evidence: `multiorgVoiceMailPackaging/handler.js`)
- KVS Streaming Transcriber → Transcription Retry Client: uses client (evidence: `kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/KVSTranscribeStreamingService.java`)
- KVS Streaming Transcriber → Transcribed Segment Writer: writes segments (evidence: `kvsTranscriber/src/main/java/com/amazonaws/kvstranscribestreaming/KVSTranscribeStreamingService.java`)
