TicketFiler Dashboard

Overview

Last run: —

0

Emails Checked

0

Tickets Filed

0

Folders Created

0

Errors

Recent Filings

Time	Ticket #	File	Drive Action	Status
No activity yet

Activity

All filing events, newest first.

All Activity

Time	Ticket #	File	Drive Action	Drive Link	Status
No activity yet

System Logs

Live log output from the cron processor.

Log Output

Auto-refresh

Setup & Configuration

How to deploy and configure TicketFiler on your server.

⚡ Real-Time Push Mode (Gmail → Pub/Sub → Webhook)

01

Complete the File Structure and Service Account steps from the original setup guide, then continue here.

02

In Google Cloud Console → APIs & Services → Library, also enable the Cloud Pub/Sub API.

03

Edit config.php and fill in:
gcp_project_id — your Cloud project ID (shown on the Console dashboard)
pubsub_topic — e.g. projects/my-project/topics/ticketfiler-gmail
webhook_url — e.g. https://yourdomain.com/ticketfiler/webhook.php
webhook_secret — any random string you generate (keep it secret)

04

Run the one-time setup wizard from cPanel Terminal:
php /home/yourusername/ticketfiler/cron/setup_pubsub.php
This creates the Pub/Sub topic, subscription, sets IAM permissions, and registers the Gmail watch automatically.

05

Add a daily cPanel Cron Job to renew the Gmail watch (expires every 7 days):
0 3 * * * /usr/bin/php /home/yourusername/ticketfiler/cron/renew.php >> /dev/null 2>&1

06

Send a test email to your monitored Gmail address with a 5-digit number in the subject and an attachment. It should be filed in Drive within 1–2 seconds.

📁 File Structure

/home/yourusername/
├── private/
│   └── service-account.json    ← Google credentials (NOT in public_html)
│
├── ticketfiler/                ← App root (NOT in public_html)
│   ├── config.php
│   ├── Database.php
│   ├── GoogleServiceAccount.php
│   ├── GmailClient.php
│   ├── DriveClient.php
│   ├── Processor.php           ← Shared processing engine
│   ├── data/                   ← Auto-created
│   ├── logs/                   ← Auto-created
│   └── cron/
│       ├── setup_pubsub.php    ← Run ONCE to configure Pub/Sub
│       └── renew.php           ← Run DAILY via cron
│
└── public_html/
    └── ticketfiler/            ← Dashboard + webhook (web-accessible)
        ├── index.html
        ├── api.php
        └── webhook.php         ← Google POSTs here on new email

Current Config (read-only)

Mode

—

Gmail Address

—

Processed Label

—

Drive Parent Folder ID

—

Ticket Pattern (regex)

—

Filter From Address

Any sender

Pub/Sub Topic

—

Webhook URL

—

Watch Expires

—

Last History ID

—

To change settings, edit config.php on the server and re-upload.