Wiki source code of c. Directory and Contacts

Last modified by teamwire003 on 2025/04/08 15:33

Hide last authors
teamwire001 2.1 1 The [[image:Public.Applications.iOS.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.
teamwire001 1.1 2
teamwire001 1.2 3 ## ##
teamwire001 2.1 4 [[image:Public.Applications.iOS.User-Manual.WebHome@directory-1.png||width="280px"]]
teamwire001 1.2 5 ## ##
teamwire001 1.1 6
teamwire001 1.2 7 {{id name="03-search"/}}
teamwire001 1.1 8
teamwire001 1.3 9 = Search =
teamwire001 1.1 10
teamwire001 2.1 11 Make use of the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-search.svg]] **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.
teamwire001 1.1 12
teamwire001 1.2 13 You can also search for names of lists, circles and bots.
teamwire001 1.1 14
15
teamwire001 1.2 16 {{id name="03-contacts"/}}
teamwire001 1.1 17
teamwire001 1.2 18 = Contacts =
teamwire001 1.1 19
teamwire003 3.2 20 In the [[image:Public.Applications.iOS.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.iOS.User-Manual.WebHome@icons-list-sort.svg]] **Sort order** in the upper right corner of the screen.
teamwire001 1.1 22
23
teamwire001 1.2 24 {{id name="03-contactdata"/}}
teamwire001 1.1 25
teamwire001 1.2 26 == Contact info ==
teamwire001 1.1 27
teamwire001 1.2 28 Tap on a contact's name to open their profile and contact information.
teamwire001 1.1 29
teamwire001 2.1 30 Depending on the data each of them has added, you will find a profile picture and info about their [[image:Public.Applications.iOS.User-Manual.WebHome@icons-place.svg]] Organisation, [[image:Public.Applications.iOS.User-Manual.WebHome@icons-department.svg]] Department, [[image:Public.Applications.iOS.User-Manual.WebHome@icons-position.svg]] Role, or even [[image:Public.Applications.iOS.User-Manual.WebHome@icons-voice-single.svg]] phone number.
teamwire001 1.1 31
teamwire003 1.4 32 ## ##
33 [[image:Public.Applications.iOS.User-Manual.WebHome@EN__contacts-userprofile.png||width="280"]]
34 ## ##
teamwire001 1.1 35
teamwire001 1.3 36 {{id name="03-contactchat"/}}
37
38 === Start chat ===
39
teamwire001 2.1 40 Start a 1:1 conversation by tapping the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-chat-new.svg]] **chat** symbol. You will be forwarded to the chat view automatically.
teamwire001 1.3 41
42
43 {{id name="03-contactvoipvideo"/}}
44
45 === Start video call ===
46
teamwire001 2.1 47 Start a video call by tapping the [[image:Public.Applications.iOS.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.
teamwire001 1.3 48
49
50 {{id name="03-contactvoipvoice"/}}
51
52 === Start voice call ===
53
teamwire001 2.1 54 Start a voice call by tapping the [[image:Public.Applications.iOS.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.
teamwire001 1.3 55
teamwire001 1.5 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.
teamwire001 1.3 57
58
teamwire001 1.2 59 {{id name="03-contactphone"/}}
teamwire001 1.1 60
teamwire001 1.3 61 === Call phone number ===
teamwire001 1.1 62
teamwire001 2.1 63 If the user has added their phone number to their contact data, you will find a [[image:Public.Applications.iOS.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.
teamwire001 1.1 64
65
teamwire001 1.2 66 {{id name="03-contactemail"/}}
teamwire001 1.1 67
teamwire001 1.2 68 === Send email ===
teamwire001 1.1 69
teamwire001 2.1 70 If the user has added their email address to their contact data, you will find an [[image:Public.Applications.iOS.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.
teamwire001 1.1 71
72
73 {{id name="03-blockauser"/}}
74
teamwire001 1.2 75 === Block a user ===
teamwire001 1.1 76
teamwire001 1.2 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.
teamwire001 1.1 78
teamwire003 3.2 79 To block a user, open their profile and tap  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-block.svg]] **Block user**. Their profile will show a button to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-block.svg]] **Unblock user**, if you have already blocked them. Thus, you will be able to revoke a block.
teamwire001 1.1 80
teamwire001 2.1 81 Alternatively, you can find a list of all blocked users in your privacy settings at [[Blocked contacts>>doc:Public.Applications.iOS.User-Manual.Profile.WebHome||anchor="05-privacy"]] where you can unblock them.
teamwire001 1.2 82
83 (% class="box infomessage" %)
teamwire001 1.1 84 (((
teamwire001 1.2 85 If you cannot block a contact, the feature may have been disabled by your Teamwire administrator.
teamwire001 1.1 86 )))
87
teamwire001 1.2 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 * Your Teamwire administrator has enabled a policy allowing the communication with external users
100 * The users are hosted on the same Teamwire Server (//backend//)
teamwire001 1.1 101 ## ##
102
teamwire001 1.2 103 {{id name="03-contacts-organisations"/}}
teamwire001 1.1 104
teamwire001 1.2 105 == Contacts from other organisations ==
teamwire001 1.1 106
teamwire001 1.2 107 If your Teamwire admin allows communicating with externals, you may find users from other organisations in your contacts.
teamwire001 1.1 108
teamwire001 1.2 109 Use the magnifier to open the search bar and look for users. Their associated organisation name will be shown.
teamwire001 1.1 110
teamwire001 1.2 111 **Requirements for finding users from other organisations**
teamwire001 1.1 112
teamwire001 1.2 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 ## ##
teamwire001 1.1 117
teamwire001 1.2 118 {{id name="03-contacts-federated"/}}
teamwire001 1.1 119
teamwire001 1.2 120 == Federated contacts ==
teamwire001 1.1 121
teamwire001 1.2 122 If your Teamwire administrator has enabled Teamwire Federation, you may find users of other organisations from another Teamwire Server (//backend//) in your contacts.
teamwire001 1.1 123
teamwire001 2.1 124 They will automatically be shown in your list of contacts. They will show the Teamwire Federation icon [[image:Public.Applications.iOS.User-Manual.WebHome@icons-federated.svg]] and their associated backend name.
teamwire001 1.1 125
teamwire001 1.2 126 **Requirements for synchronising external users from another Teamwire Server**
teamwire001 1.1 127
teamwire001 1.2 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 ## ##
teamwire001 1.1 131
teamwire001 1.2 132 {{id name="03-lists"/}}
teamwire001 1.1 133
teamwire001 1.2 134 = Lists =
teamwire001 1.1 135
teamwire001 2.1 136 [[image:Public.Applications.iOS.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.
teamwire001 1.1 137
teamwire001 1.2 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".
teamwire001 1.1 139
teamwire001 1.2 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.
teamwire001 1.1 141
teamwire001 1.2 142 Your lists are synchronised to all devices you have logged in with your Teamwire account.
teamwire001 1.1 143
144
teamwire001 1.2 145 {{id name="03-createalist"/}}
teamwire001 1.1 146
teamwire001 1.2 147 == Create a list ==
teamwire001 1.1 148
teamwire001 2.1 149 To create a new list, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icons-list-new.svg]] **New List**.
teamwire001 1.1 150
teamwire001 1.2 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 **Next** to continue.
teamwire001 1.1 153
teamwire001 1.2 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 ## ##
teamwire001 1.1 157
teamwire001 2.1 158 Confirm the creation of your list by tapping **Create**. You will return to the directory.
teamwire001 1.1 159
160
teamwire001 1.2 161 {{id name="03-edityourlist"/}}
teamwire001 1.1 162
teamwire001 3.1 163 == Manage list members ==
teamwire001 1.2 164
teamwire001 3.1 165 You can adjust the members on your lists.
teamwire001 1.2 166
teamwire001 3.1 167 * **Add members**
teamwire003 3.2 168 Swipe left on the list you want to edit and select [[image:https://wiki-internal.teamwire.eu:11443/bin/download/Public/Applications/iOS/User-Manual/WebHome/icons-editmember.svg?rev=1.1||alt="icons-editmember.svg"]] **Edit members**.
169 Alternatively, tap on the name of the list to view its current members, and select [[image:https://wiki-internal.teamwire.eu:11443/bin/download/Public/Applications/iOS/User-Manual/WebHome/icons-adduser.svg?rev=1.2||alt="icons-adduser.svg"]] **Add members** (lower-right).
teamwire001 1.2 170
teamwire001 3.1 171 * **Remove members**
172 Tap on the name of the list to view its current members, and tap on the user to open the action menu. There select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-delete.svg]] **Remove from list**.
173 ## ##
174
teamwire001 1.2 175 (% class="box warningmessage" %)
teamwire001 1.1 176 (((
teamwire001 1.2 177 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.
teamwire001 1.1 178 )))
179
teamwire001 3.1 180
181
teamwire003 3.2 182
183
184
185
186
187
188
189
teamwire001 3.1 190 {{id name="03-renameyourlist"/}}
191
192 == Rename lists ==
193
teamwire003 3.2 194 To rename one of your lists, tap and hold or swipe left on the list and select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-edit.svg]] **Rename list**.
teamwire001 3.1 195
teamwire003 3.2 196 Alternatively, tap on the name of the list to view its current members. Select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-edit.svg]] **Rename list** and adjust its name.
teamwire001 3.1 197
198
teamwire001 1.2 199 {{id name="03-deleteyourlist"/}}
200
201 == Delete lists ==
202
teamwire003 3.2 203 To delete a list, tap and hold or swipe left on the list you want to delete and select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-delete.svg]] **Delete list**.
teamwire001 1.2 204
205 Please notice that this action cannot be undone.
206
207
208 {{id name="03-groups"/}} {{id name="03-circles"/}}
209
210 = Circles =
211
teamwire001 2.1 212 [[image:Public.Applications.iOS.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.
teamwire001 1.2 213
214 Circles are managed by your Teamwire administrator and cannot be modified by you.
215
216 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.
217
218 Circles usually have names you can easily associate to a group of people, e.g. departments or teams.
219
220
221 {{id name="03-circles-public"/}}
222
223 == Public circles ==
224
225 Public circles are managed by your Teamwire administrator and cannot be modified by you.
226
227 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.
228
229 * **Example 1: Confidential information**
teamwire001 2.1 230 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". You get in contact with the "Personnel office" circle without inviting all other employees of the organisation.
teamwire001 1.2 231
teamwire001 2.1 232 * **Example 2: Emergency alert**
233 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.iOS.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.
teamwire001 1.1 234 ## ##
235
teamwire001 1.2 236 {{id name="03-bots"/}}
teamwire001 1.1 237
teamwire001 1.2 238 = Bots =
teamwire001 1.1 239
teamwire001 2.1 240 [[image:Public.Applications.iOS.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.
teamwire001 1.1 241
teamwire001 1.2 242 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.
teamwire001 1.1 243
244
245 {{id name="03-updateyourcontactsandgroups"/}}
246
teamwire001 1.2 247 = Update your Contacts and Circles =
teamwire001 1.1 248
teamwire003 3.2 249 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.iOS.User-Manual.WebHome@icons-refresh.svg]] **Update Contacts** in the upper right corner of the screen.
teamwire001 1.1 250
teamwire001 1.2 251 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.
teamwire001 1.1 252
253 ## ##