{"id":2259,"date":"2018-10-29T22:37:27","date_gmt":"2018-10-29T22:37:27","guid":{"rendered":"https:\/\/www.k12insight.com\/kc\/?post_type=article&#038;p=2259"},"modified":"2024-07-26T07:05:37","modified_gmt":"2024-07-26T07:05:37","slug":"api-integrations-for-lets-talk","status":"publish","type":"post","link":"https:\/\/www.k12insight.com\/kc\/getting-started\/api-integrations-for-lets-talk\/","title":{"rendered":"API Integrations for Let's Talk"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Currently, the Let\u2019s Talk! platform provides an API integration for the following use cases:<\/span><\/p>\n<ol>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Login to Let\u2019s Talk platform through SSO<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Creation of New Ticket<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Update existing Tickets in system<\/span><\/li>\n<\/ol>\n<h2><b>Login in Let\u2019s Talk! platform<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform supports different single sign-on (SSO) methods for login. As of now the Let\u2019s Talk! platform has been integrated with various AD systems such as Identity Automation, Microsoft Azure, OneLogin, Google Active Directory Sync (GADS), etc. Below is the list of SSO methods supported in Let\u2019s Talk! Platform.<\/span><\/p>\n<h4><b>SAML SSO<\/b><\/h4>\n<p><span style=\"font-weight: 400;\">Using SSO, a user can log in once and gain access to different applications, without the need to re-enter log-in credentials at each application. Security Assertion Markup Language (SAML) is a standard protocol for web browser Single Sign-On (SSO) using secure tokens.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Let\u2019s Talk! supports all <\/span><b>IdP initiated SAML SSO<\/b><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The team will need the following information from the client to setup an SSO.<\/span><\/p>\n<ol>\n<li><span style=\"font-weight: 400;\"> Metadata of IdP<\/span><\/li>\n<li><span style=\"font-weight: 400;\"> Certificate for establishing SSO<\/span><\/li>\n<\/ol>\n<p><span style=\"font-weight: 400;\">After receiving the information above, the team will share our metadata and certificate that the client needs to set up in their AD.<\/span><\/p>\n<h4><b>Using any AD\/LDAP<\/b><\/h4>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform supports SSO through various AD systems. For an AD\/LDAP integration, the client needs to provide the following information:<\/span><\/p>\n<ol>\n<li><span style=\"font-weight: 400;\"> AD URL<\/span><\/li>\n<li><span style=\"font-weight: 400;\"> AD user id: A test user needs to be created in the AD that the Let\u2019s Talk! system can use to authenticate<\/span><\/li>\n<li><span style=\"font-weight: 400;\"> AD password: Password of the test user that is created in the AD<\/span><\/li>\n<\/ol>\n<p><span style=\"font-weight: 400;\">Additionally, in the client's AD directory there should be a separate field or a group with the name <\/span><b><i>AllowLT<\/i><\/b><span style=\"font-weight: 400;\">. All users with AllowLT field value of \u2018Yes\u2019 will be allowed to log into Let\u2019s Talk! Platform and vice versa.<\/span><\/p>\n<h4><b>Google based SSO<\/b><\/h4>\n<p><span style=\"font-weight: 400;\">We already have fully functional Google based SSO. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">If clients with Gmail based email addresses are also registered as Let\u2019s Talk! Users through the same Gmail email address, then Google based SSO will automatically work for them.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Users who have already logged into their Google account do not need to authenticate again when logging into Let\u2019s Talk! They can simply click a button on the page below and log into their account.<\/span><\/p>\n<p><a href=\"https:\/\/k12insight.com\/SSO.aspx\"><span style=\"font-weight: 400;\">https:\/\/k12insight.com\/SSO.aspx<\/span><\/a><\/p>\n<h2><b>API Functionality: Creation of New Tickets<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform supports APIs which can be used to create new tickets\/tickets\/issue request into different platforms. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform can deposit the data received in its own Ticket submission form to other systems\/ticketing solutions and open a new ticket in these systems.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform supports both <\/span><b>SOAP <\/b><span style=\"font-weight: 400;\">and <\/span><b>REST <\/b><span style=\"font-weight: 400;\">API protocols.<\/span><\/p>\n<h2><b>API Functionality: Update existing Tickets in Let\u2019s Talk! Platform<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">The Let\u2019s Talk! platform can provide APIs which can be used to update the existing Tickets present in your account. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">The basic update that can be done using the API is updating the status of the Ticket. However, based on the requirement of different users, The Let\u2019s Talk! platform can provide APIs to make various updates to existing Tickets. Some of the update examples are listed below. \u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Adding\/deleting team members in Tickets<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Automatically assigning Ticket to different user\/departments based on predefined conditions<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Sending predefined email replies to Ticket customers<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Ticket escalation to different team members based on the duration of Ticket.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Authentication for the API call above can be done with two methods:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">IP address authentication<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">User authentication<\/span><\/li>\n<\/ul>\n<h4><b>Sample web service <\/b><\/h4>\n<p><span style=\"font-weight: 400;\">Check out a sample web service for updating existing Ticket status <\/span><\/p>\n<p><a href=\"http:\/\/www.k12insight.com\/lets-talk\/webservice\/LetsTalkPlatFormCustom.asmx?op=UpdateStatus\"><span style=\"font-weight: 400;\">http:\/\/www.k12insight.com\/lets-talk\/webservice\/LetsTalkPlatFormCustom.asmx?op=UpdateStatus<\/span><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Currently, the Let\u2019s Talk! platform provides an API integration for the following use cases: Login to Let\u2019s Talk platform through SSO Creation of New Ticket Update existing Tickets in system Login in Let\u2019s Talk! platform The Let\u2019s Talk! platform supports different single sign-on (SSO) methods for login. As of now the Let\u2019s Talk! platform has...<\/p>\n","protected":false},"author":27,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[451],"class_list":["post-2259","post","type-post","status-publish","format-standard","hentry","category-getting-started","tag-integrations"],"_links":{"self":[{"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/posts\/2259","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/comments?post=2259"}],"version-history":[{"count":2,"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/posts\/2259\/revisions"}],"predecessor-version":[{"id":9973,"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/posts\/2259\/revisions\/9973"}],"wp:attachment":[{"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/media?parent=2259"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.k12insight.com\/kc\/wp-json\/wp\/v2\/categories?post=2259"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}