Quando in Journey Optimizer vengono create nuove credenziali API, i webhook SMS ora consentono di acquisire sia parole chiave in entrata che eventi di feedback come consegne ed errori. Poiché ogni provider dispone di funzionalità diverse, esistono istruzioni separate per abilitare i webhook.
Con i webhook che ora supportano il provider personalizzato, ora è possibile raccogliere feedback e raccolte di parole chiave in entrata da qualsiasi provider da segnalare e su cui intervenire in Journey Optimizer.
-
Nuovi clienti: Le istruzioni qui riportate possono essere seguite per configurare correttamente i webhook SMS.
-
Clienti esistenti: È possibile migrare dalle informazioni memorizzate nelle credenziali API ai webhook e non è disponibile alcuna sequenza temporale per la migrazione dei clienti. Per i clienti esistenti che desiderano effettuare la migrazione ai webhook SMS, i passaggi di migrazione devono essere eseguiti come documentato nella guida alla migrazione.
Panoramica overview
Una volta create correttamente le credenziali API, ora puoi configurare i webhook per acquisire le risposte in entrata e gestire il consenso di consenso e rinuncia e per ricevere i rapporti di consegna, comprese le conferme di lettura, se disponibili.
Durante la configurazione di un webhook, puoi definirne lo scopo in base al tipo di dati che desideri acquisire:
-
In entrata: utilizza questa opzione se desideri acquisire le risposte al consenso, come i consensi o le rinunce, e raccogliere le preferenze dell'utente.
-
Feedback: scegli questa opzione per tenere traccia degli eventi di consegna e coinvolgimento, incluse le consegne, gli errori in uscita e le conferme di lettura (se applicabili) per supportare la generazione di rapporti e l'analisi.
A seconda del provider, ci saranno diverse aspettative su ciò che deve essere configurato per avere un’implementazione SMS corretta:
-
Conversazione sinch e sinch: crea un webhook che gestisca sia gli eventi in entrata che quelli di feedback. Non è richiesta alcuna configurazione di payload.
-
Infobip: crea due webhook separati, uno per gli eventi in entrata e uno per gli eventi di feedback. Per entrambi i webhook non è richiesta alcuna configurazione di payload.
-
Twilio: i webhook non sono disponibili. La raccolta di dati in entrata e di feedback non è supportata.
-
Provider personalizzato: crea due webhook separati, uno per gli eventi in entrata e uno per gli eventi di feedback. Per il corretto funzionamento di entrambi i webhook è necessaria la configurazione del payload.
Supporto provider provider-support
La tabella seguente mostra quali provider supportano i webhook in entrata e di feedback e se è necessaria la creazione di payload:
Per i clienti che passano dalle credenziali API ai webhook SMS, le informazioni sul percorso di migrazione si trovano nella guida alla migrazione.
Crea webhook
Per conversazioni sinch e sinch create-webhook-sinch
Per Sinch e Sinch Conversational, crea un singolo webhook che gestisca sia gli eventi in entrata che quelli di feedback. Non è richiesta alcuna configurazione di payload personalizzata.
-
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: conversazionale sinch o sinch.
-
Credenziali API: scegli dall'elenco a discesa le credenziali API configurate in precedenza.
-
Numero di telefono del mittente: immettere il numero di telefono del mittente che si desidera utilizzare per le comunicazioni.
-
-
Iniziare a impostare le parole chiave in entrata immettendo le parole chiave nel campo Immettere una parola chiave. È possibile aggiungere e rimuovere più parole chiave. Si noti che le parole chiave non fanno distinzione tra maiuscole e minuscole.
-
Seleziona una categoria di parole chiave dal menu a discesa Categoria parole chiave in entrata per configurare:
-
accordion Opt-in -
Abilita le parole chiave che danno il consenso esplicito agli utenti. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il numero di telefono dell’utente acconsente alla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Subscribe, Yes, Unstop, Continue, Resume e Begin. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave Opt-in.
-
-
accordion Rinuncia -
Abilita le parole chiave che negano il consenso agli utenti e ne rimuovono l’invio. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il suo numero di telefono viene escluso dalla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Stop, Quit, Cancel, End, Unsubscribe, No. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave di rinuncia.
-
Abilita Logica Fuzzy per rilevare parole chiave simili alle parole chiave di rinuncia configurate. Se la risposta di un utente è vicina ma non esatta, viene inviato il messaggio immesso nel campo Risposta automatica fuzzy. In genere, questo messaggio indica che la rinuncia non si è verificata e specifica la parola chiave esatta necessaria per annullare l’abbonamento.
-
-
accordion Doppio consenso -
Abilita le parole chiave per il requisito del doppio consenso. In questa fase, quando il messaggio di un utente corrisponde a una parola chiave configurata, l’utente non ha prestato il consenso completo. Questo flusso di lavoro di consenso in due passaggi richiede agli utenti di confermare il consenso con una seconda parola chiave.
-
Utilizza il campo Messaggio di risposta per creare un messaggio che viene inviato automaticamente quando viene trovata una corrispondenza per una parola chiave di doppio consenso. Questo messaggio indica all'utente di immettere una parola chiave Opt-in per completare il processo di consenso.
-
-
accordion Aiuto -
Abilita le parole chiave che forniscono una risposta standard quando viene richiesta la guida. Quando il messaggio di un utente corrisponde a una parola chiave configurata, riceve il messaggio di risposta della Guida.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Guida, Informazioni, Informazioni. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizzare il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave della Guida.
-
-
accordion Personalizzato -
Configura una singola parola chiave personalizzata. Quando il messaggio di un utente corrisponde a questa parola chiave, la parola chiave viene scritta nel set di dati Tracciamento feedback messaggio per la generazione di rapporti e pubblico.
-
Crea un pubblico (in streaming o in batch) che faccia riferimento a questa parola chiave da utilizzare nei tuoi percorsi e nelle tue campagne.
-
-
-
Immetti un messaggio di risposta predefinito. Questo messaggio viene inviato automaticamente quando la risposta di un utente non corrisponde a nessuna parola chiave configurata.
-
Fai clic su Invia per salvare la configurazione del webhook.
-
Puoi modificare o eliminare i webhook esistenti dal menu Webhook.
-
Accedi al nuovo webhook creato e copia l'URL del webhook.
-
Utilizza il tuo URL webhook per abilitare gli eventi Feedback e In entrata per entrare in Journey Optimizer.
-
Per il canale SMS, ulteriori informazioni nella documentazione di Sinch
-
Per il canale MMS, ulteriori informazioni nella documentazione di Sinch
-
Per i clienti che hanno acquistato SMS direttamente tramite Journey Optimizer, crea un ticket di supporto con il supporto di Adobe. Il team dell’account Adobe configurerà l’URL del webhook per te.
-
Se il webhook utilizza credenziali API collegate a una configurazione di canale esistente, il webhook ha effetto immediato. In caso contrario, crea una nuova configurazione di canale.
Per Infobip create-webhook-infobip
Per Infobip, crea due webhook separati: uno per gli eventi di feedback e uno per gli eventi in entrata.
-
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: Infobip.
-
Tipo: scegliere Feedback o In entrata. Devi creare entrambi separatamente. In questo caso, iniziamo con In entrata.
-
Credenziali API: scegli dall'elenco a discesa le credenziali API configurate in precedenza.
-
Numero di telefono del mittente: immettere il numero di telefono del mittente che si desidera utilizzare per le comunicazioni.
-
-
Iniziare a impostare le parole chiave in entrata immettendo le parole chiave nel campo Immettere una parola chiave. È possibile aggiungere e rimuovere più parole chiave. Si noti che le parole chiave non fanno distinzione tra maiuscole e minuscole.
-
Seleziona una categoria di parole chiave dal menu a discesa Categoria parole chiave in entrata per configurare:
-
accordion Opt-in -
Abilita le parole chiave che danno il consenso esplicito agli utenti. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il numero di telefono dell’utente acconsente alla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Subscribe, Yes, Unstop, Continue, Resume e Begin. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave Opt-in.
-
-
accordion Rinuncia -
Abilita le parole chiave che negano il consenso agli utenti e ne rimuovono l’invio. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il suo numero di telefono viene escluso dalla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Stop, Quit, Cancel, End, Unsubscribe, No. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave di rinuncia.
-
Abilita Logica Fuzzy per rilevare parole chiave simili alle parole chiave di rinuncia configurate. Se la risposta di un utente è vicina ma non esatta, viene inviato il messaggio immesso nel campo Risposta automatica fuzzy. In genere, questo messaggio indica che la rinuncia non si è verificata e specifica la parola chiave esatta necessaria per annullare l’abbonamento.
-
-
accordion Doppio consenso -
Abilita le parole chiave per il requisito del doppio consenso. In questa fase, quando il messaggio di un utente corrisponde a una parola chiave configurata, l’utente non ha prestato il consenso completo. Questo flusso di lavoro di consenso in due passaggi richiede agli utenti di confermare il consenso con una seconda parola chiave.
-
Utilizza il campo Messaggio di risposta per creare un messaggio che viene inviato automaticamente quando viene trovata una corrispondenza per una parola chiave di doppio consenso. Questo messaggio indica all'utente di immettere una parola chiave Opt-in per completare il processo di consenso.
-
-
accordion Aiuto -
Abilita le parole chiave che forniscono una risposta standard quando viene richiesta la guida. Quando il messaggio di un utente corrisponde a una parola chiave configurata, riceve il messaggio di risposta della Guida.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Guida, Informazioni, Informazioni. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizzare il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave della Guida.
-
-
accordion Personalizzato -
Configura una singola parola chiave personalizzata. Quando il messaggio di un utente corrisponde a questa parola chiave, la parola chiave viene scritta nel set di dati Tracciamento feedback messaggio per la generazione di rapporti e pubblico.
-
Crea un pubblico (in streaming o in batch) che faccia riferimento a questa parola chiave da utilizzare nei tuoi percorsi e nelle tue campagne.
-
-
-
Immetti un messaggio di risposta predefinito. Questo messaggio viene inviato automaticamente quando la risposta di un utente non corrisponde a nessuna parola chiave configurata.
-
Fai clic su Invia per salvare la configurazione del webhook.
-
Nel menu Webhook è ora necessario creare un webhook Feedback per Infobip.
-
Configura le impostazioni del webhook come descritto di seguito:
-
Name: immetti un nome per il webhook.
-
Seleziona fornitore SMS: Infobip.
-
Tipo: Scegli Feedback.
-
-
Fai clic su Invia per salvare la configurazione del webhook di feedback.
-
Puoi modificare o eliminare i webhook esistenti dal menu Webhook.
-
Accedi ai nuovi webhook creati e copia l'URL del webhook da ciascuno dei tuoi webhook.
-
Ora puoi utilizzare questi URL per abilitare sia gli URL di richiamata per inviare feedback che gli eventi in entrata in Journey Optimizer.
Se il webhook utilizza credenziali API collegate a una configurazione di canale esistente, il webhook ha effetto immediato. In caso contrario, crea una nuova configurazione di canale.
Per provider personalizzato create-webhook-custom
Per i provider SMS personalizzati, crea due webhook separati: uno per gli eventi di feedback e uno per gli eventi in entrata.
-
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.
-
Tipo: scegliere Feedback o In entrata. Devi creare entrambi separatamente. In questo caso, iniziamo con In entrata.
-
Credenziali API: scegli dall'elenco a discesa le credenziali API configurate in precedenza.
-
Numero di telefono del mittente: immettere il numero di telefono del mittente che si desidera utilizzare per le comunicazioni.
-
-
Iniziare a impostare le parole chiave in entrata immettendo le parole chiave nel campo Immettere una parola chiave. È possibile aggiungere e rimuovere più parole chiave. Si noti che le parole chiave non fanno distinzione tra maiuscole e minuscole.
-
Seleziona una categoria di parole chiave dal menu a discesa Categoria parole chiave in entrata per configurare:
-
accordion Opt-in -
Abilita le parole chiave che danno il consenso esplicito agli utenti. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il numero di telefono dell’utente acconsente alla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Subscribe, Yes, Unstop, Continue, Resume e Begin. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave Opt-in.
-
-
accordion Rinuncia -
Abilita le parole chiave che negano il consenso agli utenti e ne rimuovono l’invio. Quando il messaggio di un utente corrisponde a una parola chiave configurata, il suo numero di telefono viene escluso dalla ricezione di messaggi SMS.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Stop, Quit, Cancel, End, Unsubscribe, No. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizza il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave di rinuncia.
-
Abilita Logica Fuzzy per rilevare parole chiave simili alle parole chiave di rinuncia configurate. Se la risposta di un utente è vicina ma non esatta, viene inviato il messaggio immesso nel campo Risposta automatica fuzzy. In genere, questo messaggio indica che la rinuncia non si è verificata e specifica la parola chiave esatta necessaria per annullare l’abbonamento.
-
-
accordion Doppio consenso -
Abilita le parole chiave per il requisito del doppio consenso. In questa fase, quando il messaggio di un utente corrisponde a una parola chiave configurata, l’utente non ha prestato il consenso completo. Questo flusso di lavoro di consenso in due passaggi richiede agli utenti di confermare il consenso con una seconda parola chiave.
-
Utilizza il campo Messaggio di risposta per creare un messaggio che viene inviato automaticamente quando viene trovata una corrispondenza per una parola chiave di doppio consenso. Questo messaggio indica all'utente di immettere una parola chiave Opt-in per completare il processo di consenso.
-
-
accordion Aiuto -
Abilita le parole chiave che forniscono una risposta standard quando viene richiesta la guida. Quando il messaggio di un utente corrisponde a una parola chiave configurata, riceve il messaggio di risposta della Guida.
-
Per impostazione predefinita, sono attivate le seguenti parole chiave: Guida, Informazioni, Informazioni. Rimuovere le parole chiave predefinite facendo clic su
-
Utilizzare il campo Messaggio di risposta per creare un messaggio inviato automaticamente quando il messaggio in entrata di un utente corrisponde a una parola chiave della Guida.
-
-
accordion Personalizzato -
Configura una singola parola chiave personalizzata. Quando il messaggio di un utente corrisponde a questa parola chiave, la parola chiave viene scritta nel set di dati Tracciamento feedback messaggio per la generazione di rapporti e pubblico.
-
Crea un pubblico (in streaming o in batch) che faccia riferimento a questa parola chiave da utilizzare nei tuoi percorsi e nelle tue campagne.
-
-
-
Immetti un messaggio di risposta predefinito. Questo messaggio viene inviato automaticamente quando la risposta di un utente non corrisponde a nessuna parola chiave configurata.
-
Crea un payload personalizzato che corrisponda al JSON proveniente dal provider. L’unico formato di webhook supportato è JSON. I dati modulo per i webhook non sono supportati.
Il webhook in entrata richiede i campi seguenti per ricevere valori dal webhook del provider:
- InboundMessage: messaggio in entrata o parola chiave ricevuta dall'utente.
- ProfileNumber: numero di telefono dell'utente che ha inviato il messaggio.
- RequestID: identificatore univoco fornito dal provider SMS per identificare una transazione specifica.
- OriginTimestamp: il timestamp di ricezione del messaggio, in formato UTC.
- InboundNumber: numero di telefono utilizzato per questa configurazione del webhook.
accordion Esempio di payload code language-none "json { "inboundMessage": "{{inboundMessage}}", "profileNumber": "{{profileNumber}}", "requestId": "{{requestId}}", "originTimestamp": "{{originTimestamp}}", "inboundNumber": "{{inboundNumber}}" " -
Al momento della creazione del file JSON, fai clic su Visualizza editor payload, quindi copia e incolla il payload JSON nell'editor e salvalo.
-
Fai clic su Invia per salvare la configurazione del webhook.
-
Nel menu Webhook è ora necessario creare un webhook Feedback per il provider personalizzato.
-
Configura le impostazioni del webhook come descritto di seguito:
-
Name: immetti un nome per il webhook.
-
Seleziona fornitore SMS: personalizzato.
-
Tipo: Scegli Feedback.
-
-
Crea un payload personalizzato corrispondente al formato JSON dal provider. L’unico formato di webhook supportato è JSON. I dati modulo per i webhook non sono supportati.
Il webhook di feedback richiede i campi seguenti per ricevere valori dal webhook del provider:
- Riferimento client: un identificatore univoco restituito nel payload a scopo di registrazione.
- Codice: codice di errore fornito dal provider SMS.
- Stato: lo stato di errore fornito dal provider SMS.
accordion Esempio di payload code language-none "json { "clientReference": "{{client_reference}}", "stati": [ { "codice": "{{failureCode}}", "stato": "{{feedbackStatus}}" ] } " -
Fai clic su Visualizza editor payload, quindi copia e incolla il payload JSON nell'editor e salvalo.
-
Fai clic su Invia per salvare la configurazione del webhook di feedback.
-
Puoi modificare o eliminare i webhook esistenti dal menu Webhook.
-
Accedi ai nuovi webhook creati e copia l'URL del webhook da ciascuno dei tuoi webhook.
-
Configura il provider SMS per inviare Feedback e eventi in entrata a questi URL del webhook in Journey Optimizer.
Le istruzioni di configurazione variano a seconda del provider SMS. Per informazioni dettagliate sulla configurazione degli URL di callback, consulta la documentazione del provider.
Se il webhook utilizza credenziali API collegate a una configurazione di canale esistente, il webhook ha effetto immediato. In caso contrario, crea una nuova configurazione di canale.