contact.connection.changed

{
  "type": "contact.connection.changed",
  "data": {
    "contact": {
      "id": "clrq5ca80000lb9c9dnxxfyid",
      "name": "康宜恩",
      "avatar": "https://uc.chatbrick.com/avatar/clrq5ca80000lb9c9dnxxfyid/avatar.jpeg"
    },
    "lineUsers": [
      {
        "id": "clxvsgpgi000001qgdxuka3vj",
        "name": "Mr. Kang",
        "lineUid": "U4d26836f2aadb5ad84cc8b5b729fc9a1",
        "lineProviderId": "1660894172",
        "profilePictureUrl": "https://profile.line-scdn.net/0m0450c48c7251b78e575b3a5bb3c4ea5a7e70d9d2d471"
      }
    ],
    "connectedStore": {
      "id": "clxvu9l6l000001p27bdm9ydk",
      "name": "台北101旗艦店",
      "logo": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public",
      "externalId": "10000"
    },
    "connectedStaff": {
      "id": "clxvu9uj3000001ob92yrb61o",
      "storeId": "clxvu9l6l000001p27bdm9ydk",
      "name": "何沛妮",
      "displayName": "小何 | 台北101旗艦店",
      "employeeId": "50001",
      "avatar": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public"
    },
    "timestamps": {
      "changedAt": "2024-06-18T18:18:18.000Z",
      "initConnectedAt": "2024-06-08T18:18:18.888Z"
    },
    "timestampsMs": {
      "changedAt": 1718734698000,
      "initConnectedAt": 1717870698888
    }
  }
}

This event type is in the beta stage; specifications are subject to change at any time.

Event Body Fields

The request event body is a JSON object that contains the following fields:

type

string

contact.connection.changed

data

Object

The object containing the event data.

Hide data

contact

Contact Object

Show contact

string

name

string

avatar

string

The URL of the contact’s avatar.

We don’t recommend embedding this image in any webpage because it’s not designed for that purpose. If you need to display this image on a webpage, please download it when you receive the event and serve it from your own server to ensure it works as expected.

lineUsers

Array of LineUser Object

LINE users that belong to the contact. In most cases, there will be only one LINE user.

Show lineUser

string

name

string

The name of the LINE user.

This is the name of the LINE user, it can be different from the contact name in some cases.

lineUid

string

Learn more about it in LINE User ID documentation.

lineProviderId

string

The LINE provider ID of the LINE user in. This value is sent as a string.

profilePictureUrl

string

The URL of the LINE user’s profile picture.

This URL is provided by LINE and it may already be expired when you receive the event.

In most cases, you may want to use the avatar from the contact object instead.

connectedStore

Store Object

In some rare cases, this field may be null if the contact is only connected to a staff member.

Show connectedStore

string

The permanent ID of the store in ChatBrick.

name

string

logo

string

The URL of the store’s logo.

We don’t recommend embedding this image in any webpage because it’s not designed for that purpose.

If you need to display this image on a webpage, please download it when you receive the event and serve it from your own server to ensure it works as expected.

externalId

string

The external ID is configured by the brand and is usually mapped to the brand’s internal system.

connectedStaff

Account Object or null

This field will be null if the contact is only connected to a store.

Show connectedStaff

string

The permanent ID of the account in ChatBrick.

storeId

string

ID of the account’s primary store. The value will be null if the account has no primary store configured (e.g., a brand manager’s account).

name

string

Name of the account.

This is for internal communication purposes; the name should never be displayed in a public customer-facing interface.

Use displayName for referring to the account in a public interface.

displayName

string

Name of the account for referring in a public interface.

employeeId

string

The employee ID is configured by the account and is typically mapped to the employee ID in the brand’s HR system.

avatar

string

The URL of the account’s profile picture (avatar).

We don’t recommend embedding this image in any webpage because it’s not designed for that purpose.

If you need to display this image on a webpage, please download it when you receive the event and serve it from your own server to ensure it works as expected.

timestamps

Object

Timestamps in ISO 8601 format.

Show timestamps

changedAt

string

The timestamp of when the user performed the connection change action.

initConnectedAt

string

The timestamp when the contact is connected for the first time.

timestampsMs

Object

Timestamps are represented in numerical format; the number represents milliseconds elapsed since the epoch, which is defined as the midnight at the beginning of January 1, 1970, UTC.

Show timestampsMs

changedAt

string

The timestamp of when the user performed the connection change action.

initConnectedAt

string

The timestamp when the contact is connected for the first time.

{
  "type": "contact.connection.changed",
  "data": {
    "contact": {
      "id": "clrq5ca80000lb9c9dnxxfyid",
      "name": "康宜恩",
      "avatar": "https://uc.chatbrick.com/avatar/clrq5ca80000lb9c9dnxxfyid/avatar.jpeg"
    },
    "lineUsers": [
      {
        "id": "clxvsgpgi000001qgdxuka3vj",
        "name": "Mr. Kang",
        "lineUid": "U4d26836f2aadb5ad84cc8b5b729fc9a1",
        "lineProviderId": "1660894172",
        "profilePictureUrl": "https://profile.line-scdn.net/0m0450c48c7251b78e575b3a5bb3c4ea5a7e70d9d2d471"
      }
    ],
    "connectedStore": {
      "id": "clxvu9l6l000001p27bdm9ydk",
      "name": "台北101旗艦店",
      "logo": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public",
      "externalId": "10000"
    },
    "connectedStaff": {
      "id": "clxvu9uj3000001ob92yrb61o",
      "storeId": "clxvu9l6l000001p27bdm9ydk",
      "name": "何沛妮",
      "displayName": "小何 | 台北101旗艦店",
      "employeeId": "50001",
      "avatar": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public"
    },
    "timestamps": {
      "changedAt": "2024-06-18T18:18:18.000Z",
      "initConnectedAt": "2024-06-08T18:18:18.888Z"
    },
    "timestampsMs": {
      "changedAt": 1718734698000,
      "initConnectedAt": 1717870698888
    }
  }
}

connected disconnected

{
  "type": "contact.connection.changed",
  "data": {
    "contact": {
      "id": "clrq5ca80000lb9c9dnxxfyid",
      "name": "康宜恩",
      "avatar": "https://uc.chatbrick.com/avatar/clrq5ca80000lb9c9dnxxfyid/avatar.jpeg"
    },
    "lineUsers": [
      {
        "id": "clxvsgpgi000001qgdxuka3vj",
        "name": "Mr. Kang",
        "lineUid": "U4d26836f2aadb5ad84cc8b5b729fc9a1",
        "lineProviderId": "1660894172",
        "profilePictureUrl": "https://profile.line-scdn.net/0m0450c48c7251b78e575b3a5bb3c4ea5a7e70d9d2d471"
      }
    ],
    "connectedStore": {
      "id": "clxvu9l6l000001p27bdm9ydk",
      "name": "台北101旗艦店",
      "logo": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public",
      "externalId": "10000"
    },
    "connectedStaff": {
      "id": "clxvu9uj3000001ob92yrb61o",
      "storeId": "clxvu9l6l000001p27bdm9ydk",
      "name": "何沛妮",
      "displayName": "小何 | 台北101旗艦店",
      "employeeId": "50001",
      "avatar": "https://imagedelivery.net/zdm_0V2jGvo4F5LeqaPJDQ/5178a7f8-661f-46d7-d852-0b72a2242100/public"
    },
    "timestamps": {
      "changedAt": "2024-06-18T18:18:18.000Z",
      "initConnectedAt": "2024-06-08T18:18:18.888Z"
    },
    "timestampsMs": {
      "changedAt": 1718734698000,
      "initConnectedAt": 1717870698888
    }
  }
}

Overview

Learn

Event Types

Event Body Fields

Overview

Learn

Event Types

​Event Body Fields

Event Body Fields