docs: 📝 Explain how to pass parent URL

apps/docs/docs/editor/blocks/set-variable.md

@@ -42,12 +42,8 @@ A popular request also is to set a variable to the current URL. Here is the valu
 window.location.href
 ```
 
-It will not give you the parent URL if you embed the bot on your site. A more bullet proof value would then be:
+:::caution
+It will not give you the parent URL if you embed the bot on your site.
 
-```js
-window.location != window.parent.location
-  ? document.referrer
-  : document.location.href
-```
-
-It checks whether or not the bot is embedded and return the appropriate URL.
+A more bullet proof option is to pass the URL as a hidden variable in the embed code options. You can find an example [here](../../embed/html-javascript#additional-configuration).
+:::

apps/docs/docs/embed/html-javascript.md

@@ -0,0 +1,127 @@
+---
+sidebar_position: 4
+---
+
+# HTML & Javascript
+
+## Standard
+
+You can get the standard HTML and Javascript code by clicking on the "HTML & Javascript" button in the "Share" tab of your typebot.
+
+There, you can change the container dimensions. Here is a code example:
+
+```html
+<script src="https://unpkg.com/typebot-js@2.2"></script>
+<div id="typebot-container" style="width: 100%; height: 600px;"></div>
+<script>
+  Typebot.initContainer('typebot-container', {
+    url: 'https://viewer.typebot.io/my-typebot',
+  })
+</script>
+```
+
+This code is creating a container with a 100% width (will match parent width) and 600px height.
+
+## Popup
+
+You can get the popup HTML and Javascript code by clicking on the "HTML & Javascript" button in the "Share" tab of your typebot.
+
+Here is an example:
+
+```html
+<script src="https://unpkg.com/typebot-js@2.2"></script>
+<script>
+  var typebotCommands = Typebot.initPopup({
+    url: 'https://viewer.typebot.io/my-typebot',
+    delay: 3000,
+  })
+</script>
+```
+
+This code will automatically trigger the popup window after 3 seconds.
+
+### Open or Close a popup
+
+You can use these commands:
+
+```js
+Typebot.getPopupActions().open()
+```
+
+```js
+Typebot.getPopupActions().close()
+```
+
+You can bind these commands on a button element, for example:
+
+```html
+<button onclick="Typebot.getPopupActions().open()">Open the popup</button>
+```
+
+## Bubble
+
+You can get the bubble HTML and Javascript code by clicking on the "HTML & Javascript" button in the "Share" tab of your typebot.
+
+Here is an example:
+
+```html
+<script src="https://unpkg.com/typebot-js@2.2"></script>
+<script>
+  var typebotCommands = Typebot.initPopup({
+    url: 'https://viewer.typebot.io/my-typebot',
+    delay: 3000,
+  })
+</script>
+```
+
+This code will automatically trigger the popup window after 3 seconds.
+
+### Open or close the proactive message
+
+You can use this command:
+
+```js
+Typebot.getBubbleActions().openProactiveMessage()
+```
+
+You can bind this command on a button element, for example:
+
+```html
+<button onclick="Typebot.getBubbleActions().openProactiveMessage()">
+  Open proactive message
+</button>
+```
+
+### Open or close the typebot
+
+You can use these commands:
+
+```js
+Typebot.getBubbleActions().open()
+```
+
+```js
+Typebot.getBubbleActions().close()
+```
+
+You can bind these commands on a button element, for example:
+
+```html
+<button onclick="Typebot.getBubbleActions().open()">Open the chat</button>
+```
+
+## Additional configuration
+
+You can add hidden variable values in your embed code by adding the `hiddenVariables` option. Here is an example:
+
+```js
+Typebot.initContainer('typebot-container', {
+  url: 'https://viewer.typebot.io/my-typebot',
+  hiddenVariables: {
+    'Current URL': window.location.href,
+    'User name': 'John Doe',
+  },
+})
+```
+
+It will populate the `Current URL` variable with the parent URL and the `User name` variable with "John Doe".

apps/docs/docs/embed/javascript-commands.md

@@ -1,65 +0,0 @@
----
-sidebar_position: 4
----
-
-# Javascript library
-
-Typebot Javascript library is open-source ([check out the repository](https://github.com/baptisteArno/typebot.io/tree/main/packages/typebot-js)). Feel free to contribute if you're a developer and wish to improve its features.
-
-Whenever a typebot is embedded on your website, you have access to commands to automatically trigger actions on your embedding depending on its type.
-
-## Popup
-
-### Open or Close a popup
-
-You can use these commands:
-
-```js
-Typebot.getPopupActions().open()
-```
-
-```js
-Typebot.getPopupActions().close()
-```
-
-You can bind these commands on a button element, for example:
-
-```html
-<button onclick="Typebot.getPopupActions().open()">Open the popup</button>
-```
-
-## Bubble
-
-### Open or close the proactive message
-
-You can use this command:
-
-```js
-Typebot.getBubbleActions().openProactiveMessage()
-```
-
-You can bind this command on a button element, for example:
-
-```html
-<button onclick="Typebot.getBubbleActions().openProactiveMessage()">
-  Open proactive message
-</button>
-```
-
-### Open or close the typebot
-
-You can use these commands:
-
-```js
-Typebot.getBubbleActions().open()
-```
-
-```js
-Typebot.getBubbleActions().close()
-```
-
-You can bind these commands on a button element, for example:
-
-```html
-<button onclick="Typebot.getBubbleActions().open()">Open the chat</button>
-```