Contact
If your application is using the core implementation type, you can use these methods to manage your user's contacts.
Note: Please add #import <TapTalk/TapCoreContactManager.h>
before using these methods.
TapTalk Contact Method
Description
Get all of the user's contact data from TapTalk.io.
Fetch the user's latest contact data from TapTalk.io server
Get a detailed contact info with selected TapTalk.io user ID.
Get a detailed contact info with selected Client user ID (xcUserID).
Add a user with selected TapTalk.io user ID to the active user's contacts.
Add a user with selected phone number to the active user's contacts.
Remove a user with selected TapTalk.io user ID from the active user's contacts.
Save or update existing user data to local cache.
Search the active user's contacts from the device's local storage with a keyword.
Submit a report for a selected user.
Submit a report for a selected message.
Block a user from sending or receiving messages.
Unblock a blocked user.
Retrieve a list of blocked users.
Retrieve a list of IDs from blocked users.
Retrieve the list of groups in common with another user.
Get Contact List
Create a new group Get all of the user's contact data from TapTalk.io.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getAllUserContactsWithSuccess:^(NSArray<TAPUserModel *> * _Nonnull userArray) {
// Successfully fetched contact list data
}
failure:^(NSError * _Nonnull error) {
// Failed to get contact list data
}];
Fetch All User Contacts from Server
Calling fetchAllUserContactsFromServer
will fetch the user's latest contact data from TapTalk.io server and syncs it to the device's local storage.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] fetchAllUserContactsFromServerWithSuccess:^(NSArray<TAPUserModel *> * _Nonnull userArray) {
// Successfully fetched contact list data
}
failure:^(NSError * _Nonnull error) {
// Failed to get contact list data
}];
Get Contact Detail Info with TapTalk User ID
Get a detailed contact info with selected TapTalk.io user ID.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getUserDataWithUserID:USER_ID
success:^(TAPUserModel * _Nonnull user) {
// Successfully obtained contact details
}
failure:^(NSError * _Nonnull error) {
// Failed to get contact details
}];
Get Contact Detail Info with Client User ID
Get a detailed contact info with selected Client user ID (xcUserID).
//import TapTalk Contact Manager
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getUserDataWithXCUserID:XC_USER_ID
success:^(TAPUserModel * _Nonnull user) {
// Successfully obtained contact details
}
failure:^(NSError * _Nonnull error) {
// Failed to get contact details
}];
Add User to Contacts with User ID
Add a user with selected TapTalk.io user ID to the active user's contacts.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] addToTapTalkContactsWithUserID:USER_ID
success:^{
// Successfully added contact
}
failure:^(NSError * _Nonnull error) {
// Failed to add contact
}];
Add User to Contacts with Phone Number
Add a user with selected phone number to the active user's contacts.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] addToTapTalkContactsWithPhoneNumber:PHONE_NUMBER
success:^{
// Successfully added contact
}
failure:^(NSError * _Nonnull error) {
// Failed to add contact
}];
Remove User from Contacts
Remove a user with selected TapTalk.io user ID from the active user's contacts.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] removeFromTapTalkContactsWithUserID:USER_ID
success:^(NSString * _Nonnull successMessage) {
// Successfully removed contact
}
failure:^(NSError * _Nonnull error) {
// Failed to remove contact
}];
Save User Data
Save or update existing user data to local cache.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] saveUserData:USER];
Search Local Contact
Call this method to search the active user's contacts from the device's local storage with a keyword. Provided keyword will be used to filter the contacts' full name in the search result.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] searchLocalContactsByName:KEYWORD
success:^(NSArray<TAPUserModel *> * _Nonnull userArray) {
// Returns filtered contacts
}
failure:^(NSError * _Nonnull error) {
// Failed to get contact list data
}];
Report User
You may call this method to submit a report for a selected user. Submitted reports can then be viewed through the dashboard.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] reportUser:USER_ID
category:CATEGORY
isOtherCategory:IS_OTHER_CATEGORY
reason:REASON
success:^(BOOL isSuccess) {
// Successfully reported user
}
failure:^(NSError * _Nonnull error) {
}];
Report Message
You may call this method to submit a report for a selected message. Submitted reports can then be viewed through the dashboard.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] reportMessage:MESSAGE_ID
roomID:ROOM_ID
category:CATEGORY
isOtherCategory:IS_OTHER_CATEGORY
reason:REASON
success:^(BOOL isSuccess) {
// Successfully reported message
}
failure:^(NSError * _Nonnull error) {
}];
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.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] blockUserWithUserID:USER_ID
success:^(TAPUserModel *blockedUser) {
// Successfully blocked user
}
failure:^(NSError * _Nonnull error) {
}];
Unblock User
You may unblock a blocked user to let them send and receive message from the active user.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] unblockUserWithUserID:USER_ID
success:^(BOOL isSuccess) {
// Successfully unblocked user
}
failure:^(NSError * _Nonnull error) {
}];
Get Blocked User List
You may call this method to retrieve a list of blocked users.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getBlockedUserList:^(NSArray<TAPUserModel *> *blockedUserList) {
// Successfully retrieved blocked users
}
failure:^(NSError * _Nonnull error) {
}];
Get Blocked User IDs
You may call this method to retrieve a list of IDs from blocked users.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getBlockedUserIDs:^(NSArray<NSString *> *blockedUserIDs) {
// Successfully retrieved blocked user IDs
}
failure:^(NSError * _Nonnull error) {
}];
Get Groups in Common
You may use getGroupsInCommon
method to retrieve the list of groups in common with another user.
#import <TapTalk/TapCoreContactManager.h>
[[TAPCoreContactManager sharedManager] getGroupsInCommon:USER_ID
success:^(NSArray<TAPRoomModel *> *groupRooms) {
// Successfully retrieved rooms
}
failure:^(NSError * _Nonnull error) {
}];
Last updated
Was this helpful?