{"id":1856,"date":"2026-01-20T12:31:21","date_gmt":"2026-01-20T12:31:21","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=1856"},"modified":"2026-02-09T09:06:59","modified_gmt":"2026-02-09T09:06:59","slug":"troubleshooting-common-errors-2","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-telemed-addon\/documentation\/configuration-telemed-addon\/troubleshooting-common-errors-2\/","title":{"rendered":"Troubleshooting &amp; Common Errors"},"content":{"rendered":"<div class=\"nolwrap\">\n<p>If you encounter issues with the Telemedicine integration, follow this guide to resolve common problems.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udea9 Problem: Zoom Link is Missing in Appointment<\/h2>\n\n\n\n<p>The appointment was created, but no &#8220;Join&#8221; button appears.<\/p>\n\n\n\n<p><strong>Solutions:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Check Service Settings:<\/strong> Ensure the specific service has &#8220;Telemedicine&#8221; enabled.<\/li>\n\n\n\n<li><strong>Doctor Status:<\/strong> Go to the Doctor&#8217;s profile and ensure they are &#8220;Connected&#8221; to Zoom.<\/li>\n\n\n\n<li><strong>Log Files:<\/strong> Check the KiviCare logs (or WordPress <code>debug.log<\/code>) for any <code>WP_Error<\/code> from the Zoom API.<\/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\">\ud83d\udea9 Problem: &#8220;Invalid Access Token&#8221; Error<\/h2>\n\n\n\n<p>This typically happens when the OAuth handshake is broken or the token has expired without refreshing.<\/p>\n\n\n\n<p><strong>Solutions:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Refresh Connection:<\/strong> Have the doctor disconnect and reconnect their Zoom account.<\/li>\n\n\n\n<li><strong>Check SSL:<\/strong> If your site is not 100% HTTPS, Zoom will refuse to issue or refresh tokens.<\/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\">\ud83d\udea9 Problem: Meeting Duration is too Short<\/h2>\n\n\n\n<p>Meetings end unexpectedly after 40 minutes.<\/p>\n\n\n\n<p><strong>Reason:<\/strong> You are likely using a <strong>Zoom Basic (Free)<\/strong> account which enforces a 40-minute limit on group calls.<br><strong>Solution:<\/strong> Upgrade to Zoom Pro to remove this limit.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udca1 Quick Fix Checklist<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Force Token Refresh:<\/strong> Toggle auth from <code>OAuth<\/code> to <code>None<\/code> and back to <code>OAuth<\/code>.<\/li>\n\n\n\n<li><strong>Clear WP Cache:<\/strong> If using a caching plugin, clear it after updating API settings.<\/li>\n\n\n\n<li><strong>Check Zoom App Status:<\/strong> Log into Zoom Marketplace and ensure your app is not &#8220;Disabled&#8221; or pending review.<\/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\">\ud83d\udcde Escalating to Support<\/h2>\n\n\n\n<p>If none of the above work:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Enable <code>WP_DEBUG<\/code>.<\/li>\n\n\n\n<li>Reproduce the error by creating an appointment.<\/li>\n\n\n\n<li>Copy the error from <code>wp-content\/debug.log<\/code>.<\/li>\n\n\n\n<li>Submit a ticket to <a href=\"https:\/\/apps.iqonic.design\/support\/\" target=\"_blank\" rel=\"noopener\">IQONIC Support<\/a>.<\/li>\n<\/ol>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>If you encounter issues with the Telemedicine integration, follow this guide to resolve common problems. \ud83d\udea9 Problem: Zoom Link is Missing in Appointment The appointment was created, but no &#8220;Join&#8221; button appears. Solutions: \ud83d\udea9 Problem: &#8220;Invalid Access Token&#8221; Error This typically happens when the OAuth handshake is broken or the token has expired without refreshing. [&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-1856","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\/1856","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=1856"}],"version-history":[{"count":2,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1856\/revisions"}],"predecessor-version":[{"id":2965,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1856\/revisions\/2965"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=1856"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=1856"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=1856"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}