Magidoc

Visitor
Object

A visitor is a user who has participated at least once in an iAdvize conversation from his browser, a mobile application or one of the third-party channels supported by iAdvize.

Fields

#

visitorId

UUID !
Non-null

Unique cross channel identifier of an iAdvize visitor.

This field is now deprecated. This means that iAdvize now considers that this field should not be used and you should migrate any usage of that field. iAdvize will only maintain this field up until the 2025-04-07.

source

Source !
Non-null

Source of the visitor from where the conversation was started (e.g. ONSITE, MOBILE_APP).

legacyVisitorId

Int

This is an integer ID that was used internally at iAdvize and only available for onsite channels. It is exposed here in order to facilitate the transition to the new "visitorId" field.

This field is now deprecated. This means that iAdvize now considers that this field should not be used and you should migrate any usage of that field. iAdvize will only maintain this field up until the 2025-04-07.

externalUserId

String

This field allows you to link an iAdvize visitor and your own customer record in your internal tools (databases, CRM, etc.) allowing confidentiality and continuity of conversation for this visitor. This field is filled in thanks to the visitor authentication mechanism offered by iAdvize.

externalId

String

External identifier of the visitor used for conversation continuity: is deprecated and replaced by the externalUserId field.

This field is now deprecated. This means that iAdvize now considers that this field should not be used and you should migrate any usage of that field. iAdvize will only maintain this field up until the 2025-04-07.

firstName

String

First name of the visitor.

lastName

String

Last name of the visitor.

address

String

Address of the visitor.

city

String

City of the visitor.

zipCode

String

ZipCode of the visitor.

country

String

Country of the visitor.

phoneNumber

String

Phone number of the visitor.

email

String

Email of the visitor.

createdAt

DateTime !
Non-null

Date at which the visitor was created. This is usually when the visitor started their first conversation.

updatedAt

DateTime !
Non-null

Last updated date of the visitor.

profileUrl

String

Social media url of the visitor.

username

String

The visitor username as provided by third party channels such as WhatsApp.

avatarUrl

URL

Avatar url of the visitor.

project

Project

Project of the visitor domain.

_unusedField

Boolean

Please do not include this field in your query. This field is only present for the technical reason that GraphQL object types must contain at least one field. Its value is always null .

This field is now deprecated. This means that iAdvize now considers that this field should not be used and you should migrate any usage of that field. iAdvize will only maintain this field up until the 2025-04-07.

id

UUID !
Non-null

Unique cross channel identifier of an iAdvize visitor.

Usages

#

References

#