Sochen aef5e5283a Initial commit: automated hourly fax sender for insurance claims

Sends doula coverage claims via Telnyx fax API every hour, logs every
attempt, and generates a printable HTML report for HR. Includes both
a Linux CLI with cron scheduling and a Windows GUI (tkinter) that can
be packaged as a portable exe via PyInstaller.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-06 11:36:47 +00:00

2.4 KiB

Raw Blame History

AutoFax

Automated hourly fax sender for insurance claim submissions. Sends your claim via Telnyx's fax API every hour and generates a printable HTML report documenting every attempt and its status -- useful for showing HR or the insurance company that their fax system is rejecting claims.

Quick Start (Windows GUI)

If someone gave you AutoFax.exe on a flash drive:

Double-click AutoFax.exe
Fill in the Telnyx credentials (API Key, Connection ID, From Number)
Set the destination fax number
Click Browse and select your claim PDF
Click Start Hourly Faxing

Config is saved next to the exe, so it remembers your settings. Reports are generated in a reports/ folder next to the exe -- open fax_report.html in a browser and print it for HR.

Building the Windows Executable

On a Windows machine with Python 3.10+ installed:

build_windows.bat

This produces dist/AutoFax.exe -- a single self-contained file you can copy to a flash drive.

Linux/Server Setup (CLI + cron)

1. Telnyx Account

Sign up at portal.telnyx.com
Add a payment method
Go to Messaging > Fax and create a Fax Application
Go to Numbers and purchase a fax-enabled number (~$1/month)
Assign the number to your Fax Application
Go to API Keys and copy your API key

2. Configure

cp .env.example .env
# Edit .env with your Telnyx credentials and the destination fax number

3. Add Your Claim

Place your claim PDF in the claims/ directory:

cp /path/to/your/claim.pdf claims/

4. Install & Start

chmod +x install.sh
./install.sh

This will:

Create a Python virtual environment
Install dependencies
Set up an hourly cron job
Schedule auto-cleanup after 7 days

5. Manual Test

venv/bin/python autofax.py

Reports

After each fax attempt, a printable HTML report is generated at reports/fax_report.html. Open it in a browser and print to PDF for HR. It includes:

Timestamp of every attempt
Delivery status (DELIVERED, FAILED, QUEUED)
Confirmation IDs
Error details for failures

Notifications

Optional push notifications via ntfy. Configure in .env (CLI) or in the GUI settings.

Uninstall (CLI)

./uninstall.sh

Cost

Telnyx pricing: ~$0.007/page + ~$1/month for the phone number. One week of hourly faxes (168 faxes x 5 pages = 840 pages) costs roughly $8-15.

2.4 KiB Raw Blame History