|
| 1 | +--- |
| 2 | +external help file: Microsoft.Rtc.Management.dll-Help.xml |
| 3 | +online version: https://learn.microsoft.com/powershell/module/teams/New-CsMainlineAttendantQuestionAnswerFlow |
| 4 | +applicable: Microsoft Teams |
| 5 | +title: New-CsMainlineAttendantQuestionAnswerFlow |
| 6 | +author: tomkau |
| 7 | +ms.author: tomkau |
| 8 | +manager: bulenteg |
| 9 | +ms.reviewer: |
| 10 | +schema: 2.0.0 |
| 11 | +--- |
| 12 | + |
| 13 | +# New-CsMainlineAttendantQuestionAnswerFlow |
| 14 | + |
| 15 | +## SYNOPSIS |
| 16 | +Creates new Mainline Attendant question and answer (FAQ) flow |
| 17 | + |
| 18 | +## SYNTAX |
| 19 | + |
| 20 | +``` |
| 21 | +New-CsMainlineAttendantQuestionAnswerFlow -Name <String> -Description <String> -ApiAuthenticationType <basic | api_key | bearer_token_static | bearer_token_dynamic> -KnowledgeBase <String> [-Tenant <Guid>] [<CommonParameters>] |
| 22 | +``` |
| 23 | + |
| 24 | +## DESCRIPTION |
| 25 | +The New-CsMainlineAttendantQuestionAnswerFlow cmdlet creates a question and answer connection that can be used with Mainline Attendant |
| 26 | + |
| 27 | +> [!CAUTION] |
| 28 | +> This cmdlet will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time. |
| 29 | +
|
| 30 | +## EXAMPLES |
| 31 | + |
| 32 | + |
| 33 | +## PARAMETERS |
| 34 | + |
| 35 | +### -Name |
| 36 | +The name of the question and answer flow |
| 37 | + |
| 38 | +```yaml |
| 39 | +Type: String |
| 40 | +Parameter Sets: (All) |
| 41 | +Aliases: |
| 42 | +applicable: Microsoft Teams |
| 43 | + |
| 44 | +Required: True |
| 45 | +Position: Named |
| 46 | +Default value: None |
| 47 | +Accept pipeline input: False |
| 48 | +Accept wildcard characters: False |
| 49 | +``` |
| 50 | +
|
| 51 | +### -Description |
| 52 | +The description for the question and answer flow |
| 53 | +
|
| 54 | +```yaml |
| 55 | +Type: String |
| 56 | +Parameter Sets: (All) |
| 57 | +Aliases: |
| 58 | +applicable: Microsoft Teams |
| 59 | + |
| 60 | +Required: True |
| 61 | +Position: Named |
| 62 | +Default value: None |
| 63 | +Accept pipeline input: False |
| 64 | +Accept wildcard characters: False |
| 65 | +``` |
| 66 | +
|
| 67 | +### -ApiAuthenticationType |
| 68 | +The method of authentication used by the API |
| 69 | +
|
| 70 | +PARAVALUES: basic | api_key | bearer_token_static | bearer_token_dynamic |
| 71 | +
|
| 72 | +```yaml |
| 73 | +Type: String |
| 74 | +Parameter Sets: (All) |
| 75 | +Aliases: |
| 76 | +applicable: Microsoft Teams |
| 77 | + |
| 78 | +Required: True |
| 79 | +Position: Named |
| 80 | +Default value: None |
| 81 | +Accept pipeline input: False |
| 82 | +Accept wildcard characters: False |
| 83 | +``` |
| 84 | +
|
| 85 | +### -KnowledgeBase |
| 86 | +The knowledge base definition |
| 87 | +
|
| 88 | +````json |
| 89 | +[ |
| 90 | +
|
| 91 | +{ |
| 92 | +
|
| 93 | +"address_type" : "local_file", |
| 94 | +
|
| 95 | +"document_address" : "<local_address>", // provide full path to the local address |
| 96 | +
|
| 97 | +"description" : "<description>" |
| 98 | +
|
| 99 | + |
| 100 | +
|
| 101 | +}, |
| 102 | +
|
| 103 | +{ |
| 104 | +
|
| 105 | +"address_type" : "webpage", |
| 106 | +
|
| 107 | +"document_address" : "<web_address>", // provide full path to the webpage |
| 108 | +
|
| 109 | +"description" : "<description>" |
| 110 | +
|
| 111 | + |
| 112 | +
|
| 113 | +}, |
| 114 | +
|
| 115 | +{ |
| 116 | +
|
| 117 | +"address_type" : "api_endpoint", |
| 118 | +
|
| 119 | +"description" : "<description>", |
| 120 | +
|
| 121 | +"api_specification" : { |
| 122 | +
|
| 123 | +"generateAuthToken" : { // Must be specified for "bearer_token_dynamic" |
| 124 | +
|
| 125 | +"endpoint" : "<endpoint>", // For example, https://www.contoso.com/home?parameter1=<parameter1>¶meter2=<parameter2> |
| 126 | +
|
| 127 | +"method_type": "GET" or "PUT" or "POST", |
| 128 | +
|
| 129 | +"description" : "<description>", |
| 130 | +
|
| 131 | +"query_strings" : { // Description of the query string parameters in the endpoint |
| 132 | +
|
| 133 | +"parameter1" : "<parameter1>", |
| 134 | +
|
| 135 | +"parameter2" : "<parameter2>" |
| 136 | +
|
| 137 | +}, |
| 138 | +
|
| 139 | +"headers" : { |
| 140 | +
|
| 141 | +"Authorization" : "Basic <constant>" or "api-key <constant>" or "Bearer <constant>", // replace <constant> with an expected value |
| 142 | +
|
| 143 | +"X-API-Key" : "API-Key" // Only applicable for "api_key" auth type. |
| 144 | +
|
| 145 | +}, |
| 146 | +
|
| 147 | +"response" : { // Response to 200 range of codes |
| 148 | +
|
| 149 | +"token" : "<token>" // this token will be used for APIs with "bearer_token_dynamic" auth type |
| 150 | +
|
| 151 | +} |
| 152 | +
|
| 153 | +}, |
| 154 | +
|
| 155 | +"getResults1" : { |
| 156 | +
|
| 157 | +"endpoint" : "<endpoint>", // For example, https://www.contoso.com/home?parameter1=<parameter1>¶meter2=<parameter2> |
| 158 | +
|
| 159 | +"method_type": "GET" or "PUT" or "POST", |
| 160 | +
|
| 161 | +"description" : "<description>", |
| 162 | +
|
| 163 | +"query_strings" : { // Definition of the query string parameters in the endpoint |
| 164 | +
|
| 165 | +"parameter1" : "<parameter1>", |
| 166 | +
|
| 167 | +"parameter2" : "<parameter2>" |
| 168 | +
|
| 169 | +}, |
| 170 | +
|
| 171 | +"headers" : { |
| 172 | +
|
| 173 | +"Authorization" : "Basic <constant>" or "api-key <constant>" or "Bearer <constant>" or "Bearer <token>", // replace <constant> with an expected value. <token> will be replaced by the response to generateAuthToken() |
| 174 | +
|
| 175 | +"X-API-Key" : "API-Key" // Only applicable for "api_key" auth type. |
| 176 | +
|
| 177 | +}, |
| 178 | +
|
| 179 | +"body" : { // Sent as JSON payload |
| 180 | +
|
| 181 | +"in_parameter1" : "<in_parameter1>", |
| 182 | +
|
| 183 | +"in_parameter2" : "<in_parameter2>" |
| 184 | +
|
| 185 | +}, |
| 186 | +
|
| 187 | +"response" : { // Response to 200 range of codes |
| 188 | +
|
| 189 | +"out_parameter1" : "<out_parameter1>", |
| 190 | +
|
| 191 | +"out_parameter2" : "<out_parameter2>", |
| 192 | +
|
| 193 | +"out_parameter3" : "<out_parameter3>" |
| 194 | +
|
| 195 | +} |
| 196 | +
|
| 197 | +}, |
| 198 | +
|
| 199 | +"getResults2" : { |
| 200 | +
|
| 201 | +"endpoint" : "<endpoint>", // For example, https://www.contoso.com/home?parameter1=<parameter1>¶meter2=<parameter2> |
| 202 | +
|
| 203 | +"method_type": "GET" or "PUT" or "POST" |
| 204 | +
|
| 205 | +"description" : "<description>", |
| 206 | +
|
| 207 | +"query_strings" : { // Definition of the query string parameters in the endpoint |
| 208 | +
|
| 209 | +"parameter1" : "<parameter1>", |
| 210 | +
|
| 211 | +"parameter2" : "<parameter2>" |
| 212 | +
|
| 213 | +}, |
| 214 | +
|
| 215 | +"headers" : { |
| 216 | +
|
| 217 | +"Authorization" : "Basic <constant>" or "api-key <constant>" or "Bearer <constant>" or "Bearer <token>", // replace <constant> with an expected value. <token> will be replaced by the response to generateAuthToken() |
| 218 | +
|
| 219 | +"X-API-Key" : "API-Key" // Only applicable for "api_key" auth type. |
| 220 | +
|
| 221 | +}, |
| 222 | +
|
| 223 | +"body" : { // Sent as JSON payload |
| 224 | +
|
| 225 | +"in_parameter1" : "<in_parameter1>", |
| 226 | +
|
| 227 | +"in_parameter2" : "<in_parameter2>" |
| 228 | +
|
| 229 | +}, |
| 230 | +
|
| 231 | +"response" : { // Response to 200 range of codes |
| 232 | +
|
| 233 | +"out_parameter1" : "<out_parameter1>", |
| 234 | +
|
| 235 | +"out_parameter2" : "<out_parameter2>", |
| 236 | +
|
| 237 | +"out_parameter3" : "<out_parameter3>" |
| 238 | +
|
| 239 | +} |
| 240 | +
|
| 241 | +} |
| 242 | +
|
| 243 | +} |
| 244 | +
|
| 245 | +} |
| 246 | +
|
| 247 | +] |
| 248 | +```` |
| 249 | +
|
| 250 | +```yaml |
| 251 | +Type: String |
| 252 | +Parameter Sets: (All) |
| 253 | +Aliases: |
| 254 | +applicable: Microsoft Teams |
| 255 | + |
| 256 | +Required: True |
| 257 | +Position: Named |
| 258 | +Default value: None |
| 259 | +Accept pipeline input: False |
| 260 | +Accept wildcard characters: False |
| 261 | +``` |
| 262 | +
|
| 263 | +### CommonParameters |
| 264 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). |
| 265 | +
|
| 266 | +## INPUTS |
| 267 | +
|
| 268 | +## OUTPUTS |
| 269 | +
|
| 270 | +### Microsoft.Rtc.Management.Hosted.CallQueue.Models.CallQueue |
| 271 | +
|
| 272 | +## NOTES |
| 273 | +
|
| 274 | +## RELATED LINKS |
| 275 | +
|
0 commit comments