Creare una campagna in uscita con trigger di eventi utilizzando le API

Creare una campagna in uscita utilizzando i trigger di eventi

Imposta i trigger degli eventi in Connect Customer sito web di amministrazione

Nella pagina Impostazione della campagna, seleziona Evento cliente in Destinatari.
Seleziona un’Origine evento per specificare da dove provengono i dati e configura le condizioni degli attributi che attiveranno il trigger di eventi.

Le origini degli eventi si basano sulle integrazioni nel dominio Customer Profiles. Per informazioni dettagliate sulla configurazione di un’applicazione esterna, consulta Integrazione con applicazioni esterne. Puoi anche eseguire integrazioni con Kinesis o S3.
Seleziona Modalità di consegna e le impostazioni di comunicazione aggiuntive.

Importante
Per creare una campagna con widget di comunicazione, devi disporre di un'integrazione dei profili dei clienti tra il dominio Customer Profiles e la tua istanza. Il nome del tipo di oggetto richiesto èCampaign-WebNotification. Puoi farlo scegliendo il pulsante di aggiornamento nella console del sito Web di Connect Customer amministrazione, selezionando l'istanza e quindi andando alla sottopagina Campagne in uscita.

È possibile scegliere tra due tipi di notifica: Visualizza e Azione.
Visualizzazione
Una notifica di visualizzazione mostra un messaggio visivo o un prompt sopra il pulsante del widget di comunicazione. Presenta informazioni all'utente finale, come un saluto, un'offerta o un messaggio contestuale. La notifica invita l'utente finale a impegnarsi in una conversazione con un agente o un bot.

Seleziona Visualizza se desideri mostrare un messaggio, una promozione o un suggerimento contestuale all'utente finale prima che inizi una conversazione. In questo modo l'utente finale ha un momento per leggere e decidere se interagire.

Esempi:
Un banner proattivo che dice «Ciao! Abbiamo notato che sei su questa pagina da un po' di tempo. Hai bisogno di aiuto per trovare il piano giusto?»

Un messaggio promozionale: «Offerta limitata nel tempo: chatta con noi per ottenere il 20% di sconto sul tuo upgrade».

Un suggerimento contestuale: «Hai problemi a completare l'ordine? Siamo qui per aiutarti».
Azione
Una notifica di azione ignora qualsiasi messaggio visivo e attiva immediatamente l'apertura del widget di comunicazione e avvia una conversazione direttamente con un bot o un agente umano.

Seleziona Azione se desideri saltare completamente la fase di notifica e avviare l'utente finale direttamente in una conversazione dal vivo. Non viene visualizzato alcun messaggio intermedio.

Esempi:
Il sistema collega immediatamente un cliente con intenzioni elevate su una pagina di pagamento a un agente dell'assistenza.

Il sistema indirizza un cliente abituale con un caso aperto direttamente in un flusso di bot per verificarne lo stato.

Un cliente VIP attiva una connessione istantanea a un agente dedicato quando visita la pagina di aiuto.
Dopo aver scelto un tipo di notifica, puoi selezionare un programma di raccomandazione.
(Facoltativo) Configura la sezione Consigli per integrare Predictive Insights con la tua campagna attivata da eventi. Ciò consente di fornire contenuti modello personalizzati tramite canali e-mail e SMS.

Configura le impostazioni seguenti:
- Nome del segnalatore: seleziona il nome del consulente che desideri utilizzare per generare consigli per i profili associati alla campagna. Puoi utilizzare solo i consiglieri attivi per generare consigli.
  
  Predictive Insights offre diversi tipi di consigli. Per ulteriori informazioni, consulta Fase 3: Creazione di informazioni predittive.
- Attributo calcolato per il consulente: questa impostazione è richiesta solo quando si utilizza un tipo di raccomandazione per articoli simili o Articoli associati frequentemente. Questo contesto aiuta il motore di raccomandazione a capire su quale prodotto basare i suggerimenti, offrendo consigli più pertinenti e mirati per i clienti.
  
  Ad esempio, potresti utilizzare un attributo calcolato come _last_interacted_item_id quello che acquisisce l'ID dell'articolo acquistato.
- Numero di consigli: il numero massimo di consigli da generare per un profilo. Questo valore può variare da 1 a 3 consigli.
- Attributi dei consigli: definisci quali attributi della risposta ai consigli vengono utilizzati nel modello di messaggio.
Per ulteriori informazioni su Predictive Insights, consultaInizia a usare Predictive Insights.
Verifica le configurazioni e scegli Pubblica.

Creare campagne in uscita con trigger di eventi utilizzando le API

API di attivazione degli eventi Connect Customer Customer Profiles

Vengono effettuate due chiamate API per creare un trigger di evento funzionante:
- CreateEventTrigger: definisce l'azione da eseguire in base a una condizione specificata.
- PutIntegration: definisce l'azione da utilizzare.

Esempio di richiesta di un trigger di eventi:


{
"Description": "string",
"EventTriggerConditions": [
{
"EventTriggerDimensions": [
{
"ObjectAttributes": [
{
"ComparisonOperator": "string",
"FieldName": "string",
"Source": "string",
"Values": [ "string" ]
}
]
}
],
"LogicalOperator": "string"
}
],
"EventTriggerLimits": {
"EventExpiration": number,
"Periods": [
{
"MaxInvocationsPerProfile": number,
"Unit": "string",
"Unlimited": boolean,
"Value": number
}
]
},
"ObjectTypeName": "string",
"SegmentFilter": "string",
"Tags": {
"string" : "string"
}
}

ComparisonOperator supporta i seguenti valori:

ComparisonOperator	Comment	Tipo supportato
INCLUSIVE	Verifica se la destinazione include tutti i valori specificati.	Stringa
ESCLUSIVO	Verifica se la destinazione non contiene tutti i valori specificati.	Stringa
CONTAINS	Verifica se la destinazione contiene uno o più dei valori specificati.	Stringa
BEGINS_WITH	Verifica se la destinazione inizia con il valore specificato.	Stringa
ENDS_WITH	Verifica se la destinazione finisce con il valore specificato.	Stringa
MAGGIORE DI	True se la destinazione è maggiore del valore specificato.	Numero
MINORE_DI	True se la destinazione è minore del valore specificato.	Numero
GREATER_THAN_OR_EQUAL	True se la destinazione è maggiore o uguale al valore specificato.	Numero
LESS_THAN_OR_EQUAL	True se la destinazione è minore o uguale al valore specificato.	Numero
EQUAL	True se la destinazione è uguale al valore specificato.	Numero
TRA	True se la destinazione è compresa in un determinato intervallo di valori o timestamp.	Number/Date*
NOT_BETWEEN	True se la destinazione non è compresa in un determinato intervallo di valori o timestamp.	Number/Date*
PRIMA	True se la destinazione è precedente al timestamp specificato.	Data
DOPO	True se la destinazione è successiva al timestamp specificato.	Data
SU	True se la destinazione corrisponde al timestamp specificato.	Data

Source: consente di definire un attributo nell’oggetto.
- È consentito un solo attributo in una singola voce ObjectAttribute.
FieldName: utilizzato per indicare l'attributo mappato nella mappatura dei dati.
- È consentito un solo attributo in una singola voce ObjectAttribute.
ObjectTypeName: supporta tutti i nomi dei tipi di oggetto predefiniti e personalizzati, ma non i tipi di oggetto standard, come_profile, _asset_order, e altri.
EventTriggerLimits:
- Per impostazione predefinita, consente un massimo di 20 trigger di eventi simultanei per dominio del cliente.
- Limite predefinito di 10 invocazioni al giorno, per profilo, per trigger. È possibile ignorare questa impostazione specificando UNLIMITED in MaxInvocationPerProfile.
- MaxInvocationPerProfile:
  - Intervallo valido: valore minimo di 1. Valore massimo pari a 1000 (o UNLIMITED).
- Unità:
  - Valori validi: HOURS, DAYS, WEEKS, MONTHS
- Valore:
  - Intervallo valido: valore minimo di 1. Valore massimo di 24
Confronto tra intervalli di tempo
- Customer Profiles utilizza librerie standard per analizzare i valori temporali. Per i servizi globali, è importante tenere conto delle conversioni di fuso orario per assicurare un’elaborazione accurata.
Il valore EventExpiration è specificato in millisecondi. Quando viene utilizzato per attivare una campagna, il tempo di scadenza massimo è limitato a 15 minuti.

API di trigger di eventi di Outbound Campaigns

CreateCampaignV2

Per creare una campagna attivata da eventi occorre modificare solo i campi evidenziati. Gli altri campi sono gli stessi delle campagne pianificate.


{
    "name": "string",
    "connectInstanceId": "string",
    "channelSubtypeConfig": { 
    // or other channel parameters 
        "email": {
            "outboundMode": {
                "agentless":{
                }
            },
            "defaultOutboundConfig":{
                "connectSourceEmailAddress":"example@example.com",
                "wisdomTemplateArn":"arn:aws:wisdom:us-west-2:123456789012:message-template/dXXXXX0Pc8-195a-776f-0000-EXAMPLE/51219d5c-b1f4-4bad-b8d3-000673332",
                "sourceEmailAddressDisplayName": "testEmailDisplayName"
            }
        }
    },
    "connectCampaignFlowArn": <Flow ARN>,
    "schedule": {
            "endTime": "2024-12-11T21:22:00Z",
            "startTime": "2024-10-31T20:14:49Z",
            "timeZone": "America/Los_Angeles"
    },
    "source": {
        "eventTrigger": {
            "customerProfilesDomainArn": <Domain ARN>
}

PutProfileOutboundRequestBatch

Non è possibile invocare direttamente questa API, ma verrà registrata nei log di Cloudtrail. Questa API viene utilizzata per attivare una campagna dopo la ricezione di un evento ed è il meccanismo che avvia una chiamata vocale, un’e-mail o un SMS.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Fine del flusso

Abilitare Outbound Campaigns e Customer Profiles

Creare una campagna in uscita utilizzando i trigger di eventi

Imposta i trigger degli eventi in Connect Customer sito web di amministrazione

Importante

Creare campagne in uscita con trigger di eventi utilizzando le API

API di attivazione degli eventi Connect Customer Customer Profiles