Trigger
La scheda Trigger permette al tuo agente di lavorare in background, senza nessuno in linea. Quando succede qualcosa — arriva un'email, termina una chiamata, entra un lead, il tuo sistema invia un webhook o semplicemente arriva un orario stabilito —, l'agente può prima svolgere un compito (leggere la posta, preparare una bozza, decidere se è importante) e poi chiamare il numero che scegli.
I trigger non sono disponibili nel piano Free. Servono un piano a pagamento (Starter, Pro, Business o Enterprise) e un saldo di crediti (o la ricarica automatica) quando un trigger scatta. Nel piano Free puoi ancora disattivare o eliminare un trigger, ma non crearne o attivarne uno.
Le chiamate dei trigger partono dal numero del campo Chiama da del trigger, altrimenti dal numero in uscita dell'agente, altrimenti dal numero su cui risponde. Vedi Numeri di telefono.
Come funziona un trigger
Ogni trigger ha tre parti, che corrispondono alle tre sezioni del modulo del trigger:
| Sezione | Cosa imposti |
|---|---|
| Quando | L'evento che avvia il trigger e i suoi filtri |
| Prima della chiamata | Un compito facoltativo per l'agente e se chiamare sempre o lasciare decidere all'agente |
| Chi chiamare | Un numero fisso o il numero dall'evento, il numero da cui chiamare, i tentativi e la pausa tra uno e l'altro |
Una quarta sezione, Limiti, protegge la persona chiamata: ore di silenzio, chiamate all'ora e al giorno, protezione dalle ripetizioni.
Il flusso a ogni evento:
- L'evento arriva e viene confrontato con i filtri del trigger.
- Se il trigger ha un compito, l'agente lo svolge in background. Può cercare e leggere nelle caselle di posta e nei file collegati e preparare bozze di risposta, ma in background non invia nulla tranne un riepilogo all'indirizzo fisso Owner email.
- Con Chiama sempre, l'agente chiama dopo ogni evento. Con Lascia decidere all'agente, chiama solo se il compito indica che ne vale la pena — per esempio, solo per le email importanti.
- La chiamata parte dal numero in uscita dell'agente, con quello che l'agente ha trovato già nel suo contesto.
Eventi
| Evento | Scatta quando | Filtri |
|---|---|---|
| Nuova email | Arriva una nuova email in una casella collegata — Gmail, Outlook o IMAP | Il mittente contiene, l'oggetto contiene, il testo contiene, solo email con allegati. Tutti i filtri compilati devono corrispondere; maiuscole e minuscole non contano |
| Chiamata terminata | Termina una chiamata di questo agente | Tipo di chiamata (qualsiasi, in entrata, in uscita, chiamata web), esito (qualsiasi, chiamata breve, trasferimento fallito, segreteria, nessuna risposta, conversazione completata), più lunga di / più breve di (secondi), il riepilogo contiene |
| Nuovo lead | Viene acquisito un lead | ID del modulo — lascialo vuoto per reagire ai lead di qualsiasi modulo |
| Webhook | Il tuo sistema invia un POST all'URL proprio del trigger | Campo del telefono nella richiesta — un percorso nel corpo JSON, ad es. phone o customer.phone |
| Pianificazione | Arriva un orario stabilito | Una volta, ogni giorno, giorni feriali (lun–ven), ogni settimana, ogni mese |
| SMS in arrivo | Arriva un SMS sul numero dell'agente | Il testo contiene — lascialo vuoto per reagire a ogni SMS |
| Evento del calendario | Si avvicina un evento nel calendario Google o Outlook | Minuti prima dell'evento (5–2.880), dove trovare il numero di telefono (descrizione dell'evento, luogo dell'evento, telefono del partecipante) |
| File di Google Drive | Un file compare o cambia in Google Drive | File nuovo o modificato, cartella, il nome contiene, tipo di file (documento, foglio di calcolo, presentazione, PDF, cartella) |
- Nuova email richiede la casella collegata in Integrazioni e lo strumento di posta corrispondente aggiunto all'agente, così che l'agente possa leggere l'email in background. Vedi Email.
- File di Google Drive vede solo le cartelle e i file che hai condiviso con l'agente in Integrazioni, più i file creati dall'agente stesso. Vedi Google.
- Chiamata terminata conta solo le chiamate di questo agente. Le chiamate fatte da trigger o richiamate non avviano mai un trigger, quindi i trigger non possono andare in loop.
- La pianificazione usa il fuso orario dell'agente. Una chiamata mensile il 31 parte l'ultimo giorno dei mesi più corti.
URL del webhook
Dopo aver salvato un trigger webhook, il suo URL compare nel modulo e nel menu del trigger (Copi l'URL del webhook).
- Invia una richiesta
POSTcon un corpo JSON fino a 64 KB. - Tieni l'URL segreto: chiunque lo abbia può avviare il trigger.
- Nuovo URL crea un nuovo indirizzo; quello vecchio smette subito di funzionare.
- Non richiamare mai l'URL da un browser. Se trapela, clicca subito su Nuovo URL. Tratta il corpo della richiesta come dati non attendibili.
Chi chiamare
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Numero fisso / Numero dall'evento | Chiamare ogni volta lo stesso numero o il numero che porta l'evento: l'altra parte della chiamata, il telefono del lead, il mittente dell'SMS, il campo telefono del webhook, il telefono trovato nell'evento del calendario | Numero fisso |
| Numero di telefono | Per un numero fisso — formato internazionale con + e prefisso del paese, senza spazi | — |
| Chiama da | Da quale numero in uscita chiamare | Il numero in uscita dell'agente |
| Tentativi | Quante volte provare se nessuno risponde (1–5) | 3 |
| Minuti tra i tentativi | Pausa tra i tentativi (1–120) | 10 |
Gli eventi senza un proprio numero di telefono (nuova email, pianificazione, file di Google Drive) chiamano sempre un numero fisso.
Limiti
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Ore di silenzio | Le chiamate che cadono in questa fascia aspettano che finisca | Attivo, 21:00–08:00 nel fuso orario dell'agente |
| Chiamate all'ora, max | 1–100 | 10 |
| Chiamate al giorno, max | 1–500 | 50 |
| Ignora le ripetizioni per (minuti) | Lo stesso evento o lo stesso numero entro questo tempo avvia una sola chiamata. 0 la disattiva (0–1.440) | 60 |
Limiti dell'intera piattaforma:
- Fino a 50 trigger per agente.
- Fino a 200 compiti in background per account al giorno.
- Un URL webhook accetta fino a 30 richieste al minuto.
Durante una chiamata, gli strumenti dell'agente hanno propri limiti di sicurezza: al massimo 3 email per conversazione (o in alternativa fino a 5 bozze), al massimo 2 richiamate per chiamata e, prima di inviare un'email, eliminare un file o sostituire il testo di un file, l'agente lo legge ad alta voce e agisce solo dopo un «sì» chiaro della persona in linea. In un compito in background l'agente non invia nulla tranne un riepilogo all'indirizzo fisso Owner email; una bozza parte solo dopo un «sì» durante la chiamata. Per ogni strumento puoi anche scrivere una regola con parole tue. Vedi Azioni e strumenti.
Modelli
Sfogli i modelli apre una galleria di trigger pronti; nel passaggio successivo puoi cambiare tutto. Parta da zero ti lascia scegliere da solo l'evento, il compito e la chiamata.
| Gruppo | Modello | Cosa fa |
|---|---|---|
| Chiamami per le email importanti | Legge ogni nuova email e ti chiama solo se è urgente o importante | |
| Chiamami quando scrive un certo mittente | Ti chiama con un breve riepilogo di ogni email del mittente che indichi | |
| Email con allegati | Legge gli allegati, estrae importi e date, prepara una bozza di risposta se serve | |
| Nuova fattura via email | Email che menzionano «Rechnung»: trova l'importo, la scadenza e l'IBAN e ti chiama | |
| Riepilogo mattutino della posta | Nei giorni feriali alle 08:30 esamina le email non lette da ieri e ti chiama con le 5 principali | |
| Google Drive | Nuovo file in Drive — leggilo e chiama | Legge un nuovo file e ti chiama con l'essenziale |
| Nuovo PDF in una cartella — controlla la fattura e chiama | Trova l'importo, la scadenza, l'IBAN e il mittente di un nuovo PDF nella cartella scelta | |
| Documento aggiornato — chiama | Chiama se il documento modificato contiene qualcosa di sostanziale | |
| Foglio di calcolo aggiornato — chiama se conta | Chiama solo se sono comparse nuove attività o nuovi ordini | |
| A orario | Chiamata giornaliera · Chiamata settimanale · Chiamata mensile · Chiamata singola | Chiama un numero all'orario scelto |
| Dopo le chiamate | Richiama dopo una chiamata breve | Una chiamata in entrata è terminata entro 20 secondi — l'agente richiama |
| Richiama dopo un trasferimento fallito | Il trasferimento a un collega non è riuscito — l'agente richiama chi ha chiamato | |
| Riprova se nessuno ha risposto | Dopo una chiamata in uscita senza risposta, riprova più tardi | |
| Riprova dopo la segreteria | Una chiamata in uscita è finita in segreteria — richiama dopo un'ora | |
| Avvisami dei chiamanti insoddisfatti | Ti chiama solo se chi ha chiamato era scontento o ha chiesto un responsabile | |
| Riepilogo della chiamata al responsabile | Dopo ogni conversazione completata di oltre 30 secondi, chiama il responsabile con un riepilogo | |
| Lead e webhook | Chiama subito i nuovi lead | Chiama un nuovo lead entro un minuto; grazie alle ore di silenzio, i lead notturni vengono chiamati al mattino |
| Avvisami dei nuovi lead | Ti chiama con nome, contatto e richiesta del lead | |
| Chiama il cliente dal Suo sistema | Il tuo CRM, negozio o modulo invia una richiesta con un numero — l'agente lo chiama | |
| Avvisami dal Suo sistema | Qualsiasi sistema invia una richiesta — l'agente ti chiama e ti dice cosa è successo | |
| SMS e calendario | Richiama dopo un SMS | Qualcuno scrive al numero dell'agente — l'agente lo richiama |
| Avvisami degli SMS in arrivo | Ti chiama e ti dice chi ha scritto e cosa vuole | |
| Promemoria appuntamento | Due ore prima di un evento del calendario, chiama il numero dell'evento |
Test ed esecuzioni recenti
Testi ora nel menu di un trigger lo esegue subito, come se l'evento fosse appena accaduto. Puoi passare dati di esempio dell'evento come JSON — per esempio, il numero di telefono per un webhook. Le ore di silenzio e la protezione dalle ripetizioni vengono saltate; i limiti orari e giornalieri contano comunque. Questo fa una chiamata reale.
Esecuzioni recenti mostra cosa hanno fatto i trigger, insieme alle richiamate che l'agente ha promesso durante le chiamate (lo strumento Richiamare più tardi). Ogni esecuzione ha uno stato:
| Stato | Significato |
|---|---|
| In attesa / In corso | Aspetta il suo turno o sta svolgendo il compito in background |
| Chiamata in coda / Chiamata in corso | La chiamata aspetta il suo momento o sta squillando |
| Completata | Terminata |
| Chiamata non necessaria | L'agente ha deciso che non valeva la pena chiamare |
| Trattenuta | Fermata da un limite — ore di silenzio, limite orario o giornaliero, una ripetizione recente |
| Fallita | Qualcosa è andato storto — per esempio, nessun numero in uscita, nessun telefono nell'evento, Google Drive non collegato |
| Annullata | L'esecuzione è stata annullata |
Fatturazione
Il compito in background in sé non viene addebitato. La chiamata fatta da un trigger viene fatturata come qualsiasi altra chiamata in uscita, prima dai crediti del piano, poi dalle ricariche. Se il saldo è vuoto e la ricarica automatica è disattivata, l'esecuzione fallisce prima di chiamare. Vedi Fatturazione e abbonamenti.
Correlati
- Azioni e strumenti — gli strumenti che l'agente usa nelle chiamate e nei compiti in background
- Email — collegare Gmail, Outlook o una casella IMAP
- Google — Calendar, Gmail, Drive, Contacts e Tasks
- Numeri di telefono — assegnare un numero in uscita
- Campagne — chiamate in uscita verso un elenco di contatti