Building an AI Outbound Calling Agent on Google Voice with Python, Groq and FastAPI

Описание и применение

Автоматизированный голосовой агент, использующий Google Voice в браузере, реализует надежное определение состояния звонка, маршрутизацию аудио, распознавание голосовых сообщений и управление через веб‑консоль, обеспечивая полный цикл исходящих звонков.

Задача

Automating outbound calls via Google Voice in a browser requires reliable call state detection, audio routing, and voicemail handling, which are hard because browsers lack native call state events and the DOM is noisy.

Результат

The agent reliably places outbound calls via Google Voice, speaks scripted lines, engages in real‑time conversation, detects voicemail, logs all events, and can be managed through a web console, achieving a level of automation not possible with standard telephony APIs.

Рабочий процесс

• Load .env, dialer_config.json, contacts and CRM data
• Run preflight checks for Groq, Chrome profile, contacts, callback number and audio devices
• Launch Google Voice with a persistent Chrome profile (Selenium + webdriver‑manager)
• Prepare opening‑line and voicemail audio
• Dial one contact
• Poll detect_call_state() until call is connected, voicemail, no answer, ended or failed
• Start conversation loop only after confirmed connection
• Watch for voicemail in early connected window and hand off if confirmed
• Save call log, transcript, recording, CRM update and call archive
• Wait out a cooldown, then move to next contact

Доказательства

A browser doesn't. You read the page (the DOM), and the page is noisy: banners from the last call stay on screen, call controls can show up before anyone picks up, and voicemail cues can appear while the phone is still ringing.

Источник

The most important logic is in src/google_voice.py. It's a conservative state gate: ...

Источник

Once a call is confirmed connected, conversation_loop.py takes over: ...

Источник

The README describes this runtime flow: ...

Источник

The agent is meant to run on a Windows desktop, so: ...

Источник