sochen/autofax
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Automated hourly fax sender for insurance claims with printable HR reports
1 commit 1 branch 0 tags 100 KiB
Python 90.1%
Shell 7.7%
Batchfile 2.2%
Find a file
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
claims Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
.env.example Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
.gitignore Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
autofax.py Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
build.sh Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
build_windows.bat Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
config.py Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
gui.py Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
install.sh Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
PROJECT.md Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
README.md Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
requirements.txt Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
uninstall.sh Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00

README.md

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:

  1. Double-click AutoFax.exe
  2. Fill in the Telnyx credentials (API Key, Connection ID, From Number)
  3. Set the destination fax number
  4. Click Browse and select your claim PDF
  5. 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

  1. Sign up at portal.telnyx.com
  2. Add a payment method
  3. Go to Messaging > Fax and create a Fax Application
  4. Go to Numbers and purchase a fax-enabled number (~$1/month)
  5. Assign the number to your Fax Application
  6. 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.