IdentityManager

The IdentityManager is responsible for managing the identity of the current user. It allows to identify the user, update its attributes, and send verification requests.

Example

To access IdentityManager, you can use the contact property of the SDK instance.

Przykład kodu

Bird.contact.identify();

Accessors

anonymousId

Przykład kodu

get anonymousId(): string

The anonymousId is a unique identifier for the current user. It is used to track the user before they are identified.

contactId

Przykład kodu

get contactId(): string

The contactId represents the current user's contact id. This is the unique identifier within Bird CRM that is assigned to the user once they are identified.

isVerified

Przykład kodu

get isVerified(): boolean

The isVerified property indicates whether the user has been identified and verified using a trusted verification method.

Methods

getCurrent()

Przykład kodu

getCurrent(): Promise<ContactsContactMeResponse>

Returns the current contact information.

identify()

Przykład kodu

identify(claim: ContactIdentifierClaim, contactAttributes?: ContactsVerificationsV2RequestContactAttributes): Promise<{
  accessToken: res.token;
  contactId: res.contactId;
  identifierKeys: res.identifierKeys;
 } | {
  accessToken: undefined | string;
  contactId: string;
}>

The identify method is how you tell Bird CRM who the current visitor is. It includes a unique user ID, and any optional attributes you know about them. There's no need to call identify for anonymous visitors. The SDK automatically assigns them a visitor ID, so tracking events works just fine without having to identify the visitor.

💡 Make sure to call identify as soon as a visitor is identified either as a new user or a returning user. This will ensure that all events are correctly associated with the visitor.

Parameters

• claim: ContactIdentifierClaim

• contactAttributes?: ContactsVerificationsV2RequestContactAttributes

Returns

Promise<{ accessToken: res.token; contactId: res.contactId; identifierKeys: res.identifierKeys; } | { accessToken: undefined | string; contactId: string; }>

Example

To create a new contact with some known identifiers, you can call identify as:

Przykład kodu

Bird.contact.identify({
	strategy: 'Visitor',
	identifier: {
		key: 'emailaddress',
		value: 'michael@example.com',
	},
});

reset()

Przykład kodu

reset(): Promise<void>

Resets the current contact information. This will clear the current contact information and generate a new anonymousId if the anonymousId option is set to refresh.

Returns

Promise<void>

Example

To refresh the anonymousId, you can call reset() as:

Przykład kodu

Bird.contact.reset();

sendVerificationRequest()

Przykład kodu

sendVerificationRequest(verificationRequest: OTPVerificationRequest): Promise<{
  expiresAt: res.expiresAt;
  id: res.id;
}>

Sends a verification request to the current user. The verification request is used to verify the user's identity using a trusted verification method like OTP.

Parameters

• verificationRequest: OTPVerificationRequest

Returns

Promise<{ expiresAt: res.expiresAt; id: res.id; }>

expiresAt

Przykład kodu

expiresAt: string = res.expiresAt;

Przykład kodu

id: string = res.id;

Example

To send an OTP verification request to the current user, you can call sendVerificationRequest as:

Przykład kodu

Bird.contact.sendVerificationRequest({
	strategy: 'OTP',
	identifier: {
		key: 'phonenumber',
		value: '+31612345678',
	},
});

updateCurrent()

Przykład kodu

updateCurrent(attributes: Record<string, any>): Promise<ContactsContactMeResponse>

Updates the current contact information.

Parameters

• attributes: Record<string, any>

Returns

Promise<ContactsContactMeResponse>