Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

1Flow Web (Actions) Destination


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as 1Flow Web (Actions) in the Integrations object
  • This destination is not compatible with Destination Insert Functions.
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta

1Flow(link takes you to an external page) is a leading in-app user survey and messaging platform for Mobile app and SaaS businesses.

1Flow is an easy-to-use, yet powerful in-app survey and messaging software. Using 1Flow, you can reach users in-the-moment while they are interacting with your website or mobile app, to collect highly contextual user insights that help you improve your product offering and customer experience.

When you use the 1Flow Web (Actions) Destination, Segment loads the 1Flow SDK(link takes you to an external page) for you. The 1Flow library enables you to track and identify user events on your website and interact with the 1Flow messenger window.


Getting started

getting-started page anchor
  1. From Segment, navigate to Connections > Catalog, then select Destinations.
  2. Search for and select 1Flow Web (Actions) Destination.
  3. Select the web source that will send data to 1Flow web (Actions) and follow the steps to name your destination. The web source chosen must use Analytics.js 2.0.
  4. On the Settings tab, input your 1Flow PROJECT API KEY and other destinations settings.
  5. Follow the step in the Destinations Actions docs to customize your mappings.
  6. Enable the destination and configured mappings.

Property nameTypeRequiredDescription
Project API Keystring
required

This is the unique app_id for your 1Flow application, serving as the identifier for data storage and retrieval. This field is mandatory.


1Flow Web (Actions) has the following presets

Preset NameTriggerDefault Action
Track EventEvent type = "track"Track Event
Identify UserEvent type = "identify"Identify User

Build your own Mappings. Combine supported triggers with the following 1Flow Web-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Identify User

identify-user page anchor

Create or update a user in 1Flow.

Identify User is a Web action. The default Trigger is type = "identify"

Property nameTypeRequiredDescription
User IDSTRING

Optional

A unique identifier for the user.


Custom AttributesOBJECT

Optional

The user's custom attributes.

Submit an event to 1Flow.

Track Event is a Web action. The default Trigger is type = "track"

Property nameTypeRequiredDescription
Event NameSTRING
required

The name of the event.


User IDSTRING

Optional

A unique identifier for the user.


Anonymous IDSTRING

Optional

An anonymous identifier for the user.


Event PropertiesOBJECT

Optional

Information associated with the event


The 1Flow destination will automatically ingest a User ID and any values sent over your Identify spec as traits(link takes you to an external page), as long as session capture is enabled in 1Flow.

When you call Segment's Identify method, it will be equivalent to logUser of 1Flow. Identify calls that do not have a User ID value are not sent to 1Flow.

  • Segment's userId is userID in 1Flow
  • Segment's traits is userDetails in 1Flow

The 1Flow destination automatically ingests any user actions tracked over your Track spec as events(link takes you to an external page), as long as session capture is enabled in 1Flow.


Requests to 1Flow return a 404 response

requests-to-1flow-return-a-404-response page anchor

If you are seeing 404 responses in your browser's network tab, you've likely encountered one of two issues:

  • You set the wrong App ID on the 1Flow Actions (Web) destination settings page.
  • You set the wrong Regional Data Hosting value on the 1Flow Actions (Web) destination settings page. 1Flow gates regional endpoints by plan level, so you may not have access to EU data hosting.

Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
Project API Keystring
required

This is the unique app_id for your 1Flow application, serving as the identifier for data storage and retrieval. This field is mandatory.