WhatsApp Business Cloud API (Meta)

Collegamento ufficiale con le API di Meta per mandare davvero i messaggi/PDF su WhatsApp (promemoria delle attivita' e report giornaliero qui sotto). Vanno creati una volta sola, dal Meta Business Manager, un'app WhatsApp Business con un numero verificato, un token di accesso permanente (System User) e due "modelli di messaggio" (template) approvati da Meta con questo identico testo:

• Template promemoria (categoria Utility): corpo del messaggio con un solo segnaposto, es. {{1}} — il programma ci manda dentro tutto il testo del promemoria.
• Template report (categoria Utility): intestazione di tipo "Documento" (per allegare il PDF) e corpo con un segnaposto, es. Attivita' pianificate per domani ({{1}}).

L'approvazione dei template da parte di Meta puo' richiedere da pochi minuti a qualche giorno. Finche' non sono approvati, gli invii falliranno e verra' segnalato nel dettaglio qui sotto (o nel registro modifiche).

La verifica qui sopra controlla solo che token e Phone Number ID siano validi, non manda nessun messaggio. Per essere sicuri che l'invio vero e proprio funzioni (compreso il template promemoria), manda un messaggio di prova a un numero reale:

Webhook WhatsApp (richiesto da Meta per andare "Live")

Meta richiede un indirizzo webhook configurato e verificato prima di poter portare l'app in modalita' Live, anche se per ora Saeg Planning manda solo messaggi (non ne riceve). Serve un indirizzo pubblico su internet con un vero certificato HTTPS che punti a questo programma: il modo piu' semplice, se hai gia' Tailscale installato su questo PC, e' Tailscale Funnel - basta il comando tailscale funnel 3210 per ottenere un indirizzo pubblico che punta qui.

Esempio: se Tailscale Funnel ti da' l'indirizzo https://il-tuo-pc.tuo-tailnet.ts.net, su Meta for Developers (Configurazione di base > WhatsApp > Configurazione webhook) inserisci come "URL di callback" https://il-tuo-pc.tuo-tailnet.ts.net/webhook/whatsapp e come "Verify Token" il valore qui sopra, poi premi "Verifica e salva".

Messaggi WhatsApp ricevuti

Ultimi messaggi arrivati al numero aziendale tramite il webhook qui sopra. Se il mittente e' un operatore con il numero salvato nella sua scheda, il messaggio viene passato anche all'assistente IA (se configurato) per capire se e' una richiesta di appuntamento da proporre nel planning: eventuali proposte compaiono nella scheda Assistente IA.

Report giornaliero su WhatsApp

Ogni giorno, all'orario scelto, il programma prepara un PDF con il programma di lavoro del giorno dopo e lo manda al numero WhatsApp indicato tramite il collegamento Meta qui sopra.

Assistente IA (Claude / Anthropic)

Serve una chiave API personale, ottenibile su console.anthropic.com. L'uso ha un piccolo costo variabile legato alle richieste (in genere pochi euro al mese).

Lettura email → planning (automazione IA)

Legge periodicamente una casella di posta (via IMAP) e propone nel planning gli appuntamenti che trova nelle email, in attesa che tu li confermi dalla scheda "Assistente IA". Funziona con qualsiasi account che permetta l'accesso IMAP (anche Gmail o Outlook con una "password per le app"). Richiede anche la chiave IA qui sopra.

Cartella cantieri (rapportini)

Il percorso, su questo PC/server, della cartella che contiene una sottocartella per ogni cantiere (con dentro "FOTO" e i PDF dei rapportini di intervento). Serve al pulsante "Aggiorna da rapportini" nel Planning per confrontare il giorno scelto con quello che i tecnici hanno davvero segnato. Ricorda di compilare il "Codice cartella" nell'anagrafica di ogni cantiere (Anagrafiche → Cantieri), cosi' la scansione sa a quale cantiere appartiene ogni rapportino.

Cartella anagrafiche (clienti/cantieri dal gestionale)

Il percorso, su questo PC/server, della cartella dove l'amministrazione esporta i due file "Clienti.xlsx" e "Cantieri.xlsx" dal gestionale. Il pulsante "Aggiorna da gestionale" (in Anagrafiche) li legge da qui per creare/aggiornare clienti e cantieri.

Copia dei backup fuori da questo PC

Ogni giorno il programma salva da solo una copia di sicurezza dei dati in una cartella su questo PC, prima di applicare qualsiasi modifica. Questo pero' non basta a proteggere da un guasto hardware di QUESTO PC (disco rotto, furto, incendio...): serve anche una copia fuori di qui. Indica qui il percorso di una cartella gia' sincronizzata con un servizio cloud, oppure di una cartella di rete su un NAS o su un altro PC, oppure sorvegliata dal vostro backup interno: il programma ci copiera' automaticamente una copia del backup del giorno.

Da qui puoi ripristinare i dati a uno di questi momenti, ad esempio dopo un errore o una perdita di dati. Il ripristino salva comunque prima una copia di quello che c'era, quindi e' sempre recuperabile anche se sbagli backup.

Ore giornaliere di riferimento

Le ore che un collaboratore dovrebbe fare in una giornata piena. Vengono usate per segnalare, quando confermate le proposte da "Aggiorna da rapportini", chi non arriva a questo numero (o lo supera) in una giornata, e per calcolare la percentuale di utilizzo nella Dashboard.

Registro modifiche