Changes for page c. Directory and Contacts

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-c. Directory and Contacts
	1	+c. Contacts

Content

...	...	@@ -1,228 +1,141 @@
1		-The [[image:Public.Applications.Android.User-Manual.WebHome@icons-directory.svg]] **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.
	1	+The **Contacts** tab shows all synchronised contacts (see [[All Contacts>>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 by the Teamwire administrator. When viewing your inbox, you can switch to your contacts by swiping the screen to the left.
2	2
3		-## ##
4		-[[image:Public.Applications.Android.User-Manual.WebHome@directory-1.png||width="280px"]]
5		-## ##
6	6
7		-{{id name="03-search"/}}
	4	+[[image:Public.Applications.Android.User-Manual.WebHome@en_contacts.png||queryString="width=270" width="270"]]
8	8
9		-= Search =
10	10
11		-Use the [[image:Public.Applications.Android.User-Manual.WebHome@icons-search.svg]] magnifier to open the search bar and look for 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.
	7	+{{id name="03-allcontacts"/}}
12	12
13		-You can also search for names of lists, circles and bots.
	9	+= All Contacts =
14	14
	11	+Tap **All Contacts** to see all synchronised users. The users are sorted by their last name.
15	15
16		-{{id name="03-contacts"/}}
17	17
18		-= Contacts =
	14	+{{id name="03-mycontacts"/}}
19	19
20		-In the [[image:Public.Applications.Android.User-Manual.WebHome@icons-user.svg]] **Contacts** tab you can see all users which your Teamwire administrator allows you to see.
21		-By default, the contacts are sorted by **First name** and can alternatively be sorted by **Last name** with the option [[image:Public.Applications.Android.User-Manual.WebHome@icons-list-sort.svg]] **Sort order** in the upper right corner of the screen.
	16	+== My contacts ==
22	22
	18	+The list shows all of the company's users which your Teamwire administrator allows you to see.
23	23
24		-{{id name="03-contactdata"/}}
	20	+If Teamwire has been granted access to your address book, you may find external contacts using Teamwire, too - provided that your Teamwire administrator has enabled a policy for external communication.
25	25
26		-== Contact info ==
	22	+**Requirements for synchronising external user accounts**
27	27
28		-Tap on a contact's name to open their profile and contact information.
	24	+* The mail address in your address book matches the external's account information
	25	+* Your Teamwire administrator has enabled a policy allowing the communication with external users
	26	+* The users are hosted on the same Teamwire server (//backend//)
29	29
30		-Depending on the data each of them has added, you will find a profile picture and info about their [[image:Public.Applications.Android.User-Manual.WebHome@icons-place.svg]] organisation, [[image:Public.Applications.Android.User-Manual.WebHome@icons-department.svg]] department, [[image:Public.Applications.Android.User-Manual.WebHome@icons-position.svg]] role, or even [[image:Public.Applications.Android.User-Manual.WebHome@icons-voice-single.svg]] phone number.
	28	+Make use of the search bar located atop the list of contacts to find your colleagues. Enter their name or parts of their name to see all user accounts matching your current input.
31	31
32		-## ##
33		-[[image:Public.Applications.Android.User-Manual.WebHome@EN__contacts-userprofile.png||width="280"]]
34		-## ##
35	35
36		-{{id name="03-contactchat"/}}
	31	+{{id name="03-directory"/}}
37	37
38		-=== Start chat ===
	33	+== Directory (Enterprise Directory) ==
39	39
40		-Start a 1:1 conversation by tapping the [[image:Public.Applications.Android.User-Manual.WebHome@icons-chat-new.svg]] **chat** symbol. You will be forwarded to the chat view automatically.
	35	+In addition to the automatically synchronised contacts, you are able to look for users of other organisations via the **Directory.**
41	41
	37	+Enter the **full first name** or **full last name** and tap **Search** to see all matching users of your and other organisations. The account's associated organisation will be shown, too.
42	42
43		-{{id name="03-contactvoipvideo"/}}
44	44
45		-=== Start video call ===
	40	+**Requirements for finding user accounts via Directory**
46	46
47		-Start a video call by tapping the [[image:Public.Applications.Android.User-Manual.WebHome@icons-video-single.svg]] **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.
48		-
49		-
50		-{{id name="03-contactvoipvoice"/}}
51		-
52		-=== Start voice call ===
53		-
54		-Start a voice call by tapping the [[image:Public.Applications.Android.User-Manual.WebHome@icons-voice-single.svg]] **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.
55		-
56		-If the user has added their phone number to their contact data, 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.
57		-
58		-
59		-{{id name="03-contactphone"/}}
60		-
61		-=== Call phone number ===
62		-
63		-If the user has added their phone number to their contact data, you will find a [[image:Public.Applications.Android.User-Manual.WebHome@icons-voice-single.svg]] **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.
64		-
65		-
66		-{{id name="03-contactemail"/}}
67		-
68		-=== Send email ===
69		-
70		-If the user has added their email address to their contact data, you will find an [[image:Public.Applications.Android.User-Manual.WebHome@icons-email.svg]] **envelope** symbol. Tap the symbol to move the address to your default mail app where you can start composing an email.
71		-
72		-
73		-{{id name="03-blockauser"/}}
74		-
75		-=== Block a user ===
76		-
77		-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.
78		-
79		-To block a user, open their profile and tap [[image:Public.Applications.Android.User-Manual.WebHome@icons-close.svg]] **Block user.** Their profile will show a button to [[image:Public.Applications.Android.User-Manual.WebHome@icons-close.svg]] **Unblock user,** if you have already blocked them. Thus, you will be able to revoke a block.
80		-
81		-Alternatively, you can find a list of all blocked users in your privacy settings at [[Blocked Contacts>>doc:Public.Applications.Android.User-Manual.Profile.WebHome||anchor="05-privacy"]] where you can unblock them.
82		-
83		-{{info}}
84		-If you cannot block a contact, the feature may have been disabled by your Teamwire administrator.
85		-{{/info}}
86		-
87		-
88		-{{id name="03-contacts-addressbook"/}}
89		-
90		-== Contacts from your local address book ==
91		-
92		-If Teamwire has been granted access to your address book, you may find users from other organisations.
93		-
94		-They will automatically be shown in your list of contacts.
95		-
96		-**Requirements for synchronising external users from your local address book**
97		-
98		-* The mail address in your address book matches their user ID
99	99	* Your Teamwire administrator has enabled a policy allowing the communication with external users
100		-* The users are hosted on the same Teamwire Server (//backend//)
101		-## ##
	43	+* The external's Teamwire administrator allows their users to be found via Directory
	44	+* The users are hosted on the same Teamwire server (//backend//)
102	102
103		-{{id name="03-contacts-organisations"/}}
104		-
105		-== Contacts from other organisations ==
106		-
107		-If your Teamwire admin allows communicating with externals, you may find users from other organisations in your contacts.
108		-
109		-Use the magnifier to open the search bar and look for users. Their associated organisation name will be shown.
110		-
111		-**Requirements for finding users from other organisations**
112		-
113		-* Your Teamwire administrator has enabled a policy allowing the communication with external users
114		-* The external's Teamwire administrator allows their users to be found in the directory
115		-* The users are hosted on the same Teamwire Server (//backend//)
116	116	## ##
	47	+{{id name="03-blockauser"/}}
117	117
118		-{{id name="03-contacts-federated"/}}
	49	+== Block a user ==
119	119
120		-== Federated contacts ==
	51	+When you block a user, they will not be able to create a 1:1 chat with you, or write messages to any existing 1:1 chats. If you are participating in a group chat with a blocked user, their messages will not be displayed to you.
121	121
122		-If your Teamwire administrator has enabled Teamwire Federation, you may find users of other organisations from another Teamwire Server (//backend//) in your contacts.
	53	+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.Android.User-Manual.Settings.WebHome||anchor="05-privacy"]] and unblock them there.
123	123
124		-They will automatically be shown in your list of contacts. They will show the Teamwire Federation icon  [[image:Public.Applications.Android.User-Manual.WebHome@icons-federated.svg]] and their associated backend name.
	55	+(% class="box" %)
	56	+(((
	57	+Your Teamwire administrator is able to prohibit the blocking of users. If the feature is not available to you, it may has been disabled.
	58	+)))
125	125
126		-**Requirements for synchronising external users from another Teamwire Server**
127		-
128		-* Your Teamwire administrator has configured Teamwire Federation with another Teamwire Server (//backend//)
129		-* Your Teamwire administrator has enabled your user account to use Teamwire Federation
130	130	## ##
	61	+{{id name="03-groups"/}}
131	131
132		-{{id name="03-lists"/}}
	63	+= Groups =
133	133
134		-= Lists =
	65	+In Teamwire, groups are meant for creating new chats more quickly and easily with predefined groups of people (similar to a mailing list). Meaning, you can create multiple chats with the same group(s) based on different topics or projects.
135	135
136		-[[image:Public.Applications.Android.User-Manual.WebHome@icons-userlist.svg]] 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.
	67	+Teamwire classifies two types of groups
137	137
138		-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".
	69	+* User Groups (Your groups)
	70	+* Organisation Groups (Managed groups)
139	139
140		-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.
	72	+Groups can be selected as participants during the creation of a chat, but can also be added later to any conversation.
141	141
142		-Your lists are synchronised to all devices you have logged in with your Teamwire account.
143	143
	75	+{{id name="03-usergroups"/}}
144	144
145		-{{id name="03-createalist"/}}
	77	+== User Groups (Your groups) ==
146	146
147		-== Create a list ==
	79	+These groups are created by you (see [[Create group>>doc:||anchor="03-createagroup"]]) and can only be used by yourself. The users will not be aware of their membership of your group until you have added the group to a chat. Only then they will be able to find the group via [[Chat Settings > Members>>doc:Public.Applications.Android.User-Manual.Chats-and-Messaging.WebHome||anchor="02-members"]]. The users will be able to permanently leave your User Group by leaving the chat.
148	148
149		-To create a new list, tap [[image:Public.Applications.Android.User-Manual.WebHome@icons-list-new.svg]] in the bottom right corner of the screen. Alternatively, you will find the option **Create list** via the menu in the upper right corner of the screen.
	81	+Your User Groups are synchronised to all devices you have logged your Teamwire account into.
150	150
151		-* **Select members**
152		-Select members from your [[list of contacts>>doc:||anchor="03-contacts"]]. You may use the search bar to find contacts faster. Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-arrow.png||height="20"]] to continue.
153		-
154		-* **Define list name**
155		-Define a name for your list. It is best to choose a name you can easily associate to the group of people.
156		-## ##
157	157
158		-Confirm the creation of your list by tapping [[image:Public.Applications.Android.User-Manual.WebHome@icon-confirm.png||height="20"]]. You will return to the directory.
	84	+{{id name="03-createagroup"/}}
159	159
	86	+=== Create a group ===
160	160
161		-{{id name="03-edityourlist"/}}
	88	+To create a new group, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-newgroup.png||queryString="width=20" width="20"]] in the bottom right corner of the screen. Alternatively, you will find the option **New Group** via the menu in the right upper corner of the screen
162	162
163		-== Manage lists ==
	90	+* **Define a group name**
	91	+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.
164	164
165		-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. Tap [[image:Public.Applications.Android.User-Manual.WebHome@icons-adduser.svg]] in the bottom right corner of the screen to see your [[list of contacts>>doc:||anchor="03-contacts"]], and add more members. You may use the search bar to find contacts faster.
	93	+* **Select group members**
	94	+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.
166	166
167		-To remove members, tap a user in your list and select **Remove from List.**
	96	+Confirm your selection of group members by tapping **Done.** You will return to your Contacts tab.
168	168
169		-{{warning}}
170		-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.
171		-{{/warning}}
172	172
	99	+{{id name="03-edityourgroup"/}}
173	173
174		-{{id name="03-deleteyourlist"/}}
	101	+=== Edit your group ===
175	175
176		-== Delete lists ==
	103	+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"]], where you can select or deselect any users. If necessary, use the search bar located atop the list of contacts to find your contacts faster.
177	177
178		-To delete a list, tap and hold or swipe left on the list you want to delete and select [[image:Public.Applications.Android.User-Manual.WebHome@icons-delete.svg]] **Delete list**.
	105	+Confirm your selection of group members by tapping **Done.** You will return to your Contacts tab.
179	179
180		-Please notice that this action cannot be undone.
	107	+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.
181	181
182	182
183		-{{id name="03-groups"/}} {{id name="03-circles"/}}
	110	+{{id name="03-deleteyourgroup"/}}
184	184
185		-= Circles =
	112	+=== Delete your group ===
186	186
187		-[[image:Public.Applications.Android.User-Manual.WebHome@icons-circle.svg]] 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.
	114	+To delete a User Group, tap and hold the group concerned on the Contacts tab and until a prompt appears. Tap the prompt and confirm your action.
188	188
189		-Circles are managed by your Teamwire administrator and cannot be modified by you.
	116	+(% class="box" %)
	117	+(((
	118	+Please note that deleting User Groups is final and cannot be undone. You can only delete User Groups you have created yourself.
	119	+)))
190	190
191		-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.
192		-
193		-Circles usually have names you can easily associate to a group of people, e.g. departments or teams.
194		-
195		-
196		-{{id name="03-circles-public"/}}
197		-
198		-== Public circles ==
199		-
200		-Public circles are managed by your Teamwire administrator and cannot be modified by you.
201		-
202		-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.
203		-
204		-* **Example 1: Confidential information**
205		-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.
206		-
207		-* **Example 2: Emergency alert**
208		-In the event of a workplace accident, you have to call a predefined group of contacts via the emergency alert feature. Therefore, you have set the public circle "First aider" in your App settings as the [[Default circle>>doc:Public.Applications.Android.User-Manual.Profile.WebHome||anchor="05-sosgroup"]]. If an emergency occurs, you can get in contact with the "First aider" circle without inviting all other employees of the organisation.
209	209	## ##
	122	+{{id name="03-organisationgroups"/}}
210	210
211		-{{id name="03-bots"/}}
	124	+== Organisation Groups (Managed groups) ==
212	212
213		-= Bots =
	126	+These groups are created by your Teamwire administrator and cannot be modified. Use these groups to create a chat or to add members to an existing conversation at a later time.
214	214
215		-[[image:Public.Applications.Android.User-Manual.WebHome@icons-bot.svg]] 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.
	128	+Organisation Groups usually have names you can easily associate to a group of people, e.g. departments or teams.
216	216
217		-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.
	130	+The Organisation Groups are synchronised to all devices you have logged your Teamwire account into.
218	218
219	219
220	220	{{id name="03-updateyourcontactsandgroups"/}}
221	221
222		-= Update your Contacts and Circles =
	135	+= Update your Contacts and Groups =
223	223
224		-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 [[image:Public.Applications.Android.User-Manual.WebHome@icons-refresh.svg]] **Update Contacts** in the upper right corner of the screen.
	137	+The user accounts of your colleagues or new Organisation Groups are synchronised to your app automatically. However, if you are missing any users or groups in your list of contacts, you can fetch the latest data manually with the option **Update Contacts and Groups** via the menu in the right upper corner of the screen.
225	225
226		-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.
	139	+If the desired users do not appear despite 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.
227	227
228	228	## ##