{"id":3183,"date":"2024-03-22T11:06:52","date_gmt":"2024-03-22T11:06:52","guid":{"rendered":"https:\/\/support.alfaview.com\/developers\/request-your-api-credentials\/usage-examples\/generate-join-url-from-group-link\/"},"modified":"2025-03-14T10:46:34","modified_gmt":"2025-03-14T10:46:34","slug":"generate-join-url-from-group-link","status":"publish","type":"page","link":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/developers\/request-your-api-credentials\/usage-examples\/generate-join-url-from-group-link\/","title":{"rendered":"Join-URL mit Gruppenlink generieren"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"summary\">Summary<a href=\"#summary\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Extract <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">companyId<\/mark><\/code>, <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">roomId<\/mark><\/code>, and <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">accessKey <\/mark><\/code>from existing group link<\/li>\n\n\n\n<li>Authenticate with extracted information<\/li>\n\n\n\n<li>Assemble join url<\/li>\n\n\n\n<li>Required API calls: <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">guestService.v2\/authenticate<\/mark><\/code><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"existing-group-link\">Existing group link<a href=\"#existing-group-link\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/\/ Format:\nhttps:&#47;&#47;app.alfaview.com\/#\/join\/&lt;COMPANYID&gt;\/&lt;ROOMID&gt;\/&lt;ACCESSKEY&gt;\/v2\n\n\/\/ Example:\nhttps:\/\/app.alfaview.com\/#\/join\/01EZYCFW9MJ10P15YJ63NZ8S47\/5726d492-6eb2-\n5f59-9ee8-203181250dc4\/rgOUSiy2pFWkRFNfnkXuJRVXcD72GoOb\/v2\n\n\/\/ Extracted:\ncompanyId: 01EZYCFW9MJ10P15YJ63NZ8S47\nroomId: 5726d492-6eb2-5f59-9ee8-203181250dc4\naccessKey: rgOUSiy2pFWkRFNfnkXuJRVXcD72GoOb<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"request\">Request<a href=\"#request\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<p>Request <button class=\"av-button av-button--error\">POST<\/button> to<mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-luminous-vivid-amber-color\"><code> <\/code><\/mark><code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">https:\/\/apis.alfaview.com\/json\/v1\/guestService.v2\/authenticate<\/mark><\/code><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"companyId\": \"string\", \/\/ extracted companyId\n  \"roomId\": \"string\", \/\/ extracted roomId\n  \"accessKey\": \"string\", \/\/ extracted accessKey\n  \"displayName\": \"string\", \/\/ guest name\n  \"externalId\": \"string\" - \/\/ optional, can be used to derive a\n                           \/\/ reproducible userId for groupLinks to prevent simultaneous use.\n                           \/\/ The caller is responsible to provide a unique value per user;\n                           \/\/ validate=\"optional,min=32,max=256\"\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"response\">Response<a href=\"#response\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"replyInfo\": {\n    \"statusMessage\": \"OK\"\n  },\n  \"accessToken\": \"string\", \/\/ use this to assemble the join url\n  \"tokenExpiresAt\": \"string\", \/\/ expires 12 hours after creation\n  \"userId\": \"string\",\n  \"linkInfo\": {\n    \"type\": \"TYPE_GROUP_LINK\"\n  }\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"assemble-join-url\">Assemble join url<a href=\"#assemble-join-url\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/\/ Format for web client:\nhttps:\/\/webclient.alfaview.com\/?--url=alfaview:\/\/apis.alfaview.com:443?companyId=&lt;COMPANY&gt;&amp;roomId=&lt;ROOMID or MEETINGID&gt;&amp;token=&lt;ACCESSTOKEN&gt;\n\n\/\/ Format for native client:\nalfaview:\/\/apis.alfaview.com:443?companyId=&lt;COMPANYID&gt;&amp;roomId=&lt;ROOMID or MEETINGID&gt;&amp;token=&lt;ACCESSTOKEN&gt;\n\n\/\/ Example:\nalfaview:\/\/apis.alfaview.com:443?\ncompanyId=01EZYCFW9MJ10P15YJ63NZ8S47&amp;roomId=5726d492-6eb2-5f59-9ee8-\n203181250dc4&amp;token=IRXPAVVc1nZCOu5+mKTfXeUQr5bf\/C1bSJt3Pd0ibtpDSdineL5trHO\nBuArpIqfBo41sh7S5gPxntpEBYl0wAIu6pT700f1nx2p8Idc7CDZUy6aVhYTa7Ojc3Pzu0k6UZ\ntwi43ixjqhKvSIYOJYdQrExlvjWhUZVuIGf6Wnk5OD73z4YmQnVLQ9c1ye6\/u4l5p6fe0rgTP1\n6mKCMnH\/CXb5Y2lHHGdxT4ENS9Vpg0wI5ihI4xZ7Rc3VjkRpWEUDtmeKwSn1NhQkcuFezlWBQr\nsI5kvxp9ROvE1aw<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Summary Extract companyId, roomId, and accessKey from existing group link Authenticate with extracted information Assemble join url Required API calls: guestService.v2\/authenticate Existing group link Request Request POST to https:\/\/apis.alfaview.com\/json\/v1\/guestService.v2\/authenticate Response Assemble join url<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":3170,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-3183","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3183","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/comments?post=3183"}],"version-history":[{"count":6,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3183\/revisions"}],"predecessor-version":[{"id":3184,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3183\/revisions\/3184"}],"up":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3170"}],"wp:attachment":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/media?parent=3183"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}