💬 Configurazione SMS AI4CALL
Guida completa per integrare SMS con AI4CALL: invia conferme, reminder e notifiche automatiche via SMS durante le chiamate con sistema prepagato
Vai in "MARKET" → "Marketplace Plugin" e clicca su Acquista di "SMS AI4CALL" → PAY
Vai in "MARKET" → "I Miei Plugin" e clicca su Configura di "SMS AI4CALL"
🚀 Navigazione rapida:
⚠️ Servizi di terze parti
Le integrazioni descritte fanno riferimento a servizi di terze parti.
Rate limit, modalità di autenticazione, configurazioni tecniche, costi e policy sono definiti esclusivamente dai rispettivi provider e possono variare nel tempo.
I costi dei servizi esterni sono sostenuti direttamente dall’utente finale a favore dei fornitori dei servizi stessi e non sono in alcun modo gestiti o intermediati dal nostro portale (es. Meta o altri fornitori per WhatsApp, Zapier, Calendly, ecc.).
Cosa significa:
- ❌ NON puoi personalizzare alias mittente con nome tua azienda
- ❌ Cliente riceve SMS con mittente "AI4CALL", non "Studio Medico" o "Agenzia XYZ"
- ⚠️ Limitazione tecnica operatore SMS - non modificabile attualmente
Workaround raccomandato:
- ✅ Includi nome azienda nel TESTO SMS
- ✅ Esempio: "AI4CALL per Studio Dentistico Rossi: appuntamento confermato martedì 15 ore 10"
- ✅ Cliente capisce provenienza anche con mittente generico
Futuro: personalizzazione alias custom in roadmap - contatta supporto AI4CALL per aggiornamenti.
Vantaggi:
- ✅ universale: funziona su TUTTI cellulari (anche feature phone senza internet)
- ✅ delivery rate altissimo: 99% consegna garantita
- ✅ NO app richiesta: arriva nativamente
- ✅ latenza bassa: consegna 2-30 secondi
- ✅ read rate alto: ~90% SMS letti entro 3 minuti
Svantaggi:
- ⚠️ a pagamento: €0.035-0.05 per SMS
- ⚠️ 160 caratteri max (testo puro, no media)
- ⚠️ NO link cliccabili nativi (solo su smartphone moderni)
- ⚠️ mittente fisso "AI4CALL" attualmente
Quando usare SMS:
→ notifiche critiche urgenti (OTP, alert sicurezza)
→ clienti senza smartphone/WhatsApp
→ backup fallback se WhatsApp/Email falliscono
→ conferme dove consegna garantita è critica
→ target demografico senior (preferiscono SMS)
Quando NON usare SMS:
→ messaggi lunghi >160 char (usa Email)
→ contenuti con media/immagini (usa WhatsApp)
→ link importanti da cliccare (usa Email/WhatsApp)
→ volumi altissimi giornalieri (costi eccessivi)
Cos'è l'integrazione SMS e come funziona
L'integrazione SMS permette all'assistente AI4CALL di inviare messaggi di testo su telefoni cellulari durante o dopo le chiamate tramite rete operatori mobili.
→ acquisti credito SMS anticipatamente (100, 500, 1000 SMS)
→ ogni invio decrementa contatore automaticamente
→ quando finiscono: devi acquistare nuovo pacchetto
→ SMS prepagati NON scadono mai
Invio one-way (solo uscita):
→ assistente può INVIARE SMS ai clienti
→ clienti NON possono rispondere (numero non bidirezionale)
→ ideale per: conferme, reminder, notifiche, alert
Mittente fisso "AI4CALL":
→ tutti SMS mostrano mittente "AI4CALL"
→ NON personalizzabile con nome azienda attualmente
→ workaround: includi nome azienda nel testo messaggio
Delivery garantita:
→ consegna via rete operatori mobili (Vodafone, TIM, Wind, etc.)
→ 99% delivery rate
→ latenza 2-30 secondi tipicamente
[Cliente chiama studio per prenotare]
↓
[Assistente AI4CALL gestisce prenotazione]
↓
[Raccoglie: nome, numero cellulare, data/ora appuntamento]
↓
[Fine chiamata]
↓
[AI invoca: send_sms]
↓
[Parametri:
- dst: numero cellulare cliente
- txt: "AI4CALL per Studio Dr. Rossi: appuntamento
confermato martedi 15 marzo ore 10:00.
Via Roma 1, Milano"]
↓
[Sistema invia SMS via operatore mobile]
↓
[Cliente riceve SMS entro 30 secondi]
↓
[Contatore SMS disponibili decrementa: 90 → 89]
Vantaggio: conferma immediata su dispositivo che cliente ha sempre con sé (cellulare). Funziona anche senza smartphone/internet.
Pacchetto Base: 100 SMS a €5.00
→ costo per SMS: €0.05
→ ideale per: test, uso occasionale singolo studio
Pacchetto Standard: 500 SMS a €20.00
→ costo per SMS: €0.04
→ ideale per: uso medio, campagne piccole/medie
Pacchetto Premium: 1000 SMS a €35.00
→ costo per SMS: €0.035
→ ideale per: uso intensivo, volumi alti
Attenzione messaggi lunghi: se testo SMS >160 caratteri, divide in multipli SMS addebitati separatamente
→ 161-320 char = 2 SMS addebitati
→ 321-480 char = 3 SMS addebitati
Best practice: mantieni sotto 160 caratteri per massimizzare efficienza
Acquista pacchetto SMS prepagato
Prima di poter inviare SMS devi acquistare credito tramite uno dei pacchetti prepagati disponibili.
- Seleziona "SMS AI4CALL" dall'elenco dei tuoi Plugin
- Sezione "SMS Disponibili":
→ mostra contatore SMS rimanenti (es. "90")
→ se 0 o pochi: serve ricarica - Sezione "Pacchetti SMS Disponibili":
→ visualizza 3 card pacchetti con dettagli - Scegli pacchetto adatto:
- Base 100 SMS €5: test o uso molto limitato
- Standard 500 SMS €20: raccomandato per inizio (miglior rapporto qualità/prezzo)
- Premium 1000 SMS €35: volumi alti (>30 SMS/giorno)
- Clicca pulsante "ACQUISTA" sul pacchetto scelto
- Sistema reindirizza a checkout pagamento sicuro
- Completa pagamento (carta credito/PayPal/bonifico)
- Dopo pagamento confermato:
→ SMS aggiunti automaticamente a saldo
→ contatore "SMS Disponibili" aggiornato
→ acquisto appare in "Storico Acquisti" - Clicca "AGGIORNA SMS RIMANENTI" se contatore non refresh automatico
- ✅ SMS Disponibili: count aggiornato (es. 90 → 590 se acquistato Standard)
- ✅ Storico Acquisti: nuova riga con data, SMS acquistati, prezzo
- ✅ tool send_sms ora funzionante
Nota: SMS prepagati NON scadono mai. Puoi acquistare multiple volte - credito si somma.
Esempio: hai 90 SMS, acquisti Standard 500 → totale diventa 590 SMS disponibili.
Formula: (chiamate/giorno × % che ricevono SMS × giorni lavorativi/mese)
Esempio Studio Medico:
→ 20 appuntamenti/giorno
→ 80% clienti ricevono conferma SMS
→ 22 giorni lavorativi/mese
→ fabbisogno: 20 × 0.8 × 22 = 352 SMS/mese
→ pacchetto raccomandato: Standard 500 SMS (copre 1+ mese)
Esempio Agenzia Assicurazioni:
→ 50 chiamate/giorno
→ 30% ricevono SMS (altri preferiscono email)
→ 22 giorni lavorativi/mese
→ fabbisogno: 50 × 0.3 × 22 = 330 SMS/mese
→ pacchetto raccomandato: Standard 500 SMS
Consiglio: inizia con Standard 500, monitora consumo primo mese, adatta dopo.
Abilita tool send_sms
Dopo aver acquistato credito SMS, abilita il tool send_sms per permettere all'assistente di inviare messaggi.
- Seleziona "SMS" dall'elenco dei tuoi plugin:
→ vedi tool send_sms con checkbox
→ descrizione: "Invia un messaggio SMS tramite BeeVoIP o alias specificato" - Seleziona checkbox ☑️ send_sms
- Parametri tool visibili:
- alias: alias del mittente (default: ai4call) - FISSO attualmente
- dst: numero di destinazione (obbligatorio)
- txt: testo del messaggio SMS (obbligatorio)
- Clicca "SALVA CONFIGURAZIONE"
- ✅ Tool send_sms ora disponibile per assistente!
- ✅ checkbox send_sms selezionata
- ✅ credito SMS disponibile >0
- ✅ tool pronto per uso in prompt
Test rapido: chiama assistente, chiedi "inviami SMS di test". Dovresti ricevere messaggio entro 30 secondi.
→ anche se presente in configurazione, NON è modificabile
→ tutti SMS inviati mostrano mittente "AI4CALL"
→ specificare alias diverso nel tool call non ha effetto
Implicazione: NON perdere tempo cercando di personalizzare alias - non funzionerà.
Soluzione: includi identificazione azienda nel TESTO SMS, non nell'alias.
Ottimizza testo SMS per massima efficacia
SMS ha limite 160 caratteri - ogni parola conta. Ottimizza testo per massimizzare informazioni utili minimizzando costi.
✅ Esempio BUONO (152 caratteri):
AI4CALL per Studio Dr. Rossi: appuntamento martedi 15 marzo ore 10:00, Via Roma 1 Milano. Per disdetta chiama 02-1234567
❌ Esempio CATTIVO (187 caratteri = 2 SMS addebitati!):
AI4CALL per Studio Dentistico Dr. Rossi: gentile cliente, le confermiamo che il suo appuntamento è fissato per martedì 15 marzo 2025 alle ore 10:00 presso il nostro studio
Tecniche abbreviazione intelligenti:
- "appuntamento" → "appt." (risparmio 10 char)
- "gentile cliente" → ometti (risparmio 15 char)
- "2025" → ometti anno se ovvio (risparmio 5 char)
- "presso il nostro studio" → indirizzo diretto (risparmio 15 char)
- "le confermiamo che" → ometti formalità eccessive
Struttura SMS efficace:
1. Identificazione: "AI4CALL per [Nome Azienda]:" (20-30 char)
2. Messaggio core: azione/info principale (60-80 char)
3. Dettagli essenziali: data/ora/luogo (40-50 char)
4. Call-to-action: cosa fare se necessario (20-30 char)
AI4CALL per [Azienda]: appt. [giorno] [data] ore [hh:mm], [indirizzo]. Disdetta: [telefono]
→ esempio: "AI4CALL per Studio Rossi: appt. mar 15/3 ore 10:00, Via Roma 1 MI. Disdetta: 02-123456"
Template 2 - Reminder 24h prima (142 char):
AI4CALL per [Azienda]: REMINDER appt. domani [data] ore [hh:mm]. Conferma presenza: [telefono]
Template 3 - Codice OTP (89 char):
AI4CALL [Azienda]: codice verifica [123456]. Valido 5 min. NO condividere
Template 4 - Notifica urgente (125 char):
AI4CALL per [Azienda]: [messaggio urgente breve]. Contattaci: [telefono] o [email]
EVITA emoji (riducono limite a 70 char!):
❌ 😀❤️✅📅 → triggherano encoding UCS-2, max 70 char per SMS
✅ usa testo: "OK", "attenzione", "promemoria" invece
Attento lettere accentate (OK ma costose):
⚠️ à è ì ò ù → supportate ma riducono efficienza
✅ alternativa se critico: "e'" invece di "è"
EVITA caratteri speciali non-standard:
❌ simboli matematici ∑∏≠
❌ caratteri cirillici/arabi/cinesi (a meno che destinatario supporta)
✅ stick to: lettere A-Z, numeri 0-9, punteggiatura base
Istruisci l'assistente per workflow SMS
Configura il prompt dell'assistente per utilizzare send_sms correttamente con fallback multi-channel e ottimizzazione costi.
"Testo SMS DEVE essere <160 caratteri. Usa template: 'AI4CALL per [Azienda]: appt. [giorno] [data] ore [hh:mm], [indirizzo breve]. Info: [tel]'. Abbrevia intelligentemente: 'appuntamento'→'appt.', ometti formalità inutili. Conta caratteri PRIMA di send_sms - se >160, accorcia ulteriormente."
- Chiama assistente dal tuo cellulare
- Simula prenotazione: nome, data, ora
- Chiedi: "Inviami conferma SMS"
- Verifica: SMS ricevuto entro 30 secondi
- Controlla dashboard: SMS disponibili decrementato
- Verifica testo: <160 char, mittente "AI4CALL", info corrette
Test 2 - Fallback multi-channel:
- Simula cliente senza WhatsApp (fornisci solo numero cell + email)
- Assistente dovrebbe tentare WhatsApp → fallisce
- Fallback automatico a Email
- Se Email fallisce → SMS come ultimo resort
Test 3 - Gestione credito esaurito:
- Attendi SMS rimanenti = 0 (o simula)
- Chiedi invio SMS
- Verifica: assistente NON comunica errore
- Verifica: fallback silenzioso a Email
- Cliente riceve conferma via Email senza problemi
🛠️ Tool send_sms
Specifiche tecniche del tool MCP per invio SMS.
send_sms
Parametri:
alias(string, default: "ai4call"): mittente SMS - FISSO "AI4CALL" attualmente, non personalizzabiledst(obbligatorio, string): numero destinazione formato internazionale (es. "+393331234567")txt(obbligatorio, string): testo messaggio SMS - max 160 caratteri raccomandato
Esempio 1 - Conferma appuntamento:
send_sms(
dst="+393331234567",
txt="AI4CALL per Studio Rossi: appt. mar 15/3 ore 10:00, Via Roma 1 MI. Disdetta: 02-123456"
)
Esempio 2 - Codice OTP:
send_sms(
dst="+393331234567",
txt="AI4CALL Studio Medico: codice verifica 847392. Valido 5 min. NO condividere"
)
Response attesa:
- ✅ Success:
{"status": "sent", "message_id": "..."} - ❌ Error credito:
{"error": "credito SMS insufficiente"} - ❌ Error numero:
{"error": "numero destinazione invalido"}
Note importanti:
- ⚠️ Mittente SEMPRE "AI4CALL" - parametro alias ignorato attualmente
- ⚠️ Testo >160 char → multipli SMS addebitati (2 SMS se 161-320 char, 3 SMS se 321-480 char)
- ⚠️ Caratteri emoji riducono limite a ~70 char per SMS
- ⚠️ Ogni invio decrementa contatore SMS disponibili
- ⚠️ Consegna tipica: 2-30 secondi
❓ Domande frequenti
Risposte alle domande più comuni sull'integrazione SMS
Sistema prepagato a pacchetti: acquisti credito SMS anticipatamente, l'assistente consuma quando invia. Pacchetti disponibili: Base 100 SMS €5 (€0.05/SMS), Standard 500 SMS €20 (€0.04/SMS), Premium 1000 SMS €35 (€0.035/SMS). Dashboard mostra SMS rimanenti in tempo reale. Quando finiscono: tool send_sms fallisce, assistente deve informare cliente e usare metodo alternativo (email/WhatsApp). Ricarica: acquista nuovo pacchetto, credito si somma. Scadenza: SMS prepagati NON scadono mai.
Attualmente NO. Alias mittente è FISSO: "AI4CALL" per tutti SMS inviati tramite piattaforma. Cliente riceve SMS con mittente "AI4CALL", non nome tua azienda personalizzato. Limitazione tecnica operatore SMS. Futuro: possibile personalizzazione alias custom (es. "Studio Medico", "Agenzia XYZ") - contatta supporto AI4CALL per aggiornamenti roadmap. Workaround: includi nome azienda nel TESTO SMS: "AI4CALL per Studio Medico: appuntamento confermato..."
Limite standard: 160 caratteri per singolo SMS (GSM-7 encoding). Se superi: sistema divide automaticamente in SMS multipli concatenati (max 153 char ciascuno per overhead). Esempi: 161 char = 2 SMS addebitati, 320 char = 3 SMS. Caratteri speciali (emoji, accenti) riducono limite a ~70 char per SMS (UCS-2 encoding). Best practice: mantieni sotto 160 caratteri, evita emoji per massimizzare efficienza costi. Conta caratteri: AI4CALL mostra preview lunghezza prima invio.
Dashboard AI4CALL → Gestione Plugin SMS mostra: (1) SMS Disponibili: count tempo reale (es. "90"), (2) Storico Acquisti: tabella date acquisti, SMS acquistati, prezzo pagato, (3) pulsante "AGGIORNA SMS RIMANENTI" per refresh manuale. Ogni send_sms tool call decrementa automaticamente contatore. Per analytics dettagliato: export log chiamate AI4CALL, filtra per tool="send_sms", conta occorrenze per periodo/cliente/campagna. Alert automatici: imposta notifica quando SMS <20 per ricaricare in tempo.
Tool send_sms restituisce errore. Prova a gestire gracefully con invio di WhatsApp, email o salvataggio dell'errore e comunicazio all'utente "riceverà conferma a breve".
Sì. Gli SMS possono contenere link. Sui telefoni più vecchi il link può non essere cliccabile, mentre sugli smartphone moderni lo è automaticamente. In ogni caso è consigliato usare URL corti (short link) per risparmiare caratteri.
Tool send_sms invia IMMEDIATAMENTE - NO scheduling nativo. Per invii programmati: (1) integra con n8n/Zapier che supporta delay, (2) AI salva dati + timestamp desiderato su database, (3) cron job legge database, (4) quando timestamp arriva: invoca send_sms automaticamente. Esempio reminder appuntamento: (1) appuntamento prenotato 15 marzo, (2) salva evento + reminder_timestamp = 14 marzo ore 10:00, (3) cron giornaliero ore 10 controlla pending reminders, (4) invia SMS "Reminder: appuntamento domani ore 15".
Quasi istantaneo. Latenza tipica: 2-30 secondi da invocazione send_sms a ricezione cliente. Fattori ritardo: (1) rete operatore mobile destinatario (coverage area), (2) telefono acceso/spento (se spento: consegna al riaccensione), (3) roaming internazionale (ritardi maggiori), (4) congestione rete (eventi massivi, Capodanno). Delivery rate: 99% entro 60 secondi, 99.9% entro 5 minuti. Se SMS non arriva: verifica numero corretto formato internazionale (+39...), cliente in area coverage, telefono non bloccato.
Di default NO. Contatta il supporto AI4CALL per informazioni su pacchetti internazionali.
NO. Sistema attuale è SEND-ONLY (solo invio). Cliente NON può rispondere a SMS ricevuti da "AI4CALL" - numero mittente non è bidirezionale. Per conversazioni bidirezionali: usa WhatsApp (supporta risposte native) o fornisci numero telefono aziendale nel testo SMS: "Per rispondere chiama 02-12345678". Futuro: possibile numero SMS bidirezionale dedicato con webhook risposte - contatta supporto AI4CALL per roadmap. SMS ideale per: notifiche one-way, conferme, alert, reminder.
Encoding GSM-7 (standard): supporta lettere A-Z, numeri 0-9, punteggiatura base (. , ! ? - ( ) ), simboli €£$@. Caratteri NON supportati/problematici: emoji (😀❤️ = errore encoding o fallback UCS-2 costoso), lettere accentate italiane (à è ì ò ù = OK ma riducono limite 160→70 char), caratteri cirillici/arabi/cinesi (solo se destinatario supporta). Best practice: usa solo ASCII standard, evita emoji, rimpiazza "è" con "e'" se possibile, testa con numero reale prima produzione.
Sì, SMS ideale per OTP (One-Time Password). Workflow sicuro: (1) genera codice random 6 cifre, (2) salva in database con timestamp + user_id, (3) send_sms(text="Codice verifica: 123456. Valido 5 minuti"), (4) utente inserisce codice in app/web, (5) verifica match database + non scaduto. Best practice OTP: (1) codice numerico 6 cifre (facile digitare), (2) scadenza 5-10 min, (3) rate limit tentativi (max 3), (4) includi nome servizio: "Codice AI4CALL Studio Medico: 123456", (5) invalidazione post-uso.
Costo per SMS singolo: €0.035-0.05 (dipende da pacchetto acquistato). Messaggi lunghi: se >160 char, diviso in multipli SMS addebitati separatamente. Esempio calcolo: messaggio 320 caratteri = 3 SMS = €0.15 totale (pacchetto Premium €0.035×3). Ottimizzazione costi: (1) mantieni sotto 160 char, (2) evita emoji (riducono a 70 char), (3) usa abbreviazioni accettabili ("appuntamento" → "appt."), (4) considera Email/WhatsApp per messaggi lunghi (gratuiti illimitati). ROI: confronta costo SMS vs valore cliente/conversione.
Checklist troubleshooting: (1) verifica disponibilità di SMS-AI4CALL, (2) controlla formato numero: prefisso internazionale +39 per Italia, no spazi/trattini, (3) testo SMS: <160 char, no caratteri invalidi, (4) Response Tool di AI4CALL: cerca errori tool send_sms (credito insufficiente o altro).