OMCUser Class Reference

Inherits from NSObject
Declared in OMCUser.h

+ currentUser

The object representing the current user.

+ (nullable instancetype)currentUser

Discussion

Returns nil if +initWithSettings:completionHandler: has not been called yet.

See Also

Declared In

OMCUser.h

– addProperties:

Adds custom properties to the user. This info is used to provide more context around who a user is.

- (void)addProperties:(NSDictionary *)properties

Parameters

properties

The properties to set for the current user.

Discussion

Keys must be of type NSString, and values must be of type NSString, NSNumber, or NSDate; any other type will be converted to NSString using the -description method.

Example:

[user addProperties:@{ @"nickname" : @"Lil' Big Daddy Slim", @"weight" : @650, @"premiumUser" : @YES }];

Changes to user properties are uploaded in batches at regular intervals, when the app is sent to the background, or when a message is sent.

This API is additive, and subsequent calls will override values for the provided keys.

Declared In

OMCUser.h

  appUserId

The assigned appUserId for this user.

@property (readonly, nullable) NSString *appUserId

Discussion

Unlike userId, this property is set automatically by Bots, and is not configurable. This is analogous to appUser._id in the REST API response. A user is assigned an appUserId once they start a conversation or when an existing user is logged in by calling +login:jwt:completionHandler:.

See Also

Declared In

OMCUser.h

  userId

The assigned userId for this user.

@property (readonly, nullable) NSString *userId

Discussion

This property is set by calling +login:jwt:completionHandler:.

Unlike appUserId, this value is assigned and managed by the developer, and is used to identify a user across devices and app installations.

See Also

Declared In

OMCUser.h

  firstName

The user’s first name, to be used as part of the display name when sending messages.

@property (copy, nullable) NSString *firstName

Declared In

OMCUser.h

  properties

The user’s custom properties.

@property (copy, readonly) NSDictionary *properties

Declared In

OMCUser.h

  lastName

The user’s last name, to be used as part of the display name when sending messages.

@property (copy, nullable) NSString *lastName

Declared In

OMCUser.h

  email

The user’s email, to be used to display a gravatar.

@property (copy, nullable) NSString *email

Declared In

OMCUser.h

  signedUpAt

The date the user started using your service.

@property (copy, nullable) NSDate *signedUpAt

Declared In

OMCUser.h