Integrazione con SMS

IBM Cloud

IntelePeer servizio di numero telefonico gratuito per watsonx Assistant
A partire dal 31 luglio 2025, il servizio di numero telefonico gratuito IntelePeer viene interrotto per watsonx Assistant. Dopo questa data, i numeri di telefono che utilizzano questo servizio non si connettono più e gli utenti non possono effettuare o ricevere chiamate. Per garantire la continuità del servizio, migrare i numeri di telefono a Twilio o a un altro provider di telefonia. Aggiornate i numeri di telefono e regolate le impostazioni di integrazione in watsonx Assistant. Per assistenza nella transizione, contattare il supporto all'indirizzo https://www.ibm.com/mysupport/.

Aggiungi un'integrazione di messaggistica di testo in modo che il tuo assistente possa scambiare messaggi con i clienti.

SMS (Short Messaging Service) supporta messaggi di solo testo. Di solito, SMS limita la lunghezza del messaggio di testo a 160 caratteri. Il servizio di messaggistica multimediale (MMS) supporta l'invio di immagini e messaggi di testo di lunghezza superiore a 160 caratteri. Quando crei un numero di telefono con Twilio, il supporto per i messaggi MMS viene incluso automaticamente. Il supporto per i messaggi MMS IntelePeer non è ancora disponibile.

I clienti inviano messaggi di testo al numero di telefono ospitato. Twilio e IntelePeer utilizzano un webhook di messaggistica che hai configurato per inviare una richiesta POST con il corpo del messaggio di testo al tuo assistente. Ogni risposta dall'assistente viene restituita a Twilio o a IntelePeer per essere convertita in un messaggio SMS in uscita inviato al cliente. Le risposte vengono inviate all'API del provider SMS per l'elaborazione. Fornisci le informazioni del token di autenticazione del provider SMS, che fungono da credenziali di accesso API.

Fare riferimento alle seguenti sezioni per configurare l'integrazione per il provider SMS:

Prima di iniziare

Per integrare Twilio con il tuo assistente, devi avere almeno un ruolo di sviluppatore. Per ulteriori informazioni, vedi la differenza nei ruoli per Twilio.

Se non hai un numero di telefono di messaggistica di testo, imposta un account SMS con Twilio e ottieni un numero di telefono.

Integrazione di SMS con Twilio

  1. Vai al sito web Twilio.

  2. Crea un account. Per questa integrazione non è possibile utilizzare account di prova gratuiti.

  3. Dalla scheda Develop nella barra laterale, fai clic su Phone Numbers. Se Numeri di telefono non è presente, andare alla barra di ricerca nella parte superiore e cercare 'Numeri di telefono', quindi selezionare Acquista un numero.

  4. Seguire le istruzioni per Acquistare un numero. Come cercare e acquistare un numero di telefono Twilio da console.

    Quando ottieni un numero di telefono Twilio, supporta automaticamente la voce, gli SMS e gli MMS. Il tuo nuovo numero di telefono è elencato come un numero attivo.

Tieni la pagina web Twilio aperta in una scheda del browser web in modo da potervi fare nuovamente riferimento in seguito. È anche possibile aggiungere Numeri di telefono alla barra laterale.

Configura l'integrazione

Per impostare l'integrazione, completare i seguenti passaggi:

  1. Vai alla pagina Integrazioni facendo clic sull'icona delle integrazioni (icona Integrazioni) nel menu a sinistra.

  2. Fai clic su Aggiungi nel tile SMS.

  3. Fai clic su SMS con Twilio tile.

  4. Fare clic su Conferma.

  5. Dal sito Twilio, fai clic sul tuo nome account nel menu in alto a sinistra per andare al tuo dashboard account.

    Copia i seguenti valori e memorizzali temporaneamente, in modo da poterli incollare nella pagina di configurazione dell'integrazione SMS with Twilio nei prossimi passi.

    • SID account
    • Token di autenticazione

  6. Torna alla pagina di impostazione dell'integrazione SMS with Twilio. Fai clic su Avanti per andare alla fase 1 della tua configurazione dell'integrazione SMS with Twilio.

  7. Inserisci le informazioni SID del tuo account. Fai clic su Avanti per passare alla fase 2 della configurazione dell'integrazione SMS with Twilio.

  8. Immettere le informazioni sul token di autenticazione. Fai clic su Avanti per andare al Passo 3 della tua configurazione dell'integrazione SMS with Twilio.

  9. Facoltativo: immetti il numero di telefono utilizzato dal tuo account Twilio per l'integrazione SMS. L'URI del webhook viene utilizzato per trasferire i messaggi, ma se aggiungi il tuo numero di telefono in questo campo facoltativo, puoi facilmente fare riferimento ad esso in un secondo momento. Fai clic su Avanti per andare alla fase 4 della configurazione di integrazione SMS with Twilio.

  10. Copia il valore dal campo Webhook URI.

    Aggiungerai questo URI alla configurazione webhook in Twilio. Se vuoi supportare più di un numero di telefono, devi aggiungere l'URI al webhook per ciascun numero di telefono separatamente.

  11. Vai alla pagina web del tuo account Twilio. Dalla scheda Sviluppo nella barra laterale, fai clic su Numeri di telefono> Gestisci> Numeri attivi.

  12. Dalla pagina Numeri attivi, fare clic su uno dei numeri di telefono.

  13. Scorri alla sezione Messaging e trova il campo Webhook che definisce cosa fare quando arriva un messaggio.

    Incolla il valore che hai copiato dal campo Webhook URI in esso.

  14. Se si desidera supportare più numeri di telefono, ripetere il passo precedente per ciascun numero di telefono che si desidera utilizzare.

  15. Fare clic su Salva.

  16. Dalla scheda Develop nella barra laterale, fai clic su Messaging> Settings> Geo permissions. Se Messaggistica non è presente, andare alla barra di ricerca nella parte superiore e cercare 'Messaggistica', quindi selezionare Autorizzazioni geografiche SMS.

  17. Dalla pagina Messaging Geographic Permissions, seleziona i codici paese dei numeri di telefono che possono inviare il tuo numero Twilio. Per impostazione predefinita, nessun codice paese può scrivere il tuo numero Twilio.

  18. Torna alla pagina di impostazione dell'integrazione SMS with Twilio. Fai clic su Finish.

Integrazione con SMS con IntelePeer

Se non hai un numero di telefono di messaggistica di testo, imposta un account SMS con IntelePeer e ottieni un numero di telefono.

  1. Visitare il sito Web IntelePeer.

  2. Crea un account o avvia una versione di prova gratuita.

    Quando si riceve un numero di telefono IntelePeer, supporta la voce e gli SMS. Se il numero non è abilitato automaticamente per SMS, sarà necessario abilitarlo manualmente. Il tuo nuovo numero di telefono è elencato come un numero attivo. Fare riferimento a Atmosphere Messaging Quick Start Guide

Prima di iniziare

Per integrare IntelePeer con l'assistente, è necessario il servizio "SMS" con Tipo di accesso per create, read, update e delete. Per ulteriori informazioni, vedi Gestione degli utenti nel portale del cliente.

Configura l'integrazione

Per impostare l'integrazione, completare i seguenti passaggi:

  1. Vai alla pagina Integrazioni facendo clic sull'icona delle integrazioni (icona Integrazioni) nel menu a sinistra.

  2. Fai clic su Aggiungi nel tile SMS.

  3. Seleziona il riquadro SMS with IntelePeer.

  4. Fare clic su Conferma.

  5. Dal sito IntelePeer Atmosphere, copia il valore API Authentication Token e memorizzalo temporaneamente, in modo da poterlo incollare nella pagina di configurazione dell'integrazione SMS with IntelePeer nei passi successivi.

  6. Dal sito IntelePeer Customer Portal, nella sezione My Applications, seleziona SMS API Management. Nella barra del titolo di SMS Management, fai clic sull'icona a forma di ingranaggio, qui imposterai l'SMS Secret Input. L'input segreto viene utilizzato per impedire al tuo webhook del server web di elaborare qualsiasi richiesta POST SMS in entrata che non ha origine da IntelePeer. Imposta qui il valore Secret Input e ricordalo come dovrai utilizzare il valore nella pagina di configurazione di integrazione SMS with IntelePeer nei prossimi passi.

  7. Torna alla pagina di impostazione dell'integrazione SMS with IntelePeer. Fai clic su Avanti per andare al passo 1 della tua configurazione di integrazione SMS with IntelePeer.

  8. Immettere le informazioni sul segreto dell'account. Fai clic su Avanti per andare alla fase 2 del tuo SMS con la configurazione dell'integrazione IntelePeer.

  9. Immettere le informazioni sul token di autenticazione. Fai clic su Avanti per andare al passo 3 della tua configurazione dell'integrazione SMS con IntelePeer.

  10. Opzionale: Inserire il numero di telefono che l'account IntelePeer utilizza per l'integrazione degli SMS. L'URI del webhook viene utilizzato per trasferire i messaggi, ma se aggiungi il tuo numero di telefono in questo campo facoltativo, puoi facilmente fare riferimento ad esso in un secondo momento. Fare clic su Avanti per passare alla fase 4 della configurazione dell'integrazione di SMS con IntelePeer.

  11. Copia il valore dal campo Webhook URI.

    Aggiungerai questo URI alla configurazione webhook in IntelePeer. Se vuoi supportare più di un numero di telefono, devi aggiungere l'URI al webhook per ciascun numero di telefono separatamente.

  12. Vai al tuo sito IntelePeer Customer Portal, nella sezione My Applications, seleziona SMS API Management.

  13. Vai ai numeri di telefono che vuoi abilitare per gli SMS. Attivare / disattivare il pulsante radiale Abilitato / Disabilitato accanto al numero e impostarlo su Abilitato. L'attivazione del numero di telefono per gli SMS potrebbe richiedere alcuni minuti.

  14. Una volta che il numero di telefono è stato abilitato per SMS, vedrai un'icona webhook accanto al numero.

    Incolla il valore che hai copiato dal campo Webhook URI in esso.

  15. Fare clic su Salva.

  16. Se si desidera supportare più numeri di telefono, ripetere il passo precedente per ciascun numero di telefono che si desidera utilizzare.

Per motivi di sicurezza, i campi di autenticazione vengono rimossi dalla visualizzazione dopo l'installazione iniziale. Se un campo richiesto per l'autenticazione viene modificato, tutte le voci nei campi correlati devono essere riempite e convalidate di nuovo.

Opzioni di configurazione avanzate SMS

La scheda Opzioni avanzate è disponibile dopo aver configurato l'integrazione SMS. Fare clic sulla scheda Opzioni avanzate per effettuare una delle seguenti personalizzazioni al funzionamento della messaggistica:

  • Avvia conversazione da messaggi in entrata: disabilita questa opzione se vuoi limitare il supporto di messaggistica per consentire solo i messaggi inviati nel contesto di una conversazione di integrazione telefonica in corso e non consentire ai clienti di avviare uno scambio di messaggi con l'assistente al di fuori di una chiamata telefonica.
  • Messaggio di errore predefinito: aggiungere un messaggio da inviare al cliente se la connessione SMS non riesce.
  • URL di base: Questo URL è l'endpoint dell'API REST per il servizio SMS in uso.

Ottimizzare le azioni per la messaggistica

Per la migliore esperienza del cliente, progetta le tue azioni tenendo conto delle funzionalità dell'integrazione SMS:

  • Non includere elementi HTML nelle risposte di testo.

  • L'integrazione SMS non supporta i trasferimenti chat avviati con il tipo di risposta connect_to_agent.

  • I tipi di risposta Immagine, Audio, Video consentono di inviare un messaggio contenente il supporto. Un titolo e una descrizione vengono inviati insieme all'allegato. Tenere presente che, a seconda del gestore e del dispositivo dell'utente finale, questi messaggi potrebbero non essere ricevuti correttamente. Per un elenco dei tipi di contenuto supportati per Twilio, consultare Twilio: Accepted Content Types for Media.

    Per ulteriori informazioni su questi tipi di risposta, consultare Riferimento per i tipi di risposta.

Se vuoi utilizzare la stessa azione per un assistente che distribuisci a molte piattaforme differenti, aggiungi le risposte personalizzate per tipo di integrazione. Puoi aggiungere una risposta condizionata che indica all'assistente di mostrare la risposta solo quando viene utilizzata l'integrazione SMS.

Per la documentazione di riferimento, consultare SMS integration reference.

Risoluzione dei problemi

Trovare soluzioni ai problemi che potrebbero verificarsi durante l'utilizzo dell'integrazione.

  • Se ricevi un messaggio Forbidden, significa che il numero di telefono che hai specificato quando hai configurato l'integrazione non può essere verificato. Assicurarsi che il numero corrisponda completamente al numero di telefono SMS.

Migrazione da Voice Agent with Watson

Se hai creato un'istanza del servizio IBM® Voice Agent with Watson in IBM Cloud per consentire ai clienti di scambiare messaggi di testo con un assistente, utilizza invece l'integrazione SMS.

L'integrazione SMS fornisce un'integrazione più semplice con il tuo assistente e supporta tutti i numeri di telefono necessari. Tuttavia, attualmente l'integrazione non supporta le seguenti funzioni:

  • Avvio di un'interazione solo SMS con un testo in uscita
  • Configurazione delle ubicazioni di backup
  • Revisione della pagina di riepilogo dell'utilizzo. Utilizzare invece IBM Log Analysis.

Per migrare da Voice Agent with Watson all'integrazione watsonx Assistant SMS, completa la seguente fase:

  1. Effettua una delle operazioni riportate di seguito: