Concetti chiave

Questi undici concetti compaiono in tutte le guide del prodotto. Capirli una volta evita di rileggere la stessa spiegazione in ogni manuale — ognuno rimanda alla guida dove è descritta la procedura completa.

Account (tenant)

La tua agenzia o attività all’interno di Aymar Agents. Ogni account è un compartimento isolato: ogni dato — conversazioni, lead, documenti, chiavi — è sempre filtrato in base all’id del tuo account, e un id di un altro account su qualsiasi rotta risponde “non esiste”, mai “non hai il permesso” (il che confermerebbe che il dato esiste). Vedi Sicurezza e conformità.

Agente IA

L’identità configurabile — istruzioni, modello, risorse assegnate — con cui il tuo assistente parla con i clienti. Puoi avere più agenti che gestiscono cose diverse (uno per le vendite, uno per il supporto); ogni canale o istanza di canale ne ha uno assegnato. Vedi Agenti IA.

Canale e istanza

Un canale è il tipo di via su cui parla il tuo agente: WhatsApp, Telegram, Widget web, Messenger / Instagram Direct. Un’istanza è una connessione concreta di quel tipo — puoi avere più istanze dello stesso canale (due widget, due numeri WhatsApp), ciascuna con il proprio agente assegnato, i propri responsabili e la propria attribuzione dell’origine. Vedi Canali.

Conversazione

Il filo di messaggi con un cliente su un’istanza di canale. Ha tre modalità: IA (risponde l’agente), UMANO (qualcuno del tuo team ha preso il controllo) e IN CODA (l’IA ha derivato e attende che qualcuno se ne occupi). Vedi Conversazioni.

Lead e contatto

Un lead è un’opportunità nel tuo funnel di vendita, con fase, qualità e responsabile; viene catturato automaticamente su qualsiasi canale o inserito a mano. Un contatto è la scheda del cliente stesso (telefono, verifica, liste di marketing), condivisa da tutti i suoi lead e conversazioni — include anche la sua memoria, il riepilogo che l’agente mantiene su di lui e condivide tra i canali. Vedi Lead e Contatti e marketing.

Risorsa ed etichetta

Una risorsa è tutto ciò che un agente può usare: un documento della base di conoscenza, un modello o un server MCP. Un’etichetta è il meccanismo che decide quale agente vede quale risorsa — un catalogo unico, condiviso da tutto il tuo account. Senza etichette né «Accesso a tutto», un agente non vede nessuna risorsa: negato di default. Vedi Agenti IA, sezione risorse.

Audience: Interno / Entrambi

Ogni azione, modello o documento dichiara se è Interno (solo il tuo team) o Entrambi (anche un visitatore anonimo su un canale pubblico, come il widget del tuo sito). «Interno» è il valore predefinito per tutto ciò che non è dichiarato esplicitamente — fail-closed. Un elemento con audience Entrambi che scrive su un sistema esterno restituisce al visitatore anonimo solo la conferma minima, mai il dato completo. Vedi Controllo dell’agente: risorse e permessi.

Permessi e mezzi di accesso

Per un chiamante identificato (una persona con sessione, un dipendente con un proprio canale, una chiave API), un catalogo fine di permessi decide cosa può fare — sempre incrociato con il tetto del suo mezzo di accesso (gli scope sigillati di una chiave, o il ritaglio user_medium_grants di un canale). Vedi Controllo dell’agente: risorse e permessi e Chiavi API e mezzi di accesso.

Lavoro, flusso e consegna

Un lavoro è un’attività autonoma che esegue il tuo agente, una tantum o ripetuta. Un flusso concatena più passaggi con la possibilità di ramificarsi in base a una condizione. Una consegna (“consigna”) è un flusso che chiedi al tuo assistente in chat, con parole tue, e che lui costruisce — si modifica esattamente come uno creato a mano. Vedi Lavori e flussi.

Chiave API

Una credenziale segreta per chiamare /public/v1 dal tuo stesso codice — pensata per integrazioni macchina-a-macchina, mai perché una persona vi acceda. Viene mostrata per intero una sola volta; i suoi scope di lettura/gestione per risorsa restano sigillati al momento della creazione. Vedi Chiavi API e mezzi di accesso e Autenticazione.

MCP

Model Context Protocol, lo standard aperto perché un assistente IA usi strumenti esterni in modo strutturato. In Aymar Agents funziona in due direzioni opposte: il server MCP proprio espone il tuo account (lead, contatti, appuntamenti…) al TUO assistente IA esterno (Claude Desktop, Claude Code, Cursor); un server MCP esterno (BYO-MCP), che registri tu in Impostazioni, inserisce strumenti di terze parti dentro l’agente che parla con i tuoi clienti — sotto la tua responsabilità. Vedi Integrazioni e MCP.

Vedi anche

• Glossario — ogni termine, in una riga, in ordine alfabetico.
• Sicurezza e conformità — i quattro livelli di accesso, spiegati per intero.