Customer authentication

In certain use cases, if your website already knows the customer's login information such as email, phone number, member ID, etc., you can perform FIRST LINE customer verification through integration.

Preparing verification-related parameters

Your website must first request a verification code from the backend via API; other parameters should include a secret and the provided verification data (email, phone number, etc.).

Call the API to obtain the verification code

For security reasons, the obtained code is one-time use and will expire immediately after use; if needed again, you must request it again.

HTTP requestGET https://01.firstline.cc/livechat/messenger/9/apply-query-request?secret={secret}

Response

 {
    "code": "fl0db2xl-efab-46ce-bd88-c253ab0c7913",
    "criteria": null,
    "created_at": 1608099124,
    "expired_at": 1608102723,
    "livechat_account_id": 3
}
                

If a 404 code appears, it means no matching customer conditions were found or multiple customers were found.

Examplehttps://dev.dev.firstline.cc/livechat/messenger/9/apply-query-request?secret=5f49b304-89f0-495b-9a5c-5a216b53cdbc&membership_no=FL0092

Combine the one-time code into the URL

When the backend receives the verification code (code), it needs to combine it into the JavaScript URL within the embed code, such as https://dev.dev.firstline.cc/livechat.5c626c29-bd95-4d73-91b6-f58774a5c109.js?t=1610337630&once_code={once_code}