The Set Identifier Action The Set Identifier Action

The Set Identifier Action

Elliot Fiske Elliot Fiske

Overview

The Set Identifier Action sets the Journey identifier. Journeys are identified in three different ways.

  • A unique "sessionId" that is automatically created for each Journey. This cannot be modified.
  • The actor Variable, which is the user's unique phone number.
  • A custom identifier, which can be any Text as specified by this Action.

An identifier is used to uniquely identify a Journey from either an App API or an Event. The Set Identifier Action can only be used for the third type of identifier above, a "custom identifier".

set-identifier.gif

Use Cases

  • Sending a Journey Event to a running App.
  • Sending a message to a specific user.
  • Updating the status of a request from an external system.
  • Using a custom ID from your system of record. For instance, a user could be identified based on their Salesforce Contact ID, or their Zendesk ID.

Action Properties

Identifier

The Text value that will be used to uniquely identify a Journey.

Variable

This property has 2 options: Fail and Replace. When the Set Identifier Action is run, and there is an existing Journey with the same identifier that was just specified, these options decide what happens.

If Fail is selected, then this Action does nothing. The existing Journey is not modified, and the Journey that called Set Identifier will not claim the identifier.

If Replace is selected, then the Journey that called Set Identifier "takes over" the existing Journey's identifier, removing the identifier from the existing Journey, if any.

Further Reading

To learn more about how the Actor works in an Airkit App, read The Actor Model.

To learn about Journeys in an Airkit App, read The Journey Model.