![Response:
HTTP/1.1 200 OK
RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg8qbOF5xPGfiCpg4Fv0y8qqbxn - TOKEN
Authentication –W Secrets and Tokens
Request:
POST directline.botframework.com/api/tokens/conversations
Authorization: [BotConnector or Bearer] <secret key here>
This operation is optional. Use this step if you want to prevent clients from accessing
conversations they aren't participating in.](https://image.slidesharecdn.com/directlineapi-xamarin-170331053247/85/DirectLineAPI-Xamarin-Forms-App-and-Bot-Framework-Integration-6-320.jpg)
![Response:
{
"conversationId": "abc123",
"token“ :
"RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Create Conversation
Request:
POST directline.botframework.com/api/conversations/
Authorization: [BotConnector or Bearer] <secret key or token here>
Direct Line conversations are explicitly opened by clients and may run as long as the bot
and client participate (and have valid credentials. More than one client may connect to a
given conversation. If successful, the Direct Line service replies with a JSON object
containing a conversation ID and a token.](https://image.slidesharecdn.com/directlineapi-xamarin-170331053247/85/DirectLineAPI-Xamarin-Forms-App-and-Bot-Framework-Integration-8-320.jpg)
![Response:
HTTP/1.1 204 No Content
Send Message
Request:
POST directline.botframework.com/api/conversations/<conversationId>/messages
Authorization: [BotConnector or Bearer] <secret key or token here>
{ "text": "hello",
"from": "user1“ }
No data is returned in this call. If the bot generates an error, that error will trigger an HTTP
500 error in the POST /api/conversations/{conversationId}/messages call.](https://image.slidesharecdn.com/directlineapi-xamarin-170331053247/85/DirectLineAPI-Xamarin-Forms-App-and-Bot-Framework-Integration-9-320.jpg)
![Response:
{
"messages": [{ "conversation": "abc123", "id": "abc123|0000", "text": "hello", "from": "user1" }, {
"conversation": "abc123", "id": "abc123|0001", "text": "Nice to see you, user1!", "from": "bot1" }],
"watermark": "000002“
}
Get Bot Replies
Request:
GET directline.botframework.com/api/conversations/<conversationId>/messages
Authorization: [BotConnector or Bearer] <secret key or token here>
Clients issue GET calls to the /api/conversations/{conversationId}/messages endpoint to
get all messages inside the conversation. Optionally supply a watermark indicating the
most recent message seen.](https://image.slidesharecdn.com/directlineapi-xamarin-170331053247/85/DirectLineAPI-Xamarin-Forms-App-and-Bot-Framework-Integration-10-320.jpg)
![Response:
HTTP/1.1 200 OK
Refresh Conversation
Request:
GET directline.botframework.com/api/tokens/{conversationId}/renew
Authorization: [BotConnector or Bearer] <secret key or token here>
Conversations or tokens are valid for 30 minutes from the time they are generated.
Cannot be refreshed if it’s already expired.](https://image.slidesharecdn.com/directlineapi-xamarin-170331053247/85/DirectLineAPI-Xamarin-Forms-App-and-Bot-Framework-Integration-11-320.jpg)
DirectLineAPI - Xamarin.Forms App and Bot Framework Integration
- 1. BOT FRAMEWORK AND XAMARIN.FORMS APPLICATION INTEGRATION USING DIRECT LINE CLIENT API +
- 2. BRYAN ANTHONY GARCIA • Works at Avanade • Mobile Developer • Xamarin.Forms, UWP, HoloLens, Web, and Azure solutions • Graphic Designer Your Speaker
- 3. Direct Line API CLIENT APPLICATIONS DIRECT LINE CLIENT API BOT
- 4. Authorization Direct Line API RESTful Interface Create Conversation Send Message Get Reply Refresh Conversation
- 5. Authentication – Secret and Token Secret • Application-wide key to secure the direct line channel. • Can access any conversation, and create tokens. Secrets do not expire. Token • Optional • Conversation-specific key. • Tokens expire in 30 minutes, but can be refreshed.
- 6. Response: HTTP/1.1 200 OK RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg8qbOF5xPGfiCpg4Fv0y8qqbxn - TOKEN Authentication –W Secrets and Tokens Request: POST directline.botframework.com/api/tokens/conversations Authorization: [BotConnector or Bearer] <secret key here> This operation is optional. Use this step if you want to prevent clients from accessing conversations they aren't participating in.
- 7. directline.botframework.com routes your client to the nearest datacenter. This is the best option if you do not know where your client is located. asia.directline.botframework.com routes only to Direct Line servers in Eastern Asia. europe.directline.botframework.com routes only to Direct Line servers in Europe. northamerica.directline.botframework.com routes only to Direct Line servers in North America. Geographic Direct Line endpoints Use Geographic-specific endpoints to ensure your traffic ends up in exactly the right datacenter. A great way to avoid sending your packets on an accidental trans-Atlantic or trans-Pacific journey!
- 8. Response: { "conversationId": "abc123", "token“ : "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn", "expires_in": 1800 } Create Conversation Request: POST directline.botframework.com/api/conversations/ Authorization: [BotConnector or Bearer] <secret key or token here> Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate (and have valid credentials. More than one client may connect to a given conversation. If successful, the Direct Line service replies with a JSON object containing a conversation ID and a token.
- 9. Response: HTTP/1.1 204 No Content Send Message Request: POST directline.botframework.com/api/conversations/<conversationId>/messages Authorization: [BotConnector or Bearer] <secret key or token here> { "text": "hello", "from": "user1“ } No data is returned in this call. If the bot generates an error, that error will trigger an HTTP 500 error in the POST /api/conversations/{conversationId}/messages call.
- 10. Response: { "messages": [{ "conversation": "abc123", "id": "abc123|0000", "text": "hello", "from": "user1" }, { "conversation": "abc123", "id": "abc123|0001", "text": "Nice to see you, user1!", "from": "bot1" }], "watermark": "000002“ } Get Bot Replies Request: GET directline.botframework.com/api/conversations/<conversationId>/messages Authorization: [BotConnector or Bearer] <secret key or token here> Clients issue GET calls to the /api/conversations/{conversationId}/messages endpoint to get all messages inside the conversation. Optionally supply a watermark indicating the most recent message seen.
- 11. Response: HTTP/1.1 200 OK Refresh Conversation Request: GET directline.botframework.com/api/tokens/{conversationId}/renew Authorization: [BotConnector or Bearer] <secret key or token here> Conversations or tokens are valid for 30 minutes from the time they are generated. Cannot be refreshed if it’s already expired.
- 12. Prism MVVM https://github.com/PrismLibrary/Prism An MVVM framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Windows 10 UWP, and Xamarin Forms.
- 13. Xamarin Plugins https://github.com/xamarin/XamarinComponents Collection of open source components (including bindings and plugins) created by Xamarin and others in the community.