DocumentazioneJourney OptimizerGuida di Journey Optimizer

Configurare un provider personalizzato sms-configuration-custom

Last update: Thu Feb 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Intermedio
  • Amministratore

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:

  1. Crea credenziali API
  2. Creare webhook
  3. Crea configurazione canale
  4. Creare un Percorso o una campagna con un’azione del canale SMS

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. Abilitare l'opzione supporto mTLS, che garantisce che il client e il server si autentichino a vicenda prima di stabilire una connessione sicura.

    Per utilizzare solo mTLS, selezionare Nessuna autenticazione dal menu a discesa Tipo di autenticazione, quindi abilitare il supporto mTLS.

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

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

    note note
    NOTE
    Durante la configurazione di un provider SMS personalizzato con autenticazione di base o Bearer, è necessario includere il parametro authOption nel payload JSON. Inoltre, il payload Provider deve fare riferimento alle variabili di modello {{fromNumber}}, {{toNumber}} e {{message}}.

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

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

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

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

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

Video introduttivo video

https://video.tv.adobe.com/v/3431625
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76