Registro delle modifiche

0.13.1062: Relazioni con i clienti e promemoria automatici per gli appuntamenti

9 ottobre 2026

Questa versione aggiunge a Niwa AI schede dei clienti e processi per la gestione dei rapporti. I promemoria degli appuntamenti usano i canali WhatsApp ed email collegati senza chiedere ai clienti di confermare la presenza. Quando un cliente cancella, Niwa può offrire l’appuntamento disponibile a un cliente adatto con una prenotazione futura, mantenendo quella prenotazione finché lo spostamento non viene accettato.

La pagina Relazioni con i clienti di Niwa contiene il profilo interno di ogni cliente, compleanno, lingua preferita, campi aggiuntivi, diario con date, appuntamenti, messaggi e offerte di orari anticipati. Il personale può aggiungere note e inviare messaggi WhatsApp o email. Le conversazioni sul sito e sui canali privati associati vengono registrate nella scheda del cliente. Le note interne sono escluse dallo strumento di prenotazione per il cliente.

Processi automatici per le prenotazioni

Con le prenotazioni attive, i promemoria e le offerte di posti liberi nello stesso giorno sono attivi per impostazione predefinita. Si usa il permesso di contatto esistente; la revoca del permesso o la sospensione di un cliente impedisce l’invio proattivo. Non vengono aggiunti nuovi passaggi di consenso o di conferma della presenza.

• Promemoria: uno per ogni inizio di appuntamento e canale collegato, normalmente 24 ore prima. Vengono usati sia email sia WhatsApp quando disponibili. Per una prenotazione con poco preavviso, il promemoria parte due ore prima oppure a metà dell’intervallo tra creazione e appuntamento se la prenotazione avviene meno di quattro ore prima. Le prenotazioni mantengono lo stato confermato esistente.
• Cancellazioni: il cliente autenticato richiede esplicitamente la cancellazione tramite la propria sessione sul sito o il canale privato associato. Lo strumento verifica la titolarità, l’orario di inizio attuale e lo stato dell’appuntamento. Attiva il processo persistente di ricerca dei posti liberi.
• Offerte di posti liberi: l’orario cancellato di oggi viene offerto a un cliente con una prenotazione futura confermata per lo stesso servizio e professionista, entro la tolleranza configurata per l’orario. Valori predefiniti: prossimi 30 giorni, tolleranza di 90 minuti, preavviso di 60 minuti e offerta valida 20 minuti. Ogni cliente riceve al massimo una di queste offerte al giorno. La scadenza o il rifiuto consentono di valutare un altro candidato.
• Accettazione: solo un’accettazione esplicita sposta la prenotazione esistente. Un blocco MySQL sul membro del team, una transazione, un blocco sulla riga dell’offerta, blocchi sulle righe degli appuntamenti e una nuova verifica della disponibilità impediscono di perdere l’appuntamento originale se l’orario è già stato occupato. Lo spostamento, la voce di cronologia e la coda di invio a Calendar vengono confermati insieme nella transazione. L’integrazione Google Calendar esistente aggiorna l’evento della prenotazione.
• Ricontatti dopo il servizio e messaggi di compleanno: configurabili dal titolare e inizialmente disattivati. I ricontatti richiedono un servizio completato registrato e nessuna prenotazione successiva attiva o completata. L’intervallo configurato separa anche i ricontatti successivi. I messaggi di compleanno richiedono una data MM-DD nota e usano solo un regalo configurato esplicitamente. Niwa genera il testo dai fatti registrati e dalla lingua del cliente, senza instradamento basato su parole chiave della lingua.

Strumenti e identità

La chat di amministrazione attendibile, Telegram e MCP condividono crm_workflows_get, crm_workflows_configure, crm_contacts_list, crm_contact_get, crm_contact_update, crm_journal_add, crm_message_send e crm_identity_link. La configurazione dei processi usa la stessa operazione del modulo delle impostazioni. La scrittura nel diario e i messaggi in uscita richiedono identificativi di richiesta stabili.

Gli agenti del negozio e dei canali privati del cliente ricevono solo customer_relationship: elencare le proprie prenotazioni e offerte, cancellare, accettare o rifiutare un’offerta, avviare la ricerca di un sostituto, registrare la dichiarazione del cliente stesso, impostare preferenze o collegare un token cliente firmato. Non possono consultare la scheda di un altro cliente né scegliere un destinatario da contattare. Le modifiche richiedono una citazione dal messaggio attuale del cliente; il modello interpreta l’intenzione in modo semantico.

La titolarità su WhatsApp usa il numero completo verificato del messaggio in ingresso e richiede una corrispondenza univoca salvata. Chat di gruppo, LID non risolti e numeri ambigui non ottengono accesso. Le identità Facebook/Instagram richiedono un’associazione verificata dal titolare o il link firmato del cliente. I commenti pubblici non possono accedere alle prenotazioni. Un link firmato compare nella scheda del cliente gestita dal titolare e nei promemoria generati, aprendo una sessione browser verificata; mantienilo riservato a quel cliente.

Invio e recupero

La funzione riutilizza la coda persistente Meta esistente nella corsia crm , la coda di uscita WhatsApp nativa, SMTP/FluentSMTP configurato e il relay WhatsApp Cloud. Registra niwa_relationship_tick ogni minuto e un evento di attivazione in caso di cancellazione; entrambi partecipano al sistema di esecuzione in background gestito da Niwa. Un processo interrotto viene recuperato tramite il controllo successivo e una concessione temporanea sulla coda che scade, non soltanto tramite un blocco finally . La titolarità della coda scade dopo 600 secondi. Un ciclo avvia al massimo tre compiti e smette di avviare nuovo lavoro dopo 45 secondi; una singola chiamata al fornitore o al modello può durare di più.

I messaggi preparati e la scelta del trasporto vengono salvati prima dell’invio. Gli identificativi del gateway e delle richieste Cloud rimangono stabili nei tentativi successivi. SMTP non dispone di una chiave di idempotenza del fornitore, quindi un invio interrotto o fallito viene contrassegnato come uncertain per la verifica, anziché essere ripetuto alla cieca. Le ricevute di accodamento o accettazione non confermano la consegna. Le impostazioni dei processi e ogni scheda cliente mostrano gli stati in attesa, fallito, saltato e incerto. I registri completati della coda CRM vengono conservati per evitare duplicati e rimossi con l’eliminazione del contatto.

WhatsApp Cloud richiede un modello approvato al di fuori della finestra di assistenza clienti. Niwa prepara modelli numerati localizzati e li invia tramite il relay configurato; l’approvazione effettiva di Meta resta esterna e viene verificata dal trasporto prima dell’invio. Si possono fornire associazioni approvate esistenti. Il relay deve includere il supporto ai modelli numerati e il flag dei processi di relazione con i clienti; installare solo il client non aggiorna un relay centrale precedente. I messaggi CRM manuali a testo libero richiedono ancora la finestra di risposta; l’invio di uno specifico modello approvato usa lo strumento WhatsApp Cloud dedicato. La ricevuta di un modello registra nome, lingua e parametri, anziché presentare come messaggio inviato una bozza a testo libero non spedita.

Verifica

tests/relationship-integration.php viene eseguito tramite WP-CLI con tabelle MySQL temporanee, il codice reale di appuntamenti, archivio e strumenti, e confini isolati per IA, email, WhatsApp e Calendar. Verifica titolarità, cancellazione, selezione dei candidati, ripristino dell’accettazione, invio persistente, richieste ripetute, arresto dei processi, modelli, sospensioni e programmazione delle relazioni senza contattare clienti reali. tests/meta-whatsapp-cloud.php copre il confine del fornitore Cloud con risposte HTTP di prova. I controlli nel browser usano l’ambiente WordPress locale isolato per la persistenza di profili, diario e impostazioni, il controllo degli accessi e il layout desktop e mobile. Queste verifiche non attestano la consegna a un cliente reale né l’approvazione del fornitore in produzione.