Configurare un provider personalizzato sms-configuration-custom
Questa funzione consente di integrare e configurare i provider di messaggistica, offrendo flessibilità oltre le opzioni predefinite (Sinch, Twilio e Infobip). Questo consente di gestire in modo semplice l’authoring, la consegna, il reporting e il consenso sia per i messaggi SMS che per quelli RCS.
Con la configurazione del provider personalizzato, puoi collegare servizi di messaggistica di terze parti direttamente in Journey Optimizer, personalizzare i payload dei messaggi per il contenuto dinamico e gestire le preferenze di consenso/rinuncia per garantire la conformità sia sui canali SMS che RCS.
Per configurare il provider personalizzato, effettua le seguenti operazioni:
Creare le credenziali API api-credential
Per inviare messaggi SMS e RCS in Journey Optimizer utilizzando un provider personalizzato non disponibile da Adobe (ad esempio Sinch, Infobip, Twilio), procedi come segue:
-
Nella barra a sinistra, passa a Amministrazione
>
Canali, seleziona il menu Credenziali API in Impostazioni SMS e fai clic sul pulsante Crea nuove credenziali API. -
Configura le credenziali API SMS, come descritto di seguito:
-
Fornitore SMS: personalizzato.
-
Nome: immetti un nome per le credenziali API.
-
Provider AppId: immetti l'ID applicazione fornito dal provider SMS.
-
Nome provider: immetti il nome del provider SMS.
-
URL provider: immetti l'URL del provider SMS.
-
Tipo di autenticazione: seleziona il tipo di autorizzazione e completa i campi corrispondenti in base al metodo di autenticazione scelto.
-
-
Nella sezione Intestazioni, fai clic su Aggiungi nuovo parametro per specificare le intestazioni HTTP per il messaggio di richiesta che verrà inviato al servizio esterno.
I campi di intestazione Content-Type e Charset sono impostati per impostazione predefinita e non possono essere eliminati.
-
Aggiungi il Payload provider per convalidare e personalizzare i payload della richiesta.
Per i messaggi RCS, questo payload viene utilizzato successivamente durante la progettazione del contenuto.
-
Fai clic su Invia al termine della configurazione delle credenziali API.
-
Nel menu Credenziali API, fai clic sull'icona
-
Per modificare le credenziali esistenti, individuare le credenziali API desiderate e fare clic sull'opzione Modifica per apportare le modifiche necessarie.
-
Fai clic su Verifica connessione SMS, dalle credenziali API esistenti, per verificare le credenziali API SMS inviando un messaggio di esempio a un dispositivo designato.
-
Compila i campi Numero e Messaggio e fai clic su Verifica connessione.
note important IMPORTANT Il messaggio deve essere strutturato in modo da essere allineato al formato di payload del provider.
Dopo aver creato e configurato le credenziali API, devi ora impostare le impostazioni in entrata per il webhook per i messaggi SMS.
Opzioni di autenticazione per i provider SMS personalizzati auth-options
Una volta create le credenziali API, completa i campi necessari per l’autenticazione della chiave API:
- Nome : immetti un nome per la configurazione della chiave API.
- Token API : immetti il token API fornito dal provider SMS.
Una volta create le credenziali API, completa i campi richiesti per l’autenticazione MAC:
- Nome : immetti un nome per la configurazione dell'autenticazione MAC.
- Token API : immetti il token API fornito dal provider SMS.
- Chiave segreta API: immetti la chiave segreta API fornita dal provider SMS. Questa chiave viene utilizzata per generare il MAC (Message Authentication Code) per le comunicazioni protette.
- Formato hash di autorizzazione Mac: scegliere il formato hash per l'autenticazione MAC.
Una volta create le credenziali API, completa i campi necessari per l’autenticazione OAuth:
-
Nome : immetti un nome per la configurazione dell'autenticazione OAuth.
-
Token API : immetti il token API fornito dal provider SMS.
-
URL OAuth : immetti l'URL per ottenere il token OAuth.
-
Corpo OAuth : fornisci il corpo della richiesta OAuth in formato JSON, inclusi parametri come
grant_type
,client_id
eclient_secret
.
Una volta create le credenziali API, completa i campi richiesti per l’autenticazione JWT:
-
Nome : immetti un nome per la configurazione dell'autenticazione JWT.
-
Token API : immetti il token API fornito dal provider SMS.
-
Payload JWT : inserisci il payload JSON contenente le attestazioni richieste per JWT, ad esempio emittente, oggetto, pubblico e scadenza.
Creare webhook webhook
Se non vengono fornite parole chiave di consenso o rinuncia, vengono utilizzati messaggi di consenso standard per rispettare la privacy dell’utente. L'aggiunta di parole chiave personalizzate sostituisce automaticamente le impostazioni predefinite.
Parole chiave predefinite:
- Consenso: SOTTOSCRIVI, SÌ, RIPRENDI, AVVIA, CONTINUA, RIPRENDI, INIZIA
- Rinuncia: INTERROMPI, ESCI, ANNULLA, TERMINA, ANNULLA ISCRIZIONE, NO
- Guida: GUIDA
Una volta create correttamente le credenziali API, il passaggio successivo consiste nel creare un webhook e configurare le impostazioni in entrata. Questa configurazione garantisce che il sistema possa ricevere ed elaborare correttamente i dati o i messaggi in arrivo.
-
Nella barra a sinistra, passa a Amministrazione
>
Canali, seleziona il menu Webhook SMS in Impostazioni SMS e fai clic sul pulsante Crea webhook. -
Configura le impostazioni del webhook come descritto di seguito:
-
Name: immetti un nome per il webhook.
-
Seleziona fornitore SMS: personalizzato.
-
Seleziona credenziali API: scegli dall'elenco a discesa le credenziali API configurate in precedenza.
-
Parole chiave di consenso: immetti le parole chiave predefinite o personalizzate che attiveranno automaticamente il messaggio di consenso. Per più parole chiave, utilizza valori separati da virgola.
-
Messaggio Opt-in: immetti la risposta personalizzata inviata automaticamente come messaggio Opt-in.
-
Parole chiave di rinuncia: immetti le parole chiave predefinite o personalizzate che attiveranno automaticamente il messaggio di rinuncia. Per più parole chiave, utilizza valori separati da virgola.
-
Messaggio di rinuncia: immetti la risposta personalizzata inviata automaticamente come messaggio di rinuncia.
-
-
Fai clic su Visualizza editor payload per convalidare e personalizzare i payload della richiesta.
Puoi personalizzare dinamicamente il payload utilizzando gli attributi del profilo e garantire che vengano inviati dati accurati per l’elaborazione e la generazione di risposte con l’aiuto di funzioni di assistenza integrate.
-
Fai clic su Invia al termine della configurazione del webhook.
-
Nel menu Webhook, fai clic sull'icona
-
Per modificare la configurazione esistente, individuare il webhook desiderato e fare clic sull'opzione Modifica per apportare le modifiche necessarie.
-
Accedi e copia il nuovo URL webhook dal webhook inviato in precedenza.
Dopo aver creato e configurato le impostazioni in entrata per il webhook, è ora necessario creare una configurazione del canale per i messaggi SMS.
Una volta configurata, puoi sfruttare tutte le funzionalità di canale predefinite, come l’authoring dei messaggi, la personalizzazione, il tracciamento dei collegamenti e il reporting.