Operations

Local Run Commands

Database initialization:

python db.py

OpenAI Realtime agent:

python agent_realtime.py start

Sarvam agent:

python agent.py start

Scheduler:

python scheduler.py

Lead fetcher:

python lead_fetcher.py

Dashboard:

streamlit run streamlit_app.py

Docker Compose

docker compose up --build

Dashboard:

http://127.0.0.1:8502

Adding A Lead Manually

INSERT INTO leads (name, phone, source, product_name, city, state)
VALUES ('Rahul Sharma', '<10-digit-mobile>', 'manual', 'carbon cleaning', 'Kolkata', 'West Bengal');

Checking Queue State

Ready leads:

SELECT id, name, phone, source, retry_after, retry_count
FROM leads
WHERE status='new'
ORDER BY created_at ASC;

Active calls:

SELECT id, lead_id, phone, call_room, created_at
FROM calls
WHERE status='calling';

Qualified but not pushed:

SELECT id, lead_id, phone, qualification
FROM calls
WHERE status='called'
ORDER BY created_at ASC;

Manual Call Test

python sip_setup.py call +91XXXXXXXXXX

For a specific lead:

python sip_setup.py call +91XXXXXXXXXX 123

Monitoring Logs

Watch for:

Scheduler started with the expected timezone and calling window
Lead selected and phone normalized
SIP participant creation success
Agent joins the correct ignitech-lead-{id} room
Qualification extraction and DB save
Talking Shops push success or failure
Stale calls being cleaned
Retry scheduling

Common Status Interpretation

Where	Status	Meaning
`leads`	`new`	Waiting for scheduler or retry time
`leads`	`dispatched`	At least one call attempt started
`leads`	`failed`	Invalid or retry limit reached
`calls`	`calling`	Current or stuck attempt
`calls`	`called`	Qualified, ready for CRM push
`calls`	`pushed`	CRM handoff complete
`calls`	`failed`	Attempt failed

Dashboard Usage

The main Streamlit app shows:

Total leads
Awaiting calls
Dispatched leads
Qualified calls
Pushed calls
Failed numbers
Max retries reached
CSV import
Lead and call tables
Qualification JSON viewer

The /minutes page shows successful call minutes and supports optional password protection:

MINUTES_DASHBOARD_PASSWORD=your_password

Getting Started

Architecture

Integrations

Operations

Local Run Commands

Docker Compose

Adding A Lead Manually

Checking Queue State

Manual Call Test

Monitoring Logs

Common Status Interpretation

Dashboard Usage

​Local Run Commands

​Docker Compose

​Adding A Lead Manually

​Checking Queue State

​Manual Call Test

​Monitoring Logs

​Common Status Interpretation

​Dashboard Usage

Local Run Commands

Docker Compose

Adding A Lead Manually

Checking Queue State

Manual Call Test

Monitoring Logs

Common Status Interpretation

Dashboard Usage