# omichougule/voice-ai-acquisitions-agent architecture

> Architecture diagram of the GitHub repository omichougule/voice-ai-acquisitions-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omichougule/voice-ai-acquisitions-agent
- Repository: https://github.com/omichougule/voice-ai-acquisitions-agent

## Overview

Vanessa is an outbound voice-acquisitions agent. The documented workflow starts with leads in Google Sheets, has n8n initiate and monitor calls, qualifies sellers through a conversational voice agent, and transfers qualified sellers to a human. After the call, transcript analysis produces a structured summary and classification that n8n logs back to Sheets. The repository tree contains a workflow JSON and named call-related entries, but no source excerpts; links below follow the README’s documented relationships rather than inferred implementation details.

Main entry points: [`Lead Aqu_Voice_Agent.json`](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20Aqu_Voice_Agent.json) (n8n orchestration), [`Alex`](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Alex) (Vanessa voice agent), [`Lead List.xlsx`](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20List.xlsx) (Lead list and CRM), [`Transfer_Call`](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Transfer_Call) (Qualified call transfer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lead_workflow["Lead workflow"]
  node_workflow["n8n orchestration"]
end

subgraph group_voice_call["Voice calling"]
  node_voice_agent["Vanessa voice agent"]
  node_telephony["Vapi and Twilio"]
  node_voice_synthesis["ElevenLabs"]
  node_transfer["Qualified call transfer"]
  node_call_end["Call exit handling"]
end

subgraph group_analysis_crm["Analysis and CRM"]
  node_lead_sheet[("Lead list and CRM<br/>[Lead List.xlsx]")]
  node_transcript["Call transcript"]
  node_llm["Transcript analysis"]
  node_call_recording["Call recording"]
end

subgraph group_people["Call participants"]
  node_homeowner(("Homeowner"))
  node_human_agent(("Acquisition agent"))
end

node_workflow -->|"reads leads"| node_lead_sheet
node_workflow -->|"initiates calls"| node_telephony
node_telephony -->|"connects call"| node_homeowner
node_telephony -->|"supports conversation"| node_voice_agent
node_voice_agent -->|"uses voice"| node_voice_synthesis
node_voice_agent -->|"qualifies seller"| node_transfer
node_transfer -->|"transfers call"| node_human_agent
node_voice_agent -->|"handles exit"| node_call_end
node_workflow -->|"monitors call"| node_telephony
node_workflow -->|"obtains transcript"| node_transcript
node_workflow -->|"submits transcript"| node_llm
node_llm -->|"returns summary"| node_workflow
node_workflow -->|"writes classification"| node_lead_sheet
node_workflow -->|"stores recording"| node_call_recording
node_workflow -->|"logs recording URL"| node_lead_sheet

click node_workflow "https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20Aqu_Voice_Agent.json"
click node_lead_sheet "https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20List.xlsx"
click node_voice_agent "https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Alex"
click node_transfer "https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Transfer_Call"
click node_call_end "https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/End%20Call"

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_workflow toneBlue
class node_voice_agent,node_telephony,node_voice_synthesis,node_transfer,node_call_end toneAmber
class node_lead_sheet,node_transcript,node_llm,node_call_recording toneMint
class node_homeowner,node_human_agent toneRose
```

## Components

### Lead workflow

- [n8n orchestration](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20Aqu_Voice_Agent.json): `Lead Aqu_Voice_Agent.json`

### Voice calling

- [Vanessa voice agent](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Alex): `Alex`
- **Vapi and Twilio**
- **ElevenLabs**
- [Qualified call transfer](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Transfer_Call): `Transfer_Call`
- [Call exit handling](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/End%20Call): `End Call`

### Analysis and CRM

- [Lead list and CRM](https://github.com/omichougule/voice-ai-acquisitions-agent/blob/main/Lead%20List.xlsx): `Lead List.xlsx`
- **Call transcript**
- **Transcript analysis**
- **Call recording**

### Call participants

- **Homeowner**
- **Acquisition agent**

## Connections

- n8n orchestration → Lead list and CRM: reads leads
- n8n orchestration → Vapi and Twilio: initiates calls
- Vapi and Twilio → Homeowner: connects call
- Vapi and Twilio → Vanessa voice agent: supports conversation
- Vanessa voice agent → ElevenLabs: uses voice
- Vanessa voice agent → Qualified call transfer: qualifies seller
- Qualified call transfer → Acquisition agent: transfers call
- Vanessa voice agent → Call exit handling: handles exit
- n8n orchestration → Vapi and Twilio: monitors call
- n8n orchestration → Call transcript: obtains transcript
- n8n orchestration → Transcript analysis: submits transcript
- Transcript analysis → n8n orchestration: returns summary
- n8n orchestration → Lead list and CRM: writes classification
- n8n orchestration → Call recording: stores recording
- n8n orchestration → Lead list and CRM: logs recording URL
