Skip to page content
Docs
Make Agent Fast documentation

Cafe24

Install by editing the storefront layout HTML in the Cafe24 design editor.

At a glance

Install by editing the storefront layout HTML in the Cafe24 design editor.

Embed install pathLoader on your site talks to the hosted agent runtime
Your websiteHTML / appLoader scriptembed.jsWidget UIChat / voiceAgent

Cafe24 (카페24) is a Korean commerce platform whose storefront design is edited as HTML. Install the launcher in the shared layout of the design you serve. There is no Make Agent Fast app in the Cafe24 app store today. Menu names here are as of 2026-09; if a label moved, look for the setting by what it does rather than by its exact path.

Add the loader#

  1. In the Make Agent Fast dashboard, publish the site, turn Enable embedding on, and allowlist every storefront origin — the cafe24.com shop address and your custom domain, plus the mobile address if it differs.
  2. Open design management and start HTML editing for the design that is live. Duplicate or back up the design first; you are editing storefront source.
  3. In the shared layout file that every page includes, paste the generated snippet just before the closing </body> tag.
  4. Save, apply the design to the storefront, and repeat for the mobile design if your shop keeps PC and mobile designs separately.
<script src="https://makeagent.fast/embed.js?v=20260728-widget-v2"
        data-agent="YOUR_SITE_SLUG"
        async></script>

If you cannot find the layout file, paste the snippet in your theme's footer block instead — any module that renders on every page works, as long as it is included once.

Verify#

  1. Open the storefront in a private window, on both the PC and the mobile address.
  2. Confirm the address bar origin is the one you allowlisted, including www if the domain redirects to it.
  3. Confirm embed.js returns 200 in the Network panel and one data-maf-embed="YOUR_SITE_SLUG" element exists.
  4. Ask a realistic question and confirm the message appears in Conversations.

Troubleshooting#

SymptomLikely causeFix
Works on PC but not on mobileThe mobile design has its own layout fileAdd the snippet to the mobile design as well
The launcher disappeared after a design changeA design was applied that does not contain the snippetRe-add it to the layout of the design now serving the shop
Launcher covers the cart or a fixed bottom barTwo fixed elements share the same cornerChange the launcher corner with data-position

Do not put an API key, an order number, or customer data in any data-* attribute. Security and CSP covers allowlisting and Content Security Policy for storefronts that set one.