Configurare gli SMS (con il tuo provider)
The-Y invia e riceve SMS tramite il tuo provider SMS (“bring your own credentials”): nessun ricarico, paghi direttamente il tuo provider. In questa guida inserisci le credenziali API, invii un SMS di prova e configuri la ricezione delle risposte. Esempio SMStools: da 0,025 € per SMS verso l'Austria, da 0,060 € verso la Germania (aggiornato al 12 nov 2026, fonti: AT · DE).

Prima di iniziare: cosa ti serve
- Un account presso un provider SMS con API REST. The-Y si basa sul diffuso formato SMStools (header
X-Client-Id/X-Client-Secret); l'URL di base dell'API si può configurare liberamente, quindi funzionano anche i provider compatibili. - Dal provider: un client ID e un client secret (credenziali API) più l'URL di base dell'API.
- Un mittente (sender ID): a seconda del Paese e del provider un codice breve, un nome o un numero (deve essere abilitato presso il provider). Con SMStools un nome può avere al massimo 11 caratteri senza caratteri speciali, un numero al massimo 14 caratteri (aggiornato al 12 nov 2026, fonte: SMStools).
Passo per passo
- Apri i canali. Settings → Channels; con più marchi scegli in alto il marchio giusto.
- Riquadro “SMS”. In “Add a channel” clicca “SMS”. Nella finestra “Connect SMS” inserisci il numero che ti ha dato il provider (con prefisso internazionale, ad es.
+43 …) ed eventualmente un'etichetta → “Next”. Così viene creato l'account SMS e si apre la finestra del numero. -
Inserisci le credenziali e clicca “Save”:
- API base URL (URL di base dell'API) del tuo provider (ad es.
https://api.your-provider.tld) - Client ID e client secret: il secret viene salvato in forma cifrata (AES-256)
- Sender (sender ID, il mittente)
- API base URL (URL di base dell'API) del tuo provider (ad es.
- Invia un SMS di prova. Clicca “Send test SMS” e inserisci un numero di destinazione (ad es. il tuo cellulare). The-Y chiama l'API del provider in tempo reale; un messaggio di errore (ad es.
401 Invalid Credentials) arriva direttamente dal provider: vedi Risoluzione dei problemi. - Fatto. L'account SMS è attivo (interruttore “Active” nell'elenco “Connected”) e disponibile come canale in “New chat” e nel marketing. In seguito lo apri dall'elenco con “Edit” (o “Configure” finché manca qualcosa); lì, in basso a sinistra, c'è anche “Delete”.
Ricevere risposte e STOP
- Crea un indirizzo di ricezione. Nella finestra del numero (Settings → Channels → “Edit” sul numero), nella sezione “Incoming SMS & STOP”, clicca “Create receiving address”.
- Inseriscilo presso il tuo provider. Copia l'indirizzo e inseriscilo presso il tuo provider SMS come webhook per i messaggi in entrata, di solito in Impostazioni → Webhook → messaggi in entrata.
- Fatto. Le risposte dei tuoi clienti arrivano nell'inbox. Se qualcuno scrive “STOP”, “STOPP”, “ABMELDEN” o “UNSUBSCRIBE”, viene disiscritto dagli SMS (con una nota nella conversazione); con “START” o “ANMELDEN” viene iscritto di nuovo.
Inviare SMS
- Singolarmente: nell'inbox clicca “+ New chat”, scegli un contatto, il canale SMS, scrivi il messaggio e invia. (Il consenso viene rispettato: i contatti disiscritti non compaiono.) Il numero viene salvato con il prefisso del tuo Paese (“0664 …” diventa “+43 664 …”) e prima dell'invio vedi a quale numero va. Se con quel numero c'è già una conversazione aperta, continui lì.
- Come campagna: in Marketing crea una campagna con canale SMS (segmento, segnaposto come
{firstname}). Vedi la guida al marketing.
Consenso
Nella pagina del contatto vedi per ogni canale se è stato dato il consenso, con data e fonte. Le campagne SMS vanno solo ai contatti con consenso esplicito; “New chat” e il marketing escludono automaticamente i contatti disiscritti dagli SMS. Di più: Consenso, STOP e disiscrizione.
Risoluzione dei problemi
401 Invalid Credentials
Client ID o client secret sbagliati, oppure l'URL di base dell'API non è corretto. Controlla i valori nel pannello del provider e inseriscili di nuovo. Il messaggio arriva 1:1 dal provider: vuol dire che la connessione in sé funziona.
“Sender not allowed” / l'SMS non arriva
Molti Paesi e provider richiedono un mittente registrato (sender ID). Fai abilitare il tuo mittente presso il provider o usa un numero o codice breve consentito. Controlla anche il credito presso il provider.
Le risposte non arrivano nell'inbox
Controlla che l'indirizzo di ricezione sia inserito presso il provider come webhook per i messaggi in entrata (non per i rapporti di consegna) e che dopo “Create new address” tu abbia inserito il nuovo indirizzo. L'account SMS deve essere attivo.
Il mio provider non è SMStools
Se l'API del provider è compatibile con lo schema SMStools (header X-Client-Id/X-Client-Secret, endpoint JSON), basta adattare l'URL di base dell'API. Altrimenti scrivici a office@the-y.at: altri adattatori per provider sono possibili.
