{"id":1854,"date":"2026-01-20T12:30:51","date_gmt":"2026-01-20T12:30:51","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=1854"},"modified":"2026-02-09T09:05:53","modified_gmt":"2026-02-09T09:05:53","slug":"connection-testing-validation","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-telemed-addon\/documentation\/configuration-telemed-addon\/connection-testing-validation\/","title":{"rendered":"Connection Testing &amp; Validation"},"content":{"rendered":"<div class=\"nolwrap\">\n<p>Avoid empty links during patient hours by validating your connection before going live.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udd18 Usage of the &#8220;Test Connection&#8221; Button<\/h2>\n\n\n\n<p>In the <strong>Global Settings<\/strong> or <strong>Doctor Dashboard<\/strong>, you will find a &#8220;Test Zoom Config&#8221; button. Clicking this triggers the <code>KCTZoom-&gt;test_connection()<\/code> method which performs three checks:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Credential Format:<\/strong> Checks if Client ID\/Secret are properly entered.<\/li>\n\n\n\n<li><strong>API Reachability:<\/strong> Attempts to ping <code>api.zoom.us\/v2\/<\/code>.<\/li>\n\n\n\n<li><strong>Token Validity:<\/strong> Verifies that the current access token allows for &#8220;Meeting Creation&#8221; scopes.<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\u2705 What a Successful Test Looks Like<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Message:<\/strong> &#8220;Connection Successful&#8221;<\/li>\n\n\n\n<li><strong>Metadata:<\/strong> Displays the Zoom Username linked to the account.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\u274c COMMON FAILURES<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Result Message<\/th><th class=\"has-text-align-left\" data-align=\"left\">Likely Cause<\/th><th class=\"has-text-align-left\" data-align=\"left\">Solution<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>Missing credentials<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">One of the ID\/Secret fields is empty.<\/td><td class=\"has-text-align-left\" data-align=\"left\">Fill all fields and save.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>Unauthorized<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">Client Secret is incorrect or App is deactivated.<\/td><td class=\"has-text-align-left\" data-align=\"left\">Double check Zoom Marketplace.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>Insufficient Scopes<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>meeting:write<\/code> was not added to the app.<\/td><td class=\"has-text-align-left\" data-align=\"left\">Update Scopes in Zoom Marketplace.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>Invalid Redirect<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">Wrong callback URL in Zoom settings.<\/td><td class=\"has-text-align-left\" data-align=\"left\">Copy-paste from KiviCare settings precisely.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udee0\ufe0f Manual Validation Step<\/h2>\n\n\n\n<p>If the test button passes but meetings aren&#8217;t created:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>Appointments<\/strong>.<\/li>\n\n\n\n<li>Create a test appointment for tomorrow.<\/li>\n\n\n\n<li>Check the <code>kc_appointment_zoom_mappings<\/code> table (or appointment details).<\/li>\n\n\n\n<li>If <code>zoom_id<\/code> is present, the end-to-end integration is perfect.<\/li>\n<\/ol>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>Avoid empty links during patient hours by validating your connection before going live. \ud83d\udd18 Usage of the &#8220;Test Connection&#8221; Button In the Global Settings or Doctor Dashboard, you will find a &#8220;Test Zoom Config&#8221; button. Clicking this triggers the KCTZoom-&gt;test_connection() method which performs three checks: \u2705 What a Successful Test Looks Like \u274c COMMON FAILURES [&hellip;]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[56],"tags":[],"class_list":["post-1854","post","type-post","status-publish","format-standard","hentry","category-configuration-telemed-addon"],"featured_image_src":null,"author_info":{"display_name":"wordpressadminiq","author_link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/author\/wordpressadminiq\/"},"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1854","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/comments?post=1854"}],"version-history":[{"count":4,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1854\/revisions"}],"predecessor-version":[{"id":2964,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1854\/revisions\/2964"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=1854"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=1854"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=1854"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}