Backend - Integration API Functions¶

This section describes the functions that need to be implemented in the EnQualify Integration API.

📌 Important: The following API functions should be implemented along with the methods provided by Integration Services. EnQualify calls these methods to Integration Services when necessary — not the other way around.

Integration/IDCheck — Identity Information Query¶

If the caller's identity information has not been sent with Integration/Add or cannot be found in the system, EnQualify requests the identity information from Integration Services using the Integration/IDCheck method.

Expected Request¶

Parameter	Description
`Reference`	The reference Id sent in `Integration/Add`.
`IdentityType`	The caller's identity type.
`IdentityNo`	The caller's identity number.

Expected Response¶

Parameter	Description
`IDRegistration`	Identity registration data.
`AddressRegistration`	Address data.

Integration/Form — Getting Custom Form URL¶

If a custom form URL is not provided in Integration/Add, EnQualify requests this URL from Integration Services using the Integration/Form method.

Expected Request¶

Parameter	Description
`Reference`	The reference Id sent in `Integration/Add`.
`SessionUId`	The Id of the call in EnQualify.
`IntegrationUId`	The Id of the integration data in EnQualify.

Expected Response¶

Parameter	Description
`FormUrl`	The URL to be used for the form.

Integration/Send — Completed Call Notification¶

When a call is completed, EnQualify notifies Integration Services with the Integration/Send method. After the notification is received, Integration Services can request the call data using the Session/Get Web API method.

Expected Request¶

Parameter	Description
`Reference`	The reference Id sent in `Integration/Add`.
`SessionUId`	The Id of the call in EnQualify.
`Reason`	The call result code assigned by the admin.
`ReasonDetail`	Description entered for the call result.
`TaxNumber`	Tax number sent in the KYB flow.
`NotifyType`	The type of event that triggered the notification. Takes one of the following values:

NotifyType Values:

Parameter	Description
`AgentRatingWithReference` (`0`)	When an agent rating is made. Ratings without a reference are not sent to `Integration/Send`.
`SessionAdd`	When a session is created.
`IdTypeCheckStart` / `IdTypeCheckFinish`	When identity type check starts / finishes.
`HologramStart` / `HologramFinish`	When hologram check starts / finishes.
`OcrStart` / `OcrFinish`	When OCR reading starts / finishes.
`NfcStart` / `NfcFinish`	When NFC reading starts / finishes.
`FaceStart` / `FaceFinish`	When face recognition starts / finishes.
`RoomIdSend`	When the video call room Id is sent.
`AgentCallAccepted`	When the agent accepts the call.
`AgentCallClose`	When the agent closes the call.
`VideoUploadFinish`	When video upload is completed.
`SessionClose`	When the session is closed.
`SigningSet` / `SigningFinish`	When signing is set / completed.

Integration/UserMap — Relationship Manager User Mapping¶

If the call includes the Relationship Manager feature, EnQualify calls the Integration/UserMap method to find the correct agent.

Expected Request¶

Parameter	Description
`Reference`	The reference Id sent in `Integration/Add`.
`IdentityType`	The caller's identity type.
`IdentityNo`	The caller's identity number.
`CallType`	The call type.

Expected Response¶

Parameter	Description
`UserReference`	User reference code. Should match one of the users defined in EnQualify. Multiple user references may be returned.
`UserOrder`	The order of users when multiple users are returned.
`UserExpireDate`	The expiration date and time of this user mapping.