If you want your AI to live inside your product — not just inside GTWY — the Embedded Chatbot feature is exactly what you need.
With a single script, you can place your GTWY-powered chatbot into any website, dashboard, or application.
No rebuilding. No extra configuration. No backend setup.

Your existing prompts, tools, logic, and workflows move with it — instantly.

An embedded chatbot is your GTWY agent placed directly into any external application or web page. It uses the same configuration, prompt, and tools as defined in your GTWY workspace — meaning you don’t have to recreate anything.

Once embedded, users can interact with your AI assistant in real time, just like they would inside GTWY — but now seamlessly integrated within your own environment.

This is ideal for support portals, internal dashboards, customer onboarding pages, or any product where you want real-time AI assistance available instantly.

To securely embed your chatbot, you need an access token that authenticates your organization and chatbot instance.

Use the following JSON structure as the payload:

{
  "org_id": "YOUR_ORG_ID",
  "chatbot_id": "YOUR_CHATBOT_ID",
  "variables": {
    // Add any key-value pairs here
  }
}

Then:

1. Click on your Access Key inside GTWY.

2. Use that key to sign the payload using the HS256 algorithm.

   Note:

   • GTWY supports HS256 for JWT signing.

   • Use the access key exactly as provided (no encoding or modification required).

3. Generate your JWT embed token - this will authenticate the chatbot securely when it’s loaded in your website.

Now that you have your embed token, it’s time to place the chatbot in your product.
Copy and paste the following script where you want it to appear in your HTML:

<script 
  id="chatbot-main-script"
  embedToken="ENTER_YOUR_EMBED_TOKEN"
  src="https://chatbot-embed.viasocket.com/chatbot-prod.js">
</script>

Once added, your chatbot will load automatically and appear as an interactive widget inside your product UI.

Example Appearance:

• Header: “Chatbot”

• Subtitle: “Smart Help, On Demand”

• Controls: Fullscreen toggle and close icon

The chatbot fits naturally into your interface, providing a seamless in-app experience for users.

If you want your chatbot to interact dynamically with your app — for example, to send or receive live data — GTWY provides simple JavaScript functions to make that possible.

You can listen to messages sent from the chatbot:

window.addEventListener('message', (event) => {
  const receivedData = event.data;
  // Handle chatbot response data here
});

Event while sending/receiving any message on chatbot

window.addEventListener('message', (event) => {
  const receivedData = event.data?.data?.type === "MESSAGE_SENT";
  // Handle chatbot response data here
});

window.addEventListener('message', (event) => {
  const receivedData = event.data?.data?.type === "MESSAGE_RECEIVED";
  // Handle chatbot response data here
});

window.addEventListener('message', (event) => {
  const receivedData = event.data?.data?.type === "MESSAGE_RECEIVED_WITH_ERROR";
  // Handle chatbot response data here
});

You can also send variables or context directly into the chatbot:

window.SendDataToChatbot({
  bridgeName: "<slugName_of_bridge>",
  threadId: "<thread_id>",
  parentId: "<container_id>", // optional
  fullScreen: false,
  hideCloseButton: false,
  hideIcon: false,
  variables: {
    // Any dynamic data
  }
});

You can dynamically customize the chatbot UI and behavior at runtime by passing a config object inside SendDataToChatbot().

window.SendDataToChatbot({
  bridgeName: "<slugName>",
  threadId: "<thread_id>",
  config: {
    buttonName: "",
    height: "12",
    heightUnit: "%" // either % or px,
    width: "24",
    widthUnit: "" // either % or px,
    themeColor: "",
    theme: "dark",
    chatbotTitle: "Chatbot",
    chatbotSubtitle: "Smart Help, On Demand",
    iconUrl: "",
    side: "left",
    language: "en",
    features: {
      voice_enabled: true,
      file_upload: false
    }
  }
});

To give your users more control, you can manually open or close the chatbot using JavaScript:

Open Chatbot:

window.openChatbot();

Close Chatbot:

window.closeChatbot();

Show Chatbot:

window.Chatbot.show();

Hide Chatbot:

window.Chatbot.hide();

Reload Chats:

window.Chatbot.reloadChats();

Ask AI:

window.Chatbot.askAi(data);

With one embed script and a secure token, your chatbot becomes part of your platform — responding to users, automating tasks, and delivering AI-powered help directly inside your product.

It’s fast, seamless, and plug-and-play.
GTWY gives you the power of full AI integration in minutes, not months.