CONTACT

The CONTACT command is used to manage a server-side contact list, similar to a buddy list in instant messaging clients. It leverages the WATCH list for contact presence (status).

Managing Contacts

The CONTACT command uses subcommands to perform various actions:

Listing Contacts

Usage: CONTACT LIST
Lists your current contacts.

Adding or Editing Contacts

Usage: CONTACT ADD | EDIT <target_nick> <category> <alias>
<target_nick> The nickname of the contact to add or edit.
<category> A category for grouping contacts (e.g., family, co-workers, friends).
<alias> A custom name to display for the contact in your list.

Acknowledging, Accepting, or Rejecting Contact Requests

Usage: CONTACT ACK | ACCEPT | REJECT <target_nick>
<target_nick> The nickname of the user who sent the contact request.

Searching for Contacts

Usage: CONTACT SEARCH <query>
<query> A search query using key-value pairs. Supported searchable fields (using * for wildcard and ? for single character matching) are:

• NAME The account name (Nick).
• FIRSTNAME The first name of the contact.
• LASTNAME The last name of the contact.
• EMAIL The email address of the contact.
• PHONE The phone number of the contact.
• GENDER The gender of the contact.
• AGE The age of the contact.
• MARITALSTATUS The marital status of the contact.
• COUNTRY The country of the contact.
• REGION The region of the contact.
• CITY The city of the contact.
• COMPANYNAME The name of the company the contact works for.
• DEPARTMENT The department the contact works in.
• JOBTITLE The job title of the contact.
• OCCUPATION The occupation of the contact.
• WEBSITE The website of the contact.

The following fields do not support wildcards or single character matching:

• LANGUAGE Language code (e.g., EN).
• INTEREST Keyword/tag search.
• KEYWORD Keyword search.
• STATUS All, Offline, Online, Here, Gone
• LIMIT Limit results

Example: NAME=*John*,LANGUAGE=en,LIMIT=10

Deleting a Contact

Usage: CONTACT DELETE <target_nick>
<target_nick> The nickname of the contact to delete.