Dashboard

Replies from customers Customers who wrote back to the sending number. Each one is emailed to you with a button that opens a chat with them on your normal WhatsApp, and they get one automatic message a day pointing to your main WhatsApp.

How it works
On a customer's account page, next to each invoice and on each quote, a WhatsApp button appears (only once this is switched on). They confirm the number, and the same PDF they could download is sent to the WhatsApp number saved on their own account, as an approved WhatsApp template message. Only their own documents, only to their own number (which must include the country code), at most 5 a day, never twice within 90 seconds. Nothing is shown to customers until the set-up below is finished.

Before you start: the number. A number that is already used in a phone's WhatsApp or WhatsApp Business app cannot simply be connected to the Cloud API: Meta's normal route requires deleting that WhatsApp account (its chat history is lost). The cleanest way is a separate number just for sending (a cheap SIM that can receive one SMS or call), with your usual number written in the message so customers know where to reply.

Set-up (once)

1. Run migrations/0091_whatsapp_log.sql and migrations/0092_whatsapp_inbound.sql in phpMyAdmin.
2. In Meta's developer console create an app with the WhatsApp product, add the sending number to your WhatsApp Business Account, and verify your business.
3. Create two Utility templates with a PDF document header, named savn_invoice and savn_quote, with two text variables (first name, document reference). The exact wording is in the upgrade notes. Wait for Meta to approve them.
4. Create a system user with a permanent access token (permissions: whatsapp_business_messaging and whatsapp_business_management).
5. In cPanel File Manager create whatsapp_credentials.php in the folder above public_html (never inside it) with your token, phone number ID, app secret and a long random verify token (the template for this file is in the upgrade notes).
6. In Meta's webhook settings use the callback URL https://thesavietnamshippingcompany.co.za/api/whatsapp_webhook.php, your verify token, and subscribe to the messages field. This is how delivery results (delivered, read, failed) come back to this page.
7. Reload this page: the warnings above should be gone. Then send yourself a test invoice from your own account page.

Paste an email

Reader key Save key

One-time setup
1. Run 0121_travel_inbox.sql in phpMyAdmin.
2. Upload travel_mail_in.php and set its permission to 755 in cPanel File Manager.
3. cPanel > Email Filters > chris@thesavietnamshippingcompany.co.za > Create a filter. Rule: Any Header contains @. Action: Pipe to a program, public_html/travel_mail_in.php. Mail still arrives in the inbox as normal.
4. Paste the reader key above (super admin).
A second address (Gmail): in Gmail > Settings > Forwarding, add chris@thesavietnamshippingcompany.co.za, then confirm it with the code Gmail sends there. Then forward only travel mail with a Gmail filter (Create filter, words such as flight OR itinerary OR booking OR hotel, Forward to). The Mailbox column shows which address each email came from.
5. Run 0122_travel_inbox_mailbox.sql in phpMyAdmin (adds the Mailbox column).
Only emails that mention travel words (flight, itinerary, booking, hotel and so on) are sent to the AI reader. Attachments such as PDF tickets are not read.

How it works
Once a flight in one of your PNRs should have landed, the site asks Aviationstack once for its result and stores it. On time means it arrived within 15 minutes of schedule. A cancelled or diverted flight counts as not on time. A flight that has not finished yet is asked about again 2 hours later, up to 5 times. The free plan allows 100 requests a month and cannot look back more than a day or two, so each flight is asked about soon after it lands. The diary stops by itself at 90 requests a month, and emails you if it has to stop.

Set-up (once)

1. Run migrations/0090_flight_history.sql in phpMyAdmin.
2. In cPanel File Manager, create a file named aviationstack_credentials.php in the folder above public_html (never inside it), containing:
   <?php
define('AVIATIONSTACK_KEY', 'paste your key here');
3. Add a cron job in cPanel (every 2 hours): 15 */2 * * * [PHP path from your cron list, as for the other jobs] cron_flight_history.php (see CRON_SETUP.md) Your daily 8am job also tries once a day as a safety net.

Held emails Every email the site tried to send, other than invoices, quotes, sign-in codes and mail to you or your team, waits here. Send selectedDiscard selected

All Payment reminders Shipment updates Send selectedDismiss selected

1. Run migrations/0086_payfast_payments.sql in phpMyAdmin (once).
2. In cPanel File Manager, create payfast_credentials.php one folder above public_html (not inside it), using the template below. Start with your sandbox details.
3. Switch card payments ON above and pay a test invoice with PayFast's sandbox test card. It should become paid and email a receipt.
4. When you are happy, put your live details in the file and change 'sandbox' to 'live'. Make one small real payment first.

<?php
define('PAYFAST_MODE', 'sandbox');          // 'sandbox' to test, 'live' for real money
define('PAYFAST_MERCHANT_ID',  'your merchant id');
define('PAYFAST_MERCHANT_KEY', 'your merchant key');
define('PAYFAST_PASSPHRASE',   'your passphrase');   // set the same one in your PayFast account

When	Invoice	Invoice amount	Card fee	Charged	Result	Note
Loading…