Changes for page c. Directory and Contacts
Last modified by teamwire003 on 2025/04/08 15:33
To version 1.3
edited by teamwire001
on 2022/05/24 14:20
on 2022/05/24 14:20
Change comment:
DOC-81: Add VoIP feature to manual
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -c. Contacts 1 +c. Directory and Contacts - Content
-
... ... @@ -1,144 +1,224 @@ 1 -The [[image:Public.Applications.iOS.User-Manual.WebHome@icon-tabcontacts .png||queryString="height=20"height="20"]] **Contacts** tab shows all synchronisedcontacts (see[[AllContacts>>doc:||anchor="03-allcontacts"]]),self-created [[User Groups>>doc:||anchor="03-usergroups"]](//Your groups//), and[[Organisation Groups>>doc:||anchor="03-organisationgroups"]](//Managed groups//)to which you have been assigned to bytheTeamwire administrator.1 +The [[image:Public.Applications.iOS.User-Manual.WebHome@icon-tabcontacts||height="20"]] **Directory** tab shows all synchronised [[Contacts>>doc:||anchor="03-contacts"]]; created [[Lists>>doc:||anchor="03-lists"]]; [[Circles>>doc:||anchor="03-circles"]] to which you have been assigned to by your Teamwire admin; and [[Bots>>doc:||anchor="03-bots"]], that you have access to. 2 2 3 +## ## 4 +[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__Directory.png||height="583" width="280"]] 5 +## ## 3 3 4 - [[image:Public.Applications.iOS.User-Manual.WebHome@en_contacts.png||queryString="width=300"width="300"]]7 +{{id name="03-search"/}} 5 5 9 += Search = 6 6 7 - {{id name="03-allcontacts"/}}11 +Make use of the search bar located atop the list of contacts to find your colleagues. Enter (parts of) their name to see all of yours and other organisation's matching users. If a user is from another organisation, their associated organisation name will be shown. 8 8 9 - =AllContacts=13 +You can also search for names of lists, circles and bots. 10 10 11 -Tap **All Contacts** to see all synchronised users. The users are sorted by their last name. 12 12 16 +{{id name="03-contacts"/}} 13 13 14 - {{id name="03-mycontacts"/}}18 += Contacts = 15 15 16 - ==My contacts==20 +In the **Contacts** tab you can see all users, sorted by their last name. The list shows all users which your Teamwire administrator allows you to see. 17 17 18 -The list shows all of the company's users which your Teamwire administrator allows you to see. 19 19 20 - If Teamwirehas beengranted access to your address book, youmay findexternalcontacts using Teamwire, too - provided thatyour Teamwire administrator has enabled a policy for external communication.23 +{{id name="03-contactdata"/}} 21 21 25 +== Contact info == 22 22 23 - [[image:Public.Applications.iOS.User-Manual.WebHome@en_contacts_mycontacts.png||queryString="width=300"width="300"]]27 +Tap on a contact's name to open their profile and contact information. 24 24 29 +Depending on the data each of them has added, you will find a profile picture and info about their organisation, department, role, or even phone number. 25 25 26 -**Requirements for synchronising external user accounts** 27 27 28 -* The mail address in your address book matches the external's account information 29 -* Your Teamwire administrator has enabled a policy allowing the communication with external users 30 -* The users are hosted on the same Teamwire server (//backend//) 32 +{{id name="03-contactchat"/}} 31 31 32 - Makeuse ofthe search bar locatedatop the list ofcontacts to find your colleagues. Enter their name or partsof their name to see all user accounts matching your current input.34 +=== Start chat === 33 33 36 +Start a 1:1 conversation by tapping the **chat** symbol. You will be forwarded to the chat view automatically. 34 34 35 -{{id name="03-directory"/}} 36 36 37 - == Directory (EnterpriseDirectory) ==39 +{{id name="03-contactvoipvideo"/}} 38 38 39 - Inaddition to theautomaticallysynchronised contacts, you are able tolookfor users of other organisations via the **Directory.**41 +=== Start video call === 40 40 41 - Enterhe**fullfirstname** or **fulllastname**andtap **Search** to seeallmatchingusersofyourandotherorganisations. Theaccount'sassociatedorganisation willbe shown, too.43 +Start a video call by tapping the **camera** symbol. As voice and video calls can only be made within chats, you will be forwarded to a new or existing 1:1 chat. The call then starts automatically. 42 42 43 -**Requirements for finding user accounts via Directory** 44 44 45 -* Your Teamwire administrator has enabled a policy allowing the communication with external users 46 -* The external's Teamwire administrator allows their users to be found via Directory 47 -* The users are hosted on the same Teamwire server (//backend//) 46 +{{id name="03-contactvoipvoice"/}} 48 48 49 -## ## 48 +=== Start voice call === 49 + 50 +Start a voice call by tapping the **phone** symbol. As voice and video calls can only be made within chats, you will be forwarded to a new or existing 1:1 chat. The call then starts automatically. 51 + 52 +If the user has added their phone number to their contact info, an additional menu will allow you to choose between calling the phone number or using "Teamwire voice call". Select **Teamwire voice call** to start the call. 53 + 54 + 55 +{{id name="03-contactphone"/}} 56 + 57 +=== Call phone number === 58 + 59 +If the user has added their phone number to their contact info, you will find a **phone** symbol (voice). You may find an additional menu which will allow you to choose between calling the phone number or using "Teamwire voice call". Tap on the phone number to move it to your default phone app where you can start the call. 60 + 61 + 62 +{{id name="03-contactemail"/}} 63 + 64 +=== Send email === 65 + 66 +If the user has added their email address to their contact info, you will find an **envelope** symbol. Tap the symbol to move the address to your default mail app where you can start composing an email. 67 + 68 + 50 50 {{id name="03-blockauser"/}} 51 51 52 -== Block a user == 71 +=== Block a user === 53 53 54 - When you block auser,theywill not be able to create a 1:1 chat with you, or writemessagesto anyexisting 1:1 chats. If you are participating in a group chat with a blocked user, their messages will not be displayed to you.73 +Blocked contacts will not be able to create a 1:1 chat with you, or write to an existing 1:1 chat. If you are participating in a group chat with a blocked user, their messages will not be displayed to you. 55 55 56 -To block a user, open their profile and tap **Block user.** Their profile will show a button to **Unblock user,** if you have already blocked them. Thus you will be able to revoke a block.Alternatively, open the list of all blocked contacts via [[Profile > Privacy>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome||anchor="05-privacy"]] and unblock them there.75 +To block a user, open their profile and tap **Block contact.** Their profile will show a button to **Unblock user,** if you have already blocked them. Thus, you will be able to revoke a block. 57 57 58 -(% class="box" %) 77 +Alternatively, you can find a list of all blocked users in your Profile at [[Blocked Contacts>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome||anchor="05-privacy"]] where you can unblock them. 78 + 79 +(% class="box infomessage" %) 59 59 ((( 60 - YourTeamwire administrator is abletoprohibit the blockingofusers. Ifthe featureisnotavailabletoyou,it may has beendisabled.81 +If you cannot block a contact, the feature may have been disabled by your Teamwire administrator. 61 61 ))) 62 62 84 +{{id name="03-contacts-addressbook"/}} 85 + 86 +== Contacts from your local address book == 87 + 88 +If Teamwire has been granted access to your address book, you may find users from other organisations. 89 + 90 +They will automatically be shown in your list of contacts. 91 + 92 +**Requirements for synchronising external users from your local address book** 93 + 94 +* The mail address in your address book matches their user ID 95 +* Your Teamwire administrator has enabled a policy allowing the communication with external users 96 +* The users are hosted on the same Teamwire Server (//backend//) 63 63 ## ## 64 -{{id name="03-groups"/}} 65 65 66 - =Groups=99 +{{id name="03-contacts-organisations"/}} 67 67 68 - InTeamwire, groups are meantfor creating newchatsmore quickly and easily with predefined groupsof people (similartomailing list). Meaning, you can create multiple chats with the same group(s) based ondifferent topicsor projects.101 +== Contacts from other organisations == 69 69 70 -Teamwire classifiestwotypesofgroups103 +If your Teamwire admin allows communicating with externals, you may find users from other organisations in your contacts. 71 71 72 -* User Groups (//Your groups//) 73 -* Organisation Groups (//Managed groups//) 105 +Use the magnifier to open the search bar and look for users. Their associated organisation name will be shown. 74 74 75 - Groups can beselected asparticipantsduringthecreationof a chat, but can also beadded latertoy conversation.107 +**Requirements for finding users from other organisations** 76 76 109 +* Your Teamwire administrator has enabled a policy allowing the communication with external users 110 +* The external's Teamwire administrator allows their users to be found in the directory 111 +* The users are hosted on the same Teamwire Server (//backend//) 112 +## ## 77 77 78 -{{id name="03- usergroups"/}}114 +{{id name="03-contacts-federated"/}} 79 79 80 -== UserGroups(Your groups)==116 +== Federated contacts == 81 81 82 - Thesegroupsarecreatedby you (see [[Create group>>doc:||anchor="03-createagroup"]])andcanonlybeusedby yourself.Theusers will not beawareof their membershipof your group untilyouhaveaddedthegrouptoa chat. Only then they will be able tofindthegroupvia[[Chat Settings > Members>>doc:Public.Applications.iOS.User-Manual.Chats-and-Messaging.WebHome||anchor="02-members"]].Theuserswill beableto permanentlyleaveyourUser Group by leavingthe chat.118 +If your Teamwire administrator has enabled Teamwire Federation, you may find users of other organisations from another Teamwire Server (//backend//) in your contacts. 83 83 84 - Your UserGroupsare synchronisedtoall devicesyouhave loggedyourTeamwire account120 +They will automatically be shown in your list of contacts. They will show the Teamwire Federation icon [[image:Public.Applications.iOS.User-Manual.WebHome@icon-federated1.png||height="20"]] and their associated backend name. 85 85 122 +**Requirements for synchronising external users from another Teamwire Server** 86 86 87 -{{id name="03-createagroup"/}} 124 +* Your Teamwire administrator has configured Teamwire Federation with another Teamwire Server (//backend//) 125 +* Your Teamwire administrator has enabled your user account to use Teamwire Federation 126 +## ## 88 88 89 - ===Createa group===128 +{{id name="03-lists"/}} 90 90 91 - Tocreate a new group, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-newgroup.png||queryString="height=20"height="20"]] in the right upper corner of the screen.130 += Lists = 92 92 93 -* **Define a group name** 94 -Define a name for the User Group. It is best to choose a name you can easily associate to the group of people. Tap **Save** to continue. 132 +Lists are used to quickly and easily create a new chat with a predefined group of people in Teamwire, similar to a mailing list. Meaning, you can create multiple chats with the same list(s) based on different topics or projects. 95 95 96 -* **Select group members** 97 -You will see your [[list of contacts>>doc:||anchor="03-mycontacts"]]. If necessary, use the search bar located atop the list of contacts to find your contacts faster, and select the members for your group. 134 +Lists are contact groups that you created yourself and are available in your directory only. Their users will not be notified of being part of your list. Think of lists as a kind of "private circles". 98 98 99 - Confirmyourselectionof groupmembersbytapping**Done.**Youwill return toyourContactstab.136 +When a chat is created, the list is parsed into its individual users which are added as independent chat participants. Unlike [[circles>>doc:||anchor="03-circles"]], they will be directly listed in the list of chat members. 100 100 138 +Your lists are synchronised to all devices you have logged in with your Teamwire account. 101 101 102 -{{id name="03-edityourgroup"/}} 103 103 104 - === Edityour group===141 +{{id name="03-createalist"/}} 105 105 106 - If you want to add or remove contacts from your group(s) later, tap the name of the group to view all current members. Select **Edit** in the right upper corner of the screen. You will see your [[list of contacts>>doc:||anchor="03-mycontacts"]],whereyou can selector deselectanyusers. If necessary, use the search barlocated atop the listof contacts to find your contacts faster.143 +== Create a list == 107 107 108 - Confirmyourselectionofgroup membersbytapping**Done.** Youwillreturn to your Contactsab.145 +To create a new list, tap **New List**. 109 109 110 -Changes made to your User Groups will be automatically applied to all existing chats. I.e. additional contacts will be added and deleted contacts will be removed. 147 +* **Select members** 148 +Select members from your [[list of contacts>>doc:||anchor="03-contacts"]]. You may use the search bar to find contacts faster. Tap **Next** to continue. 111 111 150 +* **Define list name** 151 +Define a name for your list. It is best to choose a name you can easily associate to the group of people. 152 +## ## 112 112 113 - {{idname="03-deleteyourgroup"/}}154 +Confirm the creation of your list by tapping **Create.** You will return to the directory. 114 114 115 -=== Delete your group === 116 116 117 - To delete a User Group, left-swipe the group concernedonthe Contacts tab and select **Delete.** Alternatively, tap **Edit** in the left upper corner of the screen to remove multiple groups. Tap **Done** afteryouare finished.157 +{{id name="03-edityourlist"/}} 118 118 119 -(% class="box" %) 159 +== Manage lists == 160 + 161 +If you want to add or remove contacts from your list later, tap the name of the list to view and edit it all current members. Select **Add members** to see your [[list of contacts>>doc:||anchor="03-contacts"]], and add more members. You may use the search bar to find contacts faster. 162 + 163 +To remove members, tap a user in your list and select **Remove from List.** 164 + 165 +(% class="box warningmessage" %) 120 120 ((( 121 - Please notethatdeletingUserGroupsisfinalandcannot beundone.Youcanonly deleteUserGroupsouhavecreated yourself.167 +Changes made to your lists will not be applied to existing chats automatically. I.e., new list members will not automatically be added to a chat which was previously created with one of your lists. 122 122 ))) 123 123 170 +{{id name="03-deleteyourlist"/}} 171 + 172 +== Delete lists == 173 + 174 +To delete a list, left-swipe the List concerned on the directory's Lists tab and select **Delete.** Alternatively, tap **Edit** in the left upper corner of the screen to remove multiple lists. 175 + 176 +Please notice that this action cannot be undone. 177 + 178 + 179 +{{id name="03-groups"/}} {{id name="03-circles"/}} 180 + 181 += Circles = 182 + 183 +Circles are used to quickly and easily create a new chat with a predefined group of people in Teamwire, similar to a mailing list. Meaning, you can create multiple chats with the same circle(s) based on different topics or projects. 184 + 185 +Circles are managed by your Teamwire administrator and cannot be modified by you. 186 + 187 +In your directory, you will find all circles you are a member of yourself. You can use them when creating a chat or add them to an existing group conversation at a later time. 188 + 189 +Circles usually have names you can easily associate to a group of people, e.g. departments or teams. 190 + 191 + 192 +{{id name="03-circles-public"/}} 193 + 194 +== Public circles == 195 + 196 +Public circles are managed by your Teamwire administrator and cannot be modified by you. 197 + 198 +In your directory, you will find all public circles of your organisation without being a member yourself. You can use them when creating a chat. This allows special use cases, such as in the examples below. 199 + 200 +* **Example 1: Confidential information** 201 +You can now contact the HR department via chat and submit a photo or scanned document of your sick note. Therefore, you create a chat with the public circle "Personnel office". Your get in contact with the "Personnel office" circle without inviting all other employees of the organisation. 202 + 203 +* **Example 2: SOS button** 204 +In case of an emergency, you have to inform a predefined group of contacts via SOS button. Therefore, you have assigned the public circle "Emergency contacts" in your settings (see [[SOS group>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome||anchor="05-sosgroup"]]). In case of an emergency, you will now create an alert chat with the "Emergency contacts" circle without inviting all other employees of the organisation. 124 124 ## ## 125 -{{id name="03-organisationgroups"/}} 126 126 127 - == OrganisationGroups (Managed groups) ==207 +{{id name="03-bots"/}} 128 128 129 - Thesegroups are created by your Teamwire administratorand cannot be modified. Use these groups to create a chat or to add members to an existing conversation at a later time.209 += Bots = 130 130 131 - OrganisationGroupsusually have names youcan easily associate to agroupofpeople,e.g.departmentsorteams.211 +Bots are external applications (e.g. chat bots) that you have been given access to by your Teamwire administrator. They are always labelled with the suffix //Bot// so that users know that they are not talking to a real person. 132 132 133 - TheOrganisationGroupsaresynchronisedto alldevicesyouhave loggedyour Teamwireaccountinto.213 +For example, the RSS Bot, the WhatsApp Bot, a Web Chat Widget Bot, even a Barcode Scanner or a Flic Button Bot are just a few examples of useful and popular bots. [[In this article>>doc:Customer.Integrations.Teamwire-SDK.WebHome]] you can find more information and further examples of bots. 134 134 135 135 136 136 {{id name="03-updateyourcontactsandgroups"/}} 137 137 138 -= Update your Contacts and Groups =218 += Update your Contacts and Circles = 139 139 140 -The user accounts of your colleagues or new Organisation Groups are synchronised to your app automatically. However, if you are missing any users orgroups in yourlist ofcontacts, you can fetch the latest data manuallyvia**Update Contacts andGroups.**220 +The user accounts of your colleagues or new circles are synchronised to your app automatically. However, if you are missing any users or circles in your directory, you can fetch the latest data manually with the option **Update Contacts** via the menu in the upper right corner of the screen. 141 141 142 -If the desiredusersdo notappeardespite a manual update, please contact your administrator. It is possible that server settings or policies have been applied which will limit the synchronisation of your contacts.222 +If the contacts of concern do not show up, despite a manual update, please contact your Teamwire administrator. It is possible that server settings or policies have been applied which will limit the synchronisation of your contacts. 143 143 144 144 ## ##