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:

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

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

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

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

  5. Fai clic su Invia al termine della configurazione delle credenziali API.

  6. Nel menu Credenziali API, fai clic sull'icona raccoglitore per eliminare le credenziali API.

  7. Per modificare le credenziali esistenti, individuare le credenziali API desiderate e fare clic sull'opzione Modifica per apportare le modifiche necessarie.

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

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

Chiave API

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.

Autenticazione MAC

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.

Autenticazione OAuth

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 e client_secret.

Autenticazione JWT

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

recommendation-more-help

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.

  1. Nella barra a sinistra, passa a Amministrazione > Canali, seleziona il menu Webhook SMS in Impostazioni SMS e fai clic sul pulsante Crea webhook.

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

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

  4. Fai clic su Invia al termine della configurazione del webhook.

  5. Nel menu Webhook, fai clic sull'icona bin per eliminare il tuo webhook.

  6. Per modificare la configurazione esistente, individuare il webhook desiderato e fare clic sull'opzione Modifica per apportare le modifiche necessarie.

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

Video dimostrativo video

b22c9c5d-9208-48f4-b874-1cefb8df4d76