Utilizzo del proprio fornitore di SMS
Informazioni sull’utilizzo del proprio provider SMS
Con le distribuzioni SMS, puoi inviare sondaggi o link al sondaggio direttamente ai telefoni dei tuoi intervistati tramite testo. Molti clienti scelgono di utilizzare l’impostazione preconfigurata di Qualtrics, ma se la tua azienda ha una relazione preesistente con un fornitore di SMS, è possibile utilizzarla per inviare invece distribuzioni SMS in Qualtrics.
Qualtrics non consiglia alcun fornitore rispetto a un altro, ma consigliamo ai clienti di ricercare il fornitore di servizi migliore per la loro attività. Tutti i provider elencati in questa pagina possono essere integrati con Qualtrics, ma la copertura e la disponibilità delle funzioni possono variare in diverse regioni e paesi.
Dove nella piattaforma è possibile utilizzare il proprio provider SMS
È possibile configurare il proprio provider SMS per qualsiasi progetto o funzionalità compatibile con SMS. Sono inclusi:
- SMS in un progetto di sondaggio
- Directory XM
- Directory XM Lite
- Progetti Employee Experience compatibili
Configurazione dell’amministratore richiesta in Qualtrics
- Le distribuzioni SMS costituiscono una funzione aggiuntiva non inclusa nella licenza standard di Qualtrics. Assicurarsi che la licenza contenga SMS. È possibile confermarlo con il proprio Account Executive.
- Contatta il tuo Account Executive e chiedi loro di inviarti il plugin per il provider SMS che hai scelto. I fornitori attualmente supportati includono:
- Twilio
- Collega mobilità
- Sinch LiveLink
- Infobip
- MessageMedia
- Vonage
- MessageBird
Attenzione: se sei interessato a utilizzare un provider SMS non presente nell’elenco, contatta il tuo Account Executive per abilitare il tuo fornitore di servizi preferito.
- Accedi al tuo account Qualtrics.
- Utilizzare il menu di navigazione per passare ad Amministrazione.
- Fare clic su Estensioni.
- Utilizzare la barra di ricerca per trovare il fornitore SMS.
- Fare clic sul nome dell’estensione.
- Fare clic su Aggiungi account.
- Compila tutti i campi necessari per connettere il tuo account a Qualtrics. Consultare le seguenti guide per i campi specifici del fornitore SMS:
Twilio
Questa sezione descrive i passaggi da eseguire per collegare il tuo account Twilio a Qualtrics.
Passi in Qualtrics
Chiedi a un amministratore della licenza di completare le fasi richieste in Qualtrics.
Questi sono i campi che il tuo Amministratore della licenza dovrà compilare per connettere un account Twilio.
- Nome: inserisci qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve o a cosa serve questa connessione.
- SID account: SID account Twilio utilizzato per accesso API. È possibile trovarlo nel dashboard dopo aver eseguito l’accesso a Twilio.
- Token di autorizzazione: token di autenticazione Twilio utilizzato per l’accesso API. È possibile trovarlo nel dashboard dopo aver eseguito l’accesso a Twilio.
- Numero di telefono, ID mittente o ID servizio di messaggistica Twilio: il numero o l’ID che verrà utilizzato come numero ‘DA’ quando si invia un messaggio SMS. Può trattarsi di uno dei seguenti elementi:
- Un numero specifico, ad esempio 13531234567. Deve trattarsi di un numero acquistato nel tuo account Twilio. Includere sempre il codice paese all’inizio del numero.
Qtip: è anche possibile utilizzare codici brevi. Per maggiori dettagli consulta la documentazione di Twilio.
- Un ID mittente alfanumerico, ad es. Qualtrics. Tenere presente che questa configurazione deve essere configurata in Twilio per essere supportata. Consultare la documentazione di Twilio.
- Un ID servizio di messaggistica Twilio. Consultare la documentazione di Twilio sui servizi di messaggistica. Gli ID servizio di messaggistica iniziano con MG e si trovano nella sezione Proprietà della scheda Servizio di messaggistica dopo aver eseguito il login a Twilio.
Qtip: l’ID servizio di messaggistica Twilio offre il massimo controllo sui numeri regionali e sull’instradamento intelligente.
- Un numero specifico, ad esempio 13531234567. Deve trattarsi di un numero acquistato nel tuo account Twilio. Includere sempre il codice paese all’inizio del numero.
Dopo aver collegato un account Twilio, segui questi passaggi e seleziona Dai l’accesso a tutti gli utenti.
Passi in Twilio
Dovrai impostare webhook per i tuoi numeri o servizi di messaggistica. Per ulteriori informazioni consultare i webhook di Twilio qui.
Configurazione di Webhook
L’URL del webhook è il seguente. Tieni presente che diversi parametri devono essere modificati con le informazioni della tua licenza / marchio Qualtrics.
https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receiver/Distribution/message/twilio-sms/<ID organizzazione>
Il metodo deve essere HTTP/POST.
Configurazione di Webhook per NumbersPer
configurare il webhook in Twilio per un numero:
- Selezionare Numeri manager.
- Passare alla sezione Numeri attivi.
- Selezionare il numero da configurare.
- Nell’intestazione Messaggistica, scegliere di configurare con Webhook.
- Impostare il messaggio su Webhook, impostare l’URL su quanto segue, con la < > e tutto ciò che è all’interno sostituito con i parametri dell’organizzazione:
https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receiver/Distribution/message/twilio-sms/<ID organizzazione> - Assicurarsi che sia contrassegnato come metodo HTTP/POST.
- È anche possibile specificare che l’URL di backup (cosa fare se “Gestore principale non riesce”) deve essere lo stesso URL e metodo.
Configurazione di Webhooks per un servizio di messaggistica Se
i numeri sono stati configurati per utilizzare un servizio di messaggistica, si aggiungeranno webhook in modo diverso rispetto a un singolo numero.
Nella console di Twilio:
- Selezionare Messaggi programmabili.
- Selezionare il servizio di messaggistica che si desidera configurare o crearne uno nuovo. Per ulteriori dettagli, consultare la documentazione di supporto Twilio.
- Dopo aver selezionato il servizio di messaggistica, selezionare la sezione Integrazione.
- È necessario configurare i messaggi in entrata in modo che includano l’URL sopra indicato con i parametri dell’organizzazione.
- Assicurarsi che sia contrassegnato come metodo HTTP/POST.
- È anche possibile specificare che l’URL di backup sia lo stesso URL e lo stesso metodo.
Collega mobilità
Questa sezione descrive i passaggi da eseguire per collegare il tuo account Link Mobility a Qualtrics.
FASI IN QUALTRICS
Chiedi a un amministratore della licenza di completare le fasi richieste in Qualtrics.
Questi sono i campi che il tuo Amministratore della licenza dovrà compilare per collegare un account Link Mobility.
- Nome: inserisci qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve o a cosa serve questa connessione.
- Nome utente: nome utente dell’account Link Mobility.
- Password: la password del tuo account Link Mobility.
- Numero di telefono/ID mittente: il numero o l’ID che verrà utilizzato come numero ‘DA’ quando si invia un messaggio SMS. Può trattarsi di uno dei seguenti elementi:
- Un numero specifico, ad es. +35312345678. Includere sempre un segno più ( + ) e il codice paese all’inizio del numero.
- Un ID mittente alfanumerico, ad es. Qualtrics. Tenere presente che questa configurazione deve essere configurata in Link Mobility per essere supportata.
- ID piattaforma fornito da Link Mobility: l’ID piattaforma fornito da Link Mobility.
- ID partner della piattaforma fornito da Link Mobility: l’ID partner della piattaforma fornito da Link Mobility.
Qtip: se hai bisogno di aiuto per i risultati di questi ID, ti consigliamo di contattare il team di supporto di Link Mobility.
- Host del punto finale fornito da Link Mobility: host del punto finale fornito da Link Mobility. Includere solo l’ospite base dell’ur. Ad esempio, https://wsx.sp247.net/sms diventa wsx.sp247.net.
- ID del gate fornito da Link Mobility: l’ID del gate fornito da Link Mobility. Le credenziali per questo GateID devono corrispondere al nome utente e alla password a scopo di autenticazione.
Dopo aver connesso un account Link Mobility, attenersi alla seguente procedura e selezionare Concedere l’accesso a tutti gli utenti.
Sinch
Questa sezione descrive i passaggi da seguire per collegare il tuo account Sinch a Qualtrics.
COSTITUZIONE DELL’ESTENSIONE DELLA QUALTRICS
Chiedi a un amministratore della licenza di completare le fasi richieste in Qualtrics.
COSTITUIRE IL TUO ACCOUNT DI PROVA
Per abilitare il reporting dello stato, passare alla sezione webhook dell’app API di conversazione e selezionare ‘Add Webhook’.
- Il tipo di destinazione deve essere HTTP.
- L’URL di destinazione deve essere nel formato “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/status/sinch/<OrganizationID>“
- Il token segreto dovrebbe essere un segreto da generare e utilizzare sia per il reporting di stato che per l’SMS bidirezionale. Prendi nota di questo poiché dovrai utilizzarlo quando configuri la tua estensione in Qualtrics.
- I trigger devono essere EVENT_DELIVERY e MESSAGE_DELIVERY
- Il tipo di destinazione deve essere HTTP.
- L’URL di destinazione deve essere nel formato “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/sinch/<OrganizationID>”
- Il token segreto dovrebbe essere un segreto da generare e utilizzare sia per il reporting di stato che per l’SMS bidirezionale. Prendi nota di questo poiché dovrai utilizzarlo quando configuri la tua estensione in Qualtrics.
- I trigger devono essere MESSAGE_INBOUND
CONNESSIONE DELL’ACCOUNT DI PROVA A QUALTRICS
Questi sono i campi che il tuo Amministratore della licenza dovrà compilare per collegare un account Sinch.
- Nome: immettere qualsiasi nome che consentirà di identificare in seguito a cosa serve questa connessione/a cosa serve.
- ID client OAuth: può essere creato nel dashboard dopo l’accesso a Sinch. Verrà creata una coppia di ID client e Chiave segreta, l’ID client deve essere inserito qui e la chiave segreta di seguito.
- Chiave segreta client OAuth: la chiave segreta della coppia ID client/chiave segreta creata sopra.
- Sinch Account DataCenter (EU o US): la regione in cui si trova l’app API Conversation. Questo può essere trovato sul cruscotto dopo aver effettuato l’accesso a Sinch.
- ID progetto Sinch Account: il tuo ID progetto account Sinch. È possibile trovarlo nel dashboard dopo aver eseguito l’accesso a Sinch.
- Numero di telefono o ID mittente: il numero o l’ID che verrà utilizzato come numero ‘DA’ quando si invia un messaggio SMS. Può trattarsi di uno dei seguenti elementi:
- Un numero specifico, ad esempio 35312345678. Includere sempre il codice paese all’inizio.
- Un ID mittente alfanumerico, ad es. Qualtrics.
- Sinch Conversational App ID: l’ID dell’app Conversation API. È possibile trovarlo nel dashboard dopo aver eseguito l’accesso a Sinch.
- Token segreto Webhook: questo è il segreto creato durante la configurazione dei webook per la creazione di report di stato e messaggi bidirezionali.
Dopo aver connesso un account Sinch, seguire questi passaggi e selezionare Concedere l’accesso a tutti gli utenti.
Infobip
Questa sezione descrive i passaggi da seguire per collegare il tuo account Infobip a Qualtrics.
Passi in Qualtrics
Questi sono i campi che il tuo Amministratore della licenza dovrà compilare per connettere un account Infobip.
- Nome: inserisci qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve o a cosa serve questa connessione.
- Chiave API pubblica: la tua chiave API Infobip. Per generare una chiave, accedere al proprio portale Infobip e fare clic su Nuova chiave API. Se si dispone già di una chiave API, copiare la chiave esistente invece di generarne una nuova.
- Password Webhook: fornire il nome utente e la password Infobip nei campi password e nome utente Webhook. Al termine di questa configurazione, contattare il supporto Infobip e chiedere di impostare l’autenticazione di base per il webhook. Sarà necessario fornire loro un nome utente e una password da utilizzare. Non utilizzare caratteri speciali nel nome utente.
- Nome utente Webhook: vedi password webhook sopra.
- URL di base fornito da Infobip: il tuo URL di base Infobip. Per trovare l’URL, accedere al proprio portale Infobip e copiare l’URL di base API. Quando incolla il tuo URL in Qualtrics, rimuovi la parte https:// dell’URL.
- Numero di telefono o ID mittente: il numero o l’ID che sarà il numero “DA” all’invio di SMS. Per trovare il tuo numero di telefono / ID mittente, accedi al tuo portale Infobip. Quando si aggiunge il numero o l’ID, non aggiungere prefissi (+ o 00). Può trattarsi di uno dei seguenti elementi:
- Un numero specifico, ad esempio 13531234567. Deve trattarsi di un numero acquistato nel tuo account Infobip. Includere sempre il codice paese all’inizio del numero.
- Un ID mittente univoco, alfanumerico o numerico, ad es. QUALTRICS o 868686.
Consiglio Q: Se si intende utilizzare SMS a 2 vie, sarà necessario utilizzare un numero specifico e non un ID alfanumerico.
Quando contatti il supporto Infobip dovrai fornire loro gli URL del webhook. Per abilitare il reporting dello stato, l’URL webhook sarà nel formato:
- https://<DatacenterID> .qualtrics.com/distribution-providers/v1/receiver/Distribution/status/infobip-sms/<OrganizationID>
Per abilitare l’SMS bidirezionale, l’URL webhook sarà nel formato:
- https://<DatacenterID> .qualtrics.com/distribution-providers/v1/receiver/Distribution/message/infobip-sms/<OrganizationID>
Dopo aver connesso un account InfoBip, attenersi alla seguente procedura e selezionare Concedere l’accesso a tutti gli utenti.
MessageMedia
Questa sezione descrive i passaggi da eseguire per collegare il tuo account MessageMedia a Qualtrics.
Configurazione del tuo account MessageMedia
Per ottenere credenziali importanti che ti permetteranno di connetterti Qualtrics, devi prima creare una nuova chiave nel tuo account MessageMedia.
Attenersi alla procedura seguente per creare la chiave in Autenticazione standard.
Salvare la chiave API e la chiave segreta. La chiave fungerà da nome utente e il segreto fungerà da password quando ti connetti a Qualtrics.
Impostazione dell’estensione Qualtrics
Chiedi a un amministratore della licenza di completare le fasi richieste in Qualtrics.
Questi sono i campi che l’Amministratore della licenza dovrà compilare per connettere un account MessageMedia.
- Nome: immettere qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve questa connessione o a cosa serve.
- Nome utente: la tua chiave API MessageMedia.
- Password: Il tuo MessageMedia API Secret.
- Numero di telefono, Mittente alfanumerico: il numero o l’ID che verrà utilizzato come numero “FROM” quando si invia un messaggio SMS. Può trattarsi di uno dei seguenti elementi:
- Un numero specifico, ad esempio 35312345678.
- Un ID mittente alfanumerico, ad es. Qualtrics.
Qtip: Se vuoi utilizzare SMS bidirezionali (SMS interattivi), dovrai utilizzare un numero specifico e non un ID mittente alfanumerico.
- Enterprise Webhook – Chiave pubblica: la chiave pubblica utilizzata per verificare i callback e gli SMS a 2 vie. Per ottenere questa chiave, contatta il tuo rappresentante MessageMedia.
Dopo aver connesso un account MessageMedia, attenersi alla seguente procedura e selezionare Concedere l’accesso a tutti gli utenti.
Vonage
Questa sezione descrive i passaggi da eseguire per collegare il tuo account Vonage a Qualtrics.
Passi in Qualtrics
Questi sono i campi che l’amministratore della licenza dovrà compilare per collegare un account Vonage.
- Nome: inserisci qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve o a cosa serve questa connessione.
- SID account: ID account Vonage.
- Token di autenticazione: token di autenticazione Vonage utilizzato per l’accesso API. Puoi trovarlo sulla tua dashboard dopo aver effettuato l’accesso a Vonage.
- Numero di telefono, ID mittente o ID Vonage MessageService: il numero o l’ID che verrà utilizzato come numero “FROM” quando si invia un messaggio SMS. Può trattarsi di una delle seguenti opzioni:
- Un numero specifico, ad esempio 35312345678. Includere sempre il codice paese all’inizio, ma non includere altri prefissi (+ o 00).
- Un ID mittente alfanumerico, ad es. Qualtrics.
Qtip: se intendi utilizzare un SMS bidirezionale, dovrai utilizzare un numero specifico e non un ID mittente alfanumerico.
- Signature Secret: il segreto che viene utilizzato per generare la firma webhook.
Dopo aver connesso un account Vonage, seguire questi passaggi e selezionare Concedere l’accesso a tutti gli utenti.
MessageBird
Questa sezione descrive i passaggi da eseguire per collegare il tuo account MessageBird a Qualtrics.
Passi in Messagebird
Un amministratore MessageBird dovrà eseguire i seguenti passaggi prima di connettere l’account MessageBird.
- Accedi a Messagebird.
- Passare alla scheda Sviluppatori.
- Fare clic su Impostazioni API.
- Immettere l‘URL dei rapporti di stato. L’URL deve avere il seguente formato: https://DatacenterID.qualtrics.com/distribution-provider/v1/recepimento/distribuzione/stato/twilio-sms/ID organizzazione.
Suggerimento: per trovare il tuo datacenter e gli ID dell’organizzazione, consulta Trovare gli ID Qualtrics.
Se si prevede di utilizzare SMS bidirezionali, è necessario completare i seguenti passaggi aggiuntivi:
- Passare alla scheda Flow Builder.
- Fare clic su Crea nuovo flusso.
- Selezionare Schemi.
- Selezionare Chiamare punto finale HTTP con modello SMS.
- Per il Metodo, selezionare POST.
- Per l’URL, inserire l’URL nel seguente formato. https://DatacenterID>.qualtrics.com/distribution-provider/v1/receiver/Distribution/message/twilio-sms/OrganizationID.
Suggerimento: per trovare il tuo datacenter e gli ID dell’organizzazione, consulta Trovare gli ID Qualtrics.
- Fai clic su Salva.
- Pubblicare il flusso.
Passi in Qualtrics
Questi sono i campi che l’Amministratore della licenza dovrà compilare per connettere un account MessageBird.
- Nome: immettere qualsiasi nome che ti aiuterà a identificare in seguito a cosa serve questa connessione o a cosa serve.
- Chiave di firma: chiave di firma MessageBird utilizzata per la verifica dei messaggi in entrata. Puoi trovarlo nella sezione Sviluppatore del tuo account MessageBird.
- Token di accesso: token di accesso MessageBird utilizzato per l’accesso API. Puoi trovarlo sulla tua dashboard dopo aver effettuato l’accesso a MessageBird.
- Numero di telefono o ID mittente: il numero o l’ID che verrà utilizzato come numero ‘DA’ quando si invia un messaggio SMS. Può trattarsi di una delle seguenti opzioni:
-
- Un numero specifico, ad esempio 35312345678. Includere sempre il codice paese all’inizio, ma non includere altri prefissi (+ o 00).
- Un ID mittente alfanumerico, ad es. QUALTRICS.
Qtip: se intendi utilizzare un SMS bidirezionale, dovrai utilizzare un numero specifico e non un ID mittente alfanumerico. -
Dopo aver connesso un account MessageBird, attenersi alla seguente procedura e selezionare Concedere l’accesso a tutti gli utenti.