Voorgestelde acties toevoegen aan berichten met de Bot Connector-API
Met voorgestelde acties kan uw bot knoppen presenteren waarop de gebruiker kan tikken om invoer te geven. Voorgestelde acties worden dicht bij de componist weergegeven en verbeteren de gebruikerservaring door de gebruiker in staat te stellen een vraag te beantwoorden of een selectie te maken met een eenvoudige tik op een knop, in plaats van een antwoord te typen met een toetsenbord. In tegenstelling tot knoppen die worden weergegeven in uitgebreide kaarten (die zichtbaar en toegankelijk blijven voor de gebruiker, zelfs nadat erop is getikt), verdwijnen knoppen die worden weergegeven in het deelvenster voorgestelde acties nadat de gebruiker een selectie heeft gemaakt. Dit voorkomt dat de gebruiker op verouderde knoppen in een gesprek tikt en vereenvoudigt botontwikkeling.
Voorgestelde acties verzenden
Als u voorgestelde acties wilt toevoegen aan een bericht, stelt u de suggestedActions eigenschap van het object Activity in om de lijst met CardAction-objecten op te geven die de knoppen vertegenwoordigen die aan de gebruiker moeten worden gepresenteerd.
Met de volgende aanvraag wordt een bericht verzonden met drie voorgestelde acties voor de gebruiker. In dit voorbeeld vertegenwoordigt de aanvraag https://smba.trafficmanager.net/teams de basis-URI; de basis-URI voor aanvragen die mogelijk verschillen van uw botproblemen. Zie API-verwijzing voor meer informatie over het instellen van de basis-URI.
POST https://smba.trafficmanager.net/teams/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
{
"type": "message",
"from": {
"id": "12345678",
"name": "sender's name"
},
"conversation": {
"id": "abcd1234",
"name": "conversation's name"
},
"recipient": {
"id": "1234abcd",
"name": "recipient's name"
},
"text": "I have colors in mind, but need your help to choose the best one.",
"inputHint": "expectingInput",
"suggestedActions": {
"actions": [
{
"type": "imBack",
"title": "Blue",
"value": "Blue"
},
{
"type": "imBack",
"title": "Red",
"value": "Red"
},
{
"type": "imBack",
"title": "Green",
"value": "Green"
}
]
},
"replyToId": "5d5cdc723"
}
Wanneer de gebruiker op een van de voorgestelde acties tikt, ontvangt de bot een bericht van de gebruiker met de value van de bijbehorende actie.