{"id":17610,"date":"2023-03-02T20:01:18","date_gmt":"2023-03-02T17:01:18","guid":{"rendered":"https:\/\/trueconf.com/blog\/?p=17610"},"modified":"2025-10-02T15:14:56","modified_gmt":"2025-10-02T12:14:56","slug":"how-to-connect-a-guest-to-a-conference-directly","status":"publish","type":"post","link":"https:\/\/trueconf.com/blog\/knowledge-base\/how-to-connect-a-guest-to-a-conference-directly","title":{"rendered":"How to connect a guest to a conference directly"},"content":{"rendered":"<p>With TrueConf, you can implement a number of use case scenarios to bring video conferencing capabilities to various industries: <a href=\"https:\/\/trueconf.com\/business.html\" target=\"_blank\" rel=\"noopener\">business<\/a>, <a href=\"https:\/\/trueconf.com\/education.html\" target=\"_blank\" rel=\"noopener\">education<\/a>, <a href=\"https:\/\/trueconf.com\/telemedicine.html\" target=\"_blank\" rel=\"noopener\">healthcare<\/a>,\u00a0<a href=\"https:\/\/trueconf.com\/government.html\" target=\"_blank\" rel=\"noopener\">government<\/a>, etc. Even more video conferencing features are available with the help of <b>TrueConf Server API<\/b>, which helps your apps interact with <a href=\"https:\/\/trueconf.com\/products\/server\/video-conferencing-server.html\" target=\"_blank\" rel=\"noopener\">TrueConf Server<\/a>.<\/p>\n<p>This article shows how to connect a <a href=\"https:\/\/trueconf.com\/blog\/wiki\/online-user-guest\" target=\"_blank\" rel=\"noopener\">guest<\/a> (a participant who doesn\u2019t have an account on your video conferencing server) to a conference directly \u2014 without entering a guest\u2019s name manually.<\/p>\n<p>This feature can be convenient when using TrueConf in the telemedicine sphere (e.g. a use case where doctors have video-enabled apps for holding online telemedicine consultations). Users log in to their personal accounts on the website that provides medical services and arrange virtual appointments at a certain time. Doctors have their accounts on the server, while users don\u2019t need to have user accounts to participate in online sessions.<!--more--><\/p>\n<p>Here, we will show how to configure settings so that a guest user can join a conference either from a browser (<a href=\"https:\/\/trueconf.com\/webrtc.html\" target=\"_blank\" rel=\"noopener\">via WebRTC<\/a>) or from a <a href=\"https:\/\/trueconf.com\/downloads\/\" target=\"_blank\" rel=\"noopener\">client application<\/a>. The second option offers meeting participants a wider range of features and opportunities. So, you will be able to post a link to this conference on your website so that users could from a browser or from a client application as it is done on a standard conference page.<\/p>\n<h2>Preconfiguring TrueConf Server<\/h2>\n<ol>\n<li>First, open the control panel, go to the <strong>Dashboard \u2192 Summary<\/strong>, and check if there is the required number of guest connections in your license.\n<p style=\"text-align: justify;\">If you are using TrueConf Server Free, you can create public conferences with one guest connection. If you need to increase the number of guest connections, contact our <a href=\"https:\/\/trueconf.com\/company\/contacts.html\" target=\"_blank\" rel=\"noopener\">sales team<\/a> to purchase this extension or request a free trial for up to 3 weeks. <\/p>\n<\/li>\n<li>Set up an HTTPS connection to work with the API.<\/li>\n<\/ol>\n<p>Next, you can use various API methods over OAuth 2.0 protocol. Learn more about how to set up interaction with TrueConf Server over this protocol in our article \u201c<a href=\"https:\/\/trueconf.com\/blog\/knowledge-base\/how-to-get-started-with-trueconf-api.html\" target=\"_blank\" rel=\"noopener\">How to get started with TrueConf API<\/a>\u201d.<\/p>\n<h2>Step 1: Create a scheduled public conference<\/h2>\n<p>By using the <a href=\"https:\/\/developers.trueconf.com\/api\/server\/#api-Conferences-CreateConference\" target=\"_blank\" rel=\"noopener\">Create Conference method<\/a>, create a new video conference and set the following parameters:<\/p>\n<ul>\n<li><a href=\"https:\/\/trueconf.com\/blog\/wiki\/owner\" target=\"_blank\" rel=\"noopener\">Owner<\/a> and list of <a href=\"https:\/\/trueconf.com\/blog\/wiki\/conference-participant\" target=\"_blank\" rel=\"noopener\">participants<\/a> \u2014 specify the doctor\u2019s TrueConf ID (login) for both parameters<\/li>\n<li>Number of participants \u2014 2<\/li>\n<li>Launch type \u2014 scheduled, i.e., the <a href=\"https:\/\/developers.trueconf.com\/api\/server\/#api-Objects-Schedule\" target=\"_blank\" rel=\"noopener\">Schedule object<\/a> must contain the launch type 1 (one-time launch), the start time in\u00a0<a href=\"https:\/\/www.unixtimestamp.com\/\" target=\"_blank\" rel=\"noopener\">Unix Timestamp<\/a> format and the session duration in seconds<\/li>\n<li>Conference type \u2014 public<\/li>\n<li><a href=\"https:\/\/trueconf.com\/features\/modes\/videocall.html\" target=\"_blank\" rel=\"noopener\">Mode<\/a> \u2014 all on screen<\/li>\n<li>Recording \u2014 enabled so that all video therapy sessions could be saved in the patient\u2019s medical record. To this end, you need to enable conference recording on demand in the <a href=\"https:\/\/docs.trueconf.com\/server\/en\/admin\/web-config#recording-tab\" target=\"_blank\" rel=\"noopener\">TrueConf Server control panel<\/a>.<\/li>\n<\/ul>\n<p>For instance, when scheduling a 30-minute meeting on 6\/1\/2021 at 12:00 p.m., New York time (UTC -5) the following Conference object for the request body will be received:<\/p>\n<pre class=\"wrap:true lang:default decode:true \">{\r\n\u00a0\u00a0\"topic\":\"Klimova 01.06.2021 12:00\",\r\n\u00a0\u00a0\"type\":0,\r\n\u00a0\u00a0\"max_participants\":2,\r\n\u00a0\u00a0\"invitations\":[\r\n\u00a0\u00a0\u00a0\u00a0{\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"id\":\"klimova\"\r\n\u00a0\u00a0\u00a0\u00a0}\r\n\u00a0\u00a0],\r\n\u00a0\u00a0\"schedule\":{\r\n\u00a0\u00a0\u00a0\u00a0\"type\":1,\r\n\u00a0\u00a0\u00a0\u00a0\"start_time\":1622538000,\r\n\u00a0\u00a0\u00a0\u00a0\"duration\":1800\r\n\u00a0\u00a0},\r\n\u00a0\u00a0\"owner\":\"klimova\",\r\n\u00a0\u00a0\"allow_guests\":true,\r\n\u00a0\u00a0\"recording\":1\r\n}<\/pre>\n<p>In response, you\u2019ll get a JSON file for the <a href=\"https:\/\/developers.trueconf.com\/api\/server\/#api-Objects-Conference\" target=\"_blank\" rel=\"noopener\">conference object<\/a> you\u2019ve created. In this case, the <a href=\"https:\/\/trueconf.com\/blog\/wiki\/conference-id\" target=\"_blank\" rel=\"noopener\">conference ID<\/a> will be created automatically, e.g., <b>0987654321<\/b>.<\/p>\n<h2>Step 2: Generate links to connect guests automatically<\/h2>\n<p>You can now create and provide a patient with a link to automatically join a video consultation. In this case, you can get names, e.g., from patient\u2019s data that are available on the website that provides medical services.<\/p>\n<ol>\n<li>Get authorization data using the GET method <a href=\"https:\/\/developers.trueconf.com\/api\/server\/#api-Software_Clients-GetClientList\" target=\"_blank\" rel=\"noopener\">Software_Clients \u2013 Get Client List<\/a>.<\/li>\n<\/ol>\n<p>And specify the following parameters:<\/p>\n<ul>\n<li><code>call_id: 0987654321<\/code> \u2014 the ID of the <a href=\"#Step_1_Create_a_scheduled_public_conference\">created conference<\/a><\/li>\n<li><code>case: join_conference_button<\/code> \u2013 the generation of direct links  needed for joining the conference from client applications. <\/li>\n<li><code>user: $Ian Taylor<\/code> \u2014 guest\u2019s display name in the conference (a <b>$<\/b> symbol is required).<\/li>\n<\/ul>\n<p>In our case, the request is as follows:<\/p>\n<p><code>https:\/\/video.company.com\/api\/v3.3\/software\/clients?call_id=0987654321&amp;user=$Ian Taylor<\/code><\/p>\n<ol start=\"2\">\n<li>The response will contain the JSON file with a list of all apps for connecting guests to a conference, including a JSON object named <code>\"name\": \"TrueConf Web\"<\/code> and data for connecting via WebRTC:<\/li>\n<\/ol>\n<pre class=\"wrap:true lang:default decode:true\">{\r\n\r\n\u00a0\u00a0\"name\": \"TrueConf Web\",\r\n\r\n\u00a0\u00a0\"type\": \"web\",\r\n\r\n\u00a0\u00a0\"platform\": \"webrtc\",\r\n\r\n\u00a0\u00a0\"download_url\": \"\",\r\n\r\n\u00a0\u00a0\"download_urls\": null,\r\n\r\n\u00a0\u00a0\"market_url\": \"\",\r\n\r\n\u00a0\u00a0\"web_url\": \"https:\/\/video.company.com\/webrtc\/0987654321#login=*guest*%D0%98%D0%B2%D0%B0%D0%BD%20%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2&amp;token=$29cc834f607b1bffd0d5e68e47b4ead16*1619898725*641aad7d9e1e1a674416e16813939633&amp;lang=auto\",\r\n\r\n\u00a0\u00a0\"iframe\": \"&lt;iframe src=\\\"https:\/\/video.company.com\/webrtc\/0987654321#login=*guest*%D0%98%D0%B2%D0%B0%D0%BD%20%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2&amp;token=$29cc834f607b1bffd0d5e68e47b4ead16*1619898725*641aad7d9e1e1a674416e16813939633&amp;lang=auto\\\" allowfullscreen=\\\"allowfullscreen\\\" allow=\\\"microphone; camera; autoplay; display-capture\\\" &gt;&lt;\\\\iframe&gt;\"\r\n\r\n}<\/pre>\n<ol start=\"3\">\n<li>The value of the <code>web_url<\/code> parameter is a link used to automatically connect a participant to an online consultation from a browser.<\/li>\n<li>The JSON file will also include the \u201c<code>deeplinks<\/code>\u201d object with links that are needed for joining the meeting from client applications. The \u201cdefault\u201d link can be used for joining either from TrueConf desktop applications (Windows, Linux, macOS) or from TrueConf for iOS\/iPadOS. The \u201candroid\u201d link will be used by TrueConf for Android\/Android TV.\n<pre class=\"wrap:true lang:default decode:true \" >\"deeplinks\": {\r\n       \"default\": \"trueconf:\\\\c\\\\5016799639@video.company.com%23vcs&amp;h=172.18.246.126,172.17.0.1&amp;force=1&amp;templogin=1&amp;login=*guest*%D0%98%D0%B2%D0%B0%D0%BD%20%D0%A1%D1%82%D0%B5%D0%BF%D0%B0%D0%BD&amp;password=$291bcfe8bfc567822b4ff133c1b668fb7*1671525797*377ee8856b0404911fdeed524854d198&amp;encrypt=0&amp;autoclose=1\",\r\n       \"android\": \"intent:\\\\c\\\\5016799639%40video.company.com%23vcs%26h%3d172.18.246.126,172.17.0.1%26force%3d1%26templogin%3d1%26login%3d*guest*%D0%98%D0%B2%D0%B0%D0%BD%20%D0%A1%D1%82%D0%B5%D0%BF%D0%B0%D0%BD%26password%3d$291bcfe8bfc567822b4ff133c1b668fb7*1671525797*377ee8856b0404911fdeed524854d198%26encrypt%3d0%26autoclose%3d1#Intent;scheme=trueconf;package=com.trueconf.videochat;end\"\r\n   }<\/pre>\n<\/li>\n<li>It is also necessary to replace double slashes with single slashes; so the links will look in this way:\n<pre class=\"lang:default decode:true \" >trueconf:\\c\\[ConferenceID]@[server_address]%23vcs&amp;h=[server_address]&amp;force=1&amp;templogin=1&amp;login=*guest*[guest_login]&amp;password=$[password]&amp;encrypt=0&amp;autoclose=1<\/pre>\n<\/li>\n<\/ol>\n<p>If the TrueConf client application is installed on a user\u2019s device, it will be launched automatically when the link is clicked, and a user will join the meeting.<\/p>\n<div class=\"marked_note marked_note--danger\">Please note that such links are temporary;  due to security reasons their lifetime is limited to 1 minute. So, one has to join the conference right after such a link is generated. For example, they can be created right when a user clicks on the button for joining a meeting added on your website.<\/div>\n<h2>Step 3: Adding a conference to calendar<\/h2>\n<p>To make sure patients and doctors don\u2019t miss video consultations, add them right to their personal calendars. To this end, send integration links to both participants by retrieving them using the <a href=\"https:\/\/developers.trueconf.com\/api\/server\/#api-Conferences-ConferenceCalendars\" target=\"_blank\" rel=\"noopener\">Get Conference Calendars<\/a> GET request. In response, you\u2019ll get a JSON file containing links to add an event to Google and Outlook as well as an <b>ics<\/b> file for other calendar services.<\/p>\n<h2>Step 4: Using telemedicine services<\/h2>\n<p>When it\u2019s time for a video consultation to start, a conference will start automatically, while the doctor will receive a corresponding call. The patient will need to follow the link added to their calendar and will immediately join an event under their name.<\/p>\n<p class=\"marked_note\">To check your event, you can follow this link in your browser. If previously you haven\u2019t enabled access to devices, then you\u2019ll see the microphone and camera setup window before connecting to a session.<\/p>\n<div class=\"marked_note marked_note--danger\">\n<p class=\"marked_note__title marked_note__title--danger\"><b>Note<\/b><\/p>\n<p>This method works correctly only when a guest joins a scheduled conference after it has started, as only the owner can join the meeting before it starts.\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"<p>With TrueConf, you can implement a number of use case scenarios to bring video conferencing capabilities to various industries: business, education, healthcare,\u00a0government, etc. Even more video conferencing features are available with the help of TrueConf Server API, which helps your apps interact with TrueConf Server. This article shows how to connect a guest (a participant [&hellip;]<\/p>\n","protected":false},"author":45,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[260],"tags":[246],"class_list":["post-17610","post","type-post","status-publish","format-standard","hentry","category-knowledge-base","tag-api-and-sdk","wpautop"],"_links":{"self":[{"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/posts\/17610","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/users\/45"}],"replies":[{"embeddable":true,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/comments?post=17610"}],"version-history":[{"count":25,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/posts\/17610\/revisions"}],"predecessor-version":[{"id":39389,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/posts\/17610\/revisions\/39389"}],"wp:attachment":[{"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/media?parent=17610"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/categories?post=17610"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/trueconf.com/blog\/wp-json\/wp\/v2\/tags?post=17610"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}