ADV.click CRM

Crea un nuovo lead nel CRM con i campi consentiti. Da usare quando l'utente comunica un nuovo contatto, dopo aver verificato con list_leads che email o telefono non siano già presenti. Restituisce il lead creato con il suo ID. Effetti: modifica dati; ogni chiamata crea un nuovo lead e le regole di assegnazione, notifiche e automazioni configurate possono attivarsi. Per modificare un lead esistente usa invece update_lead.

create_lead

Genera un report di marketing del profilo su un intervallo di date, con le fonti dati scelte (Google Ads, Meta, Analytics, SEO, lead e altre). Da usare quando l'utente chiede un report complessivo di un periodo. Senza conferma restituisce un'anteprima con i crediti stimati; con conferma avvia la generazione e restituisce report_id, da controllare con get_report_status. Effetti: consuma crediti; richiede conferma con valore GENERA. Per il report di una singola campagna usa invece create_campaign_report.

create_report

Crea una campagna pubblicitaria conversazionale (ChatGPT Ads) in pausa sull'account collegato al profilo, con annunci, budget, zona e piattaforme indicati; la campagna non spende finché non viene attivata. Da usare quando l'utente vuole preparare una nuova campagna di questo tipo. Senza conferma restituisce un'anteprima; con conferma restituisce l'ID della campagna creata. Effetti: modifica dati su un servizio esterno; richiede conferma con valore CREA.

create_paused_ad_campaign

Aggiunge una task a un piano settimanale non ancora pubblicato, assegnandola a un operatore o a un reparto. Da usare quando l'utente vuole pianificare un'attività e conosce il piano di destinazione. Restituisce la task creata. Effetti: modifica dati; ogni chiamata crea una nuova task. Per registrare l'avanzamento di una task esistente usa invece record_task_progress.

create_task

Individua le campagne CRM con spesa pubblicitaria nulla nel periodo e le disattiva nel CRM. Da usare quando si vuole ripulire l'elenco campagne da quelle inattive. Senza conferma restituisce l'elenco delle campagne che verrebbero disattivate; con conferma restituisce quelle disattivate. Effetti: modifica dati nel CRM, le piattaforme pubblicitarie restano invariate; richiede conferma con valore DISATTIVA.

deactivate_unspent_campaigns

Disattiva un QR code: il redirect pubblico smette di funzionare, il record resta nel CRM con active=false e può essere riattivato. Da usare quando un QR non deve più essere utilizzato. Senza conferma restituisce un'anteprima con il QR interessato; con conferma restituisce il QR disattivato. Effetti: modifica dati; richiede conferma con valore ELIMINA. Per riattivarlo usa invece update_qr_code con active=true.

deactivate_qr_code

Elenca i collegamenti del profilo con servizi esterni come Google Ads e Meta. Da usare quando si deve capire quali fonti dati sono disponibili per report e sincronizzazioni. Restituisce per ogni servizio lo stato del collegamento (attivo, scaduto, assente), senza token di accesso. Effetti: sola lettura. Per lo stato delle importazioni e delle attività pianificate usa invece get_integrations_status.

list_connected_accounts

Elenca gli eventi del calendario del CRM in un intervallo di date. Da usare quando l'utente consulta appuntamenti e agenda. Restituisce titolo, orario, operatore e cliente collegato di ogni evento. Effetti: sola lettura. Per le task assegnate usa invece list_my_tasks.

list_calendar_events

Elenca gli operatori del profilo. Da usare quando serve l'operatore_id richiesto da create_lead, update_lead o create_task. Restituisce ID, nome, ruolo e stato di ogni operatore. Effetti: sola lettura. Per il personale del punto vendita usa invece list_staff_members.

list_operators

Elenca gli stati configurati per i lead, ad esempio nuovo, contattato, vinto. Da usare quando serve lo stato_id richiesto da list_leads, update_lead e change_lead_status. Restituisce ID, nome e ordine di ogni stato. Effetti: sola lettura.

list_lead_statuses

Elenca i QR code del profilo. Da usare quando si deve trovare l'ID di un QR prima di modificarlo o disattivarlo, o consultarne le scansioni. Restituisce ID, etichetta, URL di destinazione, stato attivo e scansioni. Effetti: sola lettura.

list_qr_codes

Elenca cartelle e file presenti nell'archivio documenti del profilo. Da usare quando si cerca un documento o un'immagine caricata nel CRM. Restituisce nome, dimensione e data di ogni elemento. Effetti: sola lettura.

list_storage_files

Cerca ed elenca i lead del profilo, con paginazione. Da usare quando si deve trovare un lead per nome, email o telefono, o filtrare i lead per stato. Restituisce per ogni lead ID, dati di contatto e stato. Effetti: sola lettura. Per tutti i campi di un singolo lead usa invece get_lead.

list_leads

Elenca i prodotti del catalogo del profilo. Da usare quando l'utente chiede informazioni sul catalogo o prepara un'offerta. Restituisce nome, codice, prezzo e stato di ogni prodotto. Effetti: sola lettura.

list_products

Elenca i report del profilo. Da usare quando si deve ritrovare un report già generato prima di leggerlo o esportarlo. Restituisce ID, tipo, periodo, stato e data di creazione, escluso il file del report. Effetti: sola lettura, non consuma crediti.

list_reports

Elenca il personale registrato nel modulo Orari e turni. Da usare quando si deve sapere chi fa parte del personale del punto vendita. Restituisce nome, ruolo e stato di ogni persona, esclusi i turni pianificati. Effetti: sola lettura. Per l'elenco degli utenti del CRM usa invece list_operators.

list_staff_members

Elenca le assegnazioni di un lead agli operatori, attive e passate. Da usare quando si deve sapere chi segue un lead e da quando. Restituisce operatore, date e regola di assegnazione applicata. Effetti: sola lettura.

list_lead_assignments

Elenca gli eventi recenti del profilo: attività pianificate eseguite, automazioni e modifiche registrate in audit. Da usare quando si deve ricostruire cosa è successo nel CRM e quando. Restituisce data, categoria e descrizione di ogni evento. Effetti: sola lettura.

list_activity_events

Elenca le campagne CRM del profilo. Da usare quando serve il campagna_id richiesto da report e QR code o una panoramica delle campagne. Restituisce ID, nome, piattaforma collegata, stato e spesa. Effetti: sola lettura.

list_campaigns

Elenca le parole chiave monitorate dal modulo SEO del profilo. Da usare quando si analizza il posizionamento del sito nei motori di ricerca. Restituisce per ogni parola chiave posizione attuale e variazione. Effetti: sola lettura.

list_seo_keywords

Elenca le task assegnate all'operatore collegato. Da usare quando l'operatore pianifica la giornata o deve trovare l'instance_id da passare a record_task_progress. Restituisce titolo, scadenza, avanzamento e stato di ogni task. Effetti: sola lettura. Per gli appuntamenti usa invece list_calendar_events.

list_my_tasks

Elenca le notifiche dell'operatore collegato. Da usare quando l'operatore vuole sapere cosa richiede attenzione. Restituisce tipo, testo, data e stato di lettura di ogni notifica. Effetti: sola lettura; lo stato di lettura resta invariato.

list_notifications

Elenca le regole di automazione del profilo. Da usare quando si vuole capire quali azioni automatiche partono, ad esempio, al cambio di stato di un lead. Restituisce evento di attivazione, condizioni, azioni e stato attivo di ogni regola. Effetti: sola lettura.

list_automation_rules

Elenca le ultime richieste HTTP registrate per il profilo collegato. Da usare quando si devono diagnosticare errori o lentezze puntuali del CRM. Restituisce per ogni richiesta percorso, esito e tempo di risposta. Effetti: sola lettura. Per dati aggregati usa invece get_api_usage_summary.

list_recent_api_requests

Esporta un report pronto in formato pdf (documento impaginato) oppure json (tutti i dati del report, per elaborazioni successive). Da usare quando l'utente vuole il file del report. Se format è vuoto restituisce i formati disponibili; senza conferma restituisce un'anteprima; con conferma restituisce un link di download con scadenza. Effetti: consuma 1 credito per esportazione; richiede conferma con valore ESPORTA; legge i dati già salvati e non scrive su Google Ads o Meta.

export_report

Legge gli indicatori principali della dashboard del profilo. Da usare quando l'utente chiede una panoramica rapida dell'attività commerciale. Restituisce numero di clienti, lead ricevuti oggi e ricontatti in scadenza. Effetti: sola lettura. Per l'elenco dei lead usa invece list_leads.

get_dashboard_kpis

Legge il conteggio dei passaggi pedonali rilevati dai sensori del punto vendita. Da usare quando si deve analizzare l'afflusso al punto vendita in un periodo. Restituisce i passaggi per giorno e fascia oraria, con finestra che termina il giorno precedente. Effetti: sola lettura.

get_foot_traffic_stats

Legge tutti i campi CRM di un singolo lead. Da usare quando si conosce l'ID del lead e servono i dati completi, ad esempio prima di aggiornarlo. Restituisce contatti, stato, operatore, importi, note e data del prossimo ricontatto. Effetti: sola lettura. Per cercare un lead usa invece list_leads.

get_lead

Legge i dati anagrafici dell'azienda collegata. Da usare quando serve sapere su quale azienda si sta operando o recuperarne i contatti. Restituisce ragione sociale, contatti e identificativo del profilo. Effetti: sola lettura. Per la configurazione dei moduli usa invece get_settings_overview.

get_company_profile

Riepiloga la configurazione del profilo. Da usare quando si deve verificare se il CRM è pronto per un'attività, ad esempio un report su un nuovo canale. Restituisce moduli attivi, integrazioni e passi di configurazione completati o mancanti. Effetti: sola lettura. Per i dati aziendali usa invece get_company_profile.

get_settings_overview

Legge l'indice di un report pronto. Da usare quando get_report_status indica ready=true e si vuole sapere cosa contiene il report. Restituisce periodo, sezioni e visualizzazioni disponibili, esclusi valori KPI, testi descrittivi e creatività. Effetti: sola lettura. Per i valori numerici usa invece analyze_report_period; per il file completo usa invece export_report.

get_report_sections

Legge le opzioni di targeting disponibili per le campagne pubblicitarie conversazionali (ChatGPT Ads) collegate al profilo. Da usare quando si prepara una campagna con create_paused_ad_campaign. Restituisce zone geografiche e piattaforme supportate; il targeting per sesso ed età non è supportato. Effetti: sola lettura.

get_ad_targeting_options

Legge le impostazioni del modulo Audience del profilo. Da usare quando si pianificano attività sul pubblico e servono limiti e disponibilità. Restituisce limiti di utilizzo, crediti disponibili ed elenchi di contatti. Effetti: sola lettura, non consuma crediti.

get_audience_settings

Legge dal servizio WhatsApp lo stato del collegamento del profilo. Da usare quando si deve verificare se WhatsApp è operativo. Restituisce lo stato: collegato, disconnesso o in attesa di abbinamento. Effetti: sola lettura; nessun messaggio inviato e collegamento invariato.

get_whatsapp_status

Legge lo stato delle integrazioni del profilo. Da usare quando dati o lead non risultano aggiornati e se ne cerca la causa. Restituisce lo stato delle autorizzazioni dei servizi esterni, l'ultima importazione dei lead Meta e le ultime esecuzioni delle attività pianificate. Effetti: sola lettura. Per il solo elenco degli account collegati usa invece list_connected_accounts.

get_integrations_status

Legge il saldo crediti del profilo collegato e gli ultimi movimenti. Da usare quando si deve verificare la disponibilità prima di report ed esportazioni o controllare i consumi. Restituisce saldo attuale ed elenco di addebiti e ricariche. Effetti: sola lettura.

get_credit_balance

Incrementa il progresso di una task assegnata all'operatore collegato e la segna completata quando progress_count raggiunge requires_count. Da usare quando l'operatore dichiara di aver svolto un'attività della task. Restituisce progresso e stato aggiornati. Effetti: modifica dati; crea anche un evento di 15 minuti nel calendario del CRM, sincronizzabile con Google Calendar, e ogni chiamata aggiunge un ulteriore avanzamento.

record_task_progress

Riepiloga le richieste HTTP del profilo collegato in una finestra di ore. Da usare quando si deve valutare l'andamento del servizio in un periodo. Restituisce volumi, errori e tempi medi di risposta. Effetti: sola lettura. Per le singole richieste usa invece list_recent_api_requests.

get_api_usage_summary

Importa nel CRM campagne e spesa da Google Ads o Meta, aggiornando le campagne CRM corrispondenti. Da usare quando i dati delle campagne nel CRM risultano non aggiornati. Senza conferma restituisce un'anteprima; con conferma esegue la sincronizzazione e restituisce il numero di campagne sincronizzate, saltate e in errore. Effetti: modifica dati, sovrascrivendo i valori delle campagne nel CRM; legge dai servizi esterni senza scrivere su di essi; richiede conferma con valore SYNC.

sync_ad_campaigns

Verifica che il servizio e il database del profilo ADV.click collegato siano raggiungibili. Da usare quando un'altra richiesta fallisce o per controllare la connessione prima di iniziare. Restituisce lo stato del servizio, lo stato del database e l'identificativo del profilo; non restituisce KPI, lead o altri record CRM. Effetti: sola lettura. Per lo stato dei collegamenti con Google o Meta usa invece list_connected_accounts.

check_service_status