Guide > Collegare i canali > Configurare gli SMS

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).

⏱ circa 10 min · Permesso “Manage settings” (amministratore) · Free: ogni SMS conta per i 1.000 messaggi in uscita al mese (tutti i canali insieme) · Cloud Pro (20 €/mese per azienda, tutti gli utenti e i marchi, valido in Alpha e Beta) e Paid: nessun limite di volume · Aggiornato al 12 nov 2026 (versione 1.1.65)

Inviare e ricevere. In uscita, singolarmente dall'inbox e come campagna, e in entrata: appena inserisci l'indirizzo di ricezione presso il tuo provider, le risposte arrivano nell'inbox e “STOP” disiscrive automaticamente (vedi Ricevere risposte e STOP).
La pagina Settings → Channels di The-Y CRM
Settings → Channels: qui aggiungi l'account SMS.

Prima di iniziare: cosa ti serve

Passo per passo

  1. Apri i canali. Settings → Channels; con più marchi scegli in alto il marchio giusto.
  2. 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.
  3. 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)
  4. 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.
  5. 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

  1. Crea un indirizzo di ricezione. Nella finestra del numero (Settings → Channels → “Edit” sul numero), nella sezione “Incoming SMS & STOP”, clicca “Create receiving address”.
  2. 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.
  3. 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.
L'indirizzo di ricezione è segreto: non condividerlo. “Create new address” invalida quello vecchio; poi inserisci quello nuovo presso il tuo provider. Con STOP The-Y non invia nessun SMS di conferma, e per gli SMS non ci sono rapporti di consegna.

Inviare SMS

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.

Prossimi passi