In questa pagina: scopri come utilizzare le azioni personalizzate per connettere un percorso a un sistema di terze parti tramite una chiamata REST API con un payload JSON, durante l’applicazione della governance dei dati e dei criteri di consenso.
Utilizza le azioni personalizzate per abilitare la connessione a un sistema di terze parti per l’invio di messaggi o chiamate API. Per ciascun provider è possibile configurare un’azione che può essere attivata tramite un’API REST con un payload in formato JSON.
Ulteriori informazioni sulle azioni personalizzate in questa sezione.
Scopri come creare e configurare un’azione personalizzata in questa pagina.
Scopri come utilizzare le risposte alle chiamate API da azioni personalizzate per la personalizzazione in questa pagina.
Consenso e governance dei dati privacy
In Journey Optimizer, puoi applicare la governance dei dati e i criteri di consenso alle azioni personalizzate per impedire l’esportazione di campi specifici in sistemi di terze parti o escludere clienti che non hanno acconsentito a ricevere comunicazioni e-mail, push o SMS. Per ulteriori informazioni, consulta le pagine seguenti:
Configurazione URL
Nel riquadro di configurazione dell’attività Azione personalizzata sono visualizzati i parametri di configurazione URL e i parametri di autenticazione configurati per l’azione personalizzata. Non è possibile impostare la parte statica dell’URL nel percorso, ma nella configurazione globale dell’azione personalizzata. Ulteriori informazioni.
Percorso dinamico
Se l’URL include un percorso dinamico, specificare il percorso nel campo Percorso.
Per concatenare campi e stringhe di testo normale, utilizza le funzioni Stringa o il segno più (+) nell’editor di espressioni avanzate. Racchiudere le stringhe di testo normale tra virgolette singole (') o doppie ("). Ulteriori informazioni.
Questa tabella mostra un esempio di configurazione:
https://xxx.yyy.com:8080/somethingstatic/The _id + '/messages'L’URL concatenato ha il seguente modulo:
https://xxx.yyy.com:8080/somethingstatic/<ID>/messages
Intestazioni e parametri di query headers
La sezione Configurazione URL mostra i campi intestazione dinamica e parametro di query, ma non i campi costanti. I campi dell’intestazione dinamica e dei parametri di query sono definiti come variabili nella schermata di configurazione dell’azione. Ulteriori informazioni
Per specificare il valore dei campi con intestazione dinamica e parametri di query, fai clic all’interno del campo o sull’icona a forma di matita e seleziona il campo desiderato.
Parametri azione
Nella sezione Parametri azione verranno visualizzati i parametri del messaggio definiti come “Variabile”. Per questi parametri, puoi definire dove ottenere queste informazioni (ad esempio: eventi, origini dati), passare i valori manualmente o utilizzare l’editor di espressioni avanzate per casi d’uso avanzati. I casi d’uso avanzati possono essere la manipolazione dei dati e altro utilizzo di funzioni. Consulta questa pagina.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to add and configure a custom action activity in a journey to call a third-party REST API with a JSON payload, including URL configuration, header/query parameter mapping, action parameter mapping, and applying data governance and consent policies.
Intents:
- Add a custom action activity to a journey to send data to a third-party system via REST API
- Configure a dynamic URL path by concatenating fields and static text in the expression editor
- Map dynamic header and query parameter values from journey events or datasources
- Map action parameters (defined as Variable) to event fields, datasource fields, or static values
- Apply data governance and consent policies to control what data is exported via custom actions
Glossary:
- Custom action: A journey action activity that calls an external REST API endpoint with a JSON-formatted payload to integrate third-party systems (product-specific)
- Dynamic path: The variable portion of the custom action URL that is defined per-execution using fields from the journey context (product-specific)
- Action parameters: Message payload fields defined as “Variable” in the custom action configuration, mapped to journey data at the journey level (product-specific)
Guardrails:
- The static part of the URL cannot be modified in the journey; it must be set in the global custom action configuration.
- Dynamic header and query parameter fields are defined as variable in the action configuration screen, not in the journey.
- Data governance and consent policies can be applied to prevent specific fields from being exported or to exclude non-consented customers.
Terminology:
- Canonical name: Custom action — Acronym: none — variants: custom actions, third-party action
- Synonyms: “action parameters” = “message parameters defined as Variable”
- Do not confuse: “static URL part” (set in global action config, not editable in journey) ≠ “dynamic path” (set in the journey per-execution)
FAQ:
- Q: Can I change the base URL of a custom action inside the journey? — No, only the dynamic path portion can be set in the journey; the static part of the URL is configured in the global custom action configuration.
- Q: How do I build a dynamic URL path that includes a profile ID? — Use the Path field with the advanced expression editor to concatenate the ID field with static strings, for example:
_id + '/messages'. - Q: How do I apply consent rules to a custom action? — Configure consent policies on the custom action to exclude customers who have not consented to receive the relevant communication; refer to the Consent page for details.
- Q: Where do I map the values for dynamic headers? — In the URL Configuration section of the activity pane, click inside the dynamic header field or use the pencil icon to select the desired field from events or datasources.
- Q: What types of values can I assign to action parameters? — You can map parameters to event fields, datasource fields, pass values manually, or use the advanced expression editor for data manipulation.