Contact

If your application is using the core implementation type, you can use the TapCoreContactManager class to manage your user's contacts.

TapTalk Contact Method	Description
​Get All User Contact​	Get all of the user's contact data from TapTalk.io
​Get Contact Detail Info with TapTalk User ID​	Get a detailed contact info with selected TapTalk.io user ID
​Get Contact Detail Info with Client User ID​	Get a detailed contact info with selected Client user ID (xcUserID)
​Add User to Contact with User ID​	Add a user with selected TapTalk.io user ID to the active user's contacts
​Add User to Contact with Phone Number​	Add a user with selected phone number to the active user's contacts
​Remove User from Contact​	Remove a user with selected TapTalk.io user ID from the active user's contacts
Get User Contact by Username	Get user's contact by username
Get Filtered User Contacts	Search user's contact list
Report User	Submit a report for a selected user
Report Message	Submit a report for a selected message
Block User	Block a user from sending or receiving messages
Unblock User	Unblock a blocked user
Get Blocked User List	Retrieve a list of blocked users
Get Blocked User IDs	Retrieve a list of IDs from blocked users

Get All User Contact

Get all of the user's contact data from TapTalk.io.

JavaScript

tapCoreContactManager.getAllUserContacts({
   onSuccess: (contactList) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Get Contact Detail Info with TapTalk User ID

Get a detailed contact info with selected TapTalk.io user ID.

JavaScript

tapCoreContactManager.getUserDataWithUserID(USER_ID, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters

USER_ID: (String) Taptalk.io User ID of the selected user

Get Contact Detail Info with Client User ID

Get a detailed contact info with selected Client user ID (xcUserID).

JavaScript

tapCoreContactManager.getUserDataWithXCUserID(XC_USER_ID, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters

XC_USER_ID: (String) Client User ID of the selected user

Add User to Contact with User ID

Add a user with selected TapTalk.io user ID to the active user's contacts.

JavaScript

tapCoreContactManager.addToTapTalkContactsWithUserID(USER_ID, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters

USER_ID: (String) Taptalk.io User ID of the contact to be added

Add User to Contact with Phone Number

Add a user with selected phone number to the active user's contacts.JavaKotlin

JavaScript

tapCoreContactManager.addToTapTalkContactsWithPhoneNumber(PHONE_NUMBER, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters

PHONE_NUMBER: (String) phone number of the contact to be added

Remove User from Contact

Remove a user with selected TapTalk.io user ID from the active user's contacts.

tapCoreContactManager.removeFromTapTalkContacts(userID, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters

USER_ID: (String) Taptalk.io User ID of the contact to remove

Get User Contact by Username

Call this method to get User Contact by username.

tapCoreContactManager.getUserByUsername(USERNAME, ignoreCase, {
   onSuccess: (response) => {
          // do action here
    },
    onError: (errorCode, errorMessage) => {
          // do action here
    }
})

Parameters USERNAME: (String) username IGNORE_CASE: (Boolean) ignore case username

Get Filtered User Contacts

Call this method to search user's contact list.

tapCoreContactManager.getFilterUserContacts(contactString, {
   onContactFound: (contactList) => {
          // do action here
    },
    onContactNotFound: () => {
          // do action here
    }
})

Parameters CONTACT_STRING: (String) keyword

Report User

You may call this method to submit a report for a selected user. Submitted reports can then be viewed through the dashboard.

tapCoreContactManager.reportUser(
    USER_ID, 
    CATEGORY, 
    IS_OTHER_CATEGORY, 
    REASON,
    {
        onSuccess : (response) => {
            // Successfully reported user
        },
        onError : (errorCode, errorMessage) => {
        
        }
    }
)

Parameters USER_ID: (String) ID of the user to report CATEGORY: (String) Category of the violation. max length is 100 characters IS_OTHER_CATEGORY: (Boolean) If the category is other than the predefined categories REASON: (String) reason why the user is reported

Report Message

You may call this method to submit a report for a selected message. Submitted reports can then be viewed through the dashboard.

tapCoreContactManager.reportMessage(
    MESSAGE_ID,
    ROOM_ID,
    CATEGORY, 
    IS_OTHER_CATEGORY, 
    REASON,
    {
        onSuccess : (response) => {
            // Successfully reported message
        },
        onError : (errorCode, errorMessage) => {

        }
    }
)

Parameters MESSAGE_ID: (String) unique server ID of the message to report ROOM_ID: (String) ID of the room where the message belongs to CATEGORY: (String) Category of the violation. max length is 100 characters IS_OTHER_CATEGORY: (Boolean) If the category is other than the predefined categories REASON: (String) reason why the message is reported

Block User

You may block a user to stop conversation flow with the blocked user. Blocked users will not be able to send and receive message, or retrieve profile info from the active user.

tapCoreContactManager.blockUser(
    USER_ID,
    {
        onSuccess : (response) => {
            // Successfully blocked user
        },
        onError : (errorCode, errorMessage) => {

        }
    }
)

Parameters USER_ID: (String) ID of the user to block

Unblock User

You may unblock a blocked user to let them send and receive message from the active user.

tapCoreContactManager.unblockUser(
    USER_ID,
    {
        onSuccess : (response) => {
            // Successfully unblocked user
        },
        onError : (errorCode, errorMessage) => {

        }
    }
)

Parameters USER_ID: (String) ID of the user to unblock

Get Blocked User List

You may call this method to retrieve a list of blocked users.

tapCoreContactManager.getBlockedUserList({
    onSuccess: (response) => {
        // Successfully retrieved blocked users
    },
    onError: (errorCode, errorMessage) => {
    
    }
});

Get Blocked User IDs

You may call this method to retrieve a list of IDs from blocked users.

tapCoreContactManager.getBlockedUserIDs({
    onSuccess: (res) => {
        // Successfully retrieved blocked user IDs
    },
    onError: (errCode, errMes) => {
    }
});