The code

1. The address you embed

Bookings, forms, events, products and the storefront each get their own public address. You read it inside Bink, next to the object. Adding “?embed=true” renders the page without the parts that only make sense on Bink.

https://bink4.me/tuonome/prenotazioni?embed=true

The dedicated pages allow framing from any domain; the rest of the site does not.

2. Inside the page (iframe)

The simplest way. The height is yours to pick: 700px suits a calendar or a medium-length form, a storefront wants more.

<iframe
  src="https://bink4.me/tuonome/prenotazioni?embed=true"
  width="100%" height="700" frameborder="0"
  style="border:none; border-radius:12px"
></iframe>

3. Floating button (embed.js)

A script that adds a fixed button in a corner. On click it opens the object over the site, in a panel 480px wide and 90% of the screen height.

<script
  src="https://bink4.me/embed.js"
  data-url="https://bink4.me/tuonome/prenotazioni?embed=true"
  data-text="Prenota ora"
  data-color="#ea580c"
  data-position="bottom-right"
></script>

Accepted attributes

data-url

required. The address to open. If “embed=true” is missing, the script adds it.

data-text

the button label. Without it you get “Prenota ora”, in Italian: always set it if your site is not Italian.

data-color

the button background colour. Without it, a default orange.

data-position

“bottom-right” (default) or “bottom-left”.

“data-position” works, but Bink does not offer it when you copy the code: add it by hand.

4. From a link you already have

No script: any link or button on your page opens the object in a window. Useful when you already have the button you want.

<a
  href="https://bink4.me/tuonome/prenotazioni"
  onclick="window.open('https://bink4.me/tuonome/prenotazioni?embed=true','bink','width=480,height=750'); return false;"
>Prenota ora</a>

How the panel closes

With the “×” at the top right, with the Esc key, or by clicking outside the panel.

⚠️ It does not close by itself when the visitor is done: after a booking it stays open on the thank-you message, and they close it.

What happens at payment

Checkout does not open inside the panel: it takes the whole window. That is not a technical limit but the right call — inside a frame you cannot read the address bar, which means you cannot see who is taking the money. Forms and free bookings, on the other hand, finish inside your own site.

Read routes

A few routes answer without authentication and can be called from your server. They read a single object whose identifier you already know.

And there is no “give me every product of this user” route: the one below takes block identifiers, not a username.

A creator's catalogue

For the full list of an account's products there is the feed, born for Google Merchant Center and advertising feeds, but it is a public address like any other. Two formats: XML and TSV.

https://bink4.me/feed/tuonome.xml
https://bink4.me/feed/tuonome.tsv

⚠️ It is off by default and the creator switches it on in Shop → Products: while it is off that address answers 404. Today it is on for very few accounts.

Signing your users in with Bink

OAuth 2.0 with PKCE, plus a package that writes the flow for you and can also guard an MCP server.

Connecting an assistant

Bink exposes an MCP server: an assistant can read earnings, clients and appointments, and act on the account.

What is NOT there

• Webhooks to your system
• A public write API (writing goes through OAuth or MCP)
• A plugin for WordPress or any other CMS
• A custom domain on the pages