Widget API (settings)

De chatwidget leest uiterlijk (kleur, begroeting, positie, logo) via een publieke settings-API. Wijzigt u iets in Chatwidget, dan is dat binnen ongeveer een minuut live — zonder de embed opnieuw te plakken.

Publiek: settings ophalen

GET https://slimbot.nl/api/widget/settings.php?token=UW_TOKEN&iid=UW_LIJN_ID

Of via alias: /api/widget-settings.php. Antwoord (JSON), o.a.:

• brandName, accent, greeting, position (bottom-right / bottom-left)
• logoUrl, agentName, whitelabel, features, instanceId

Optioneel: alleen token (eerste actieve lijn). CORS staat open voor GET vanaf elke website.

Publiek: installatie gezien

POST https://slimbot.nl/api/widget/settings.php
Content-Type: application/json

{"action":"seen","token":"UW_TOKEN","iid":123}

De loader doet dit automatisch. In Chatwidget ziet u dan “Widget gezien op een website”.

Dashboard: opslaan (ingelogd)

POST https://slimbot.nl/api/widget/settings.php
Content-Type: application/json
Cookie: (sessie)

{"action":"save","iid":123,"brand_name":"Sophie","accent":"#00b87a",
 "greeting":"Hallo!","position":"bottom-right","logo_url":"","agent_name":"Assistent"}

Ook PUT / PATCH zijn toegestaan. Velden mogen camelCase (brandName, logoUrl, …).

Embed + data-overrides

<script src="https://slimbot.nl/widget/loader.php?token=TOKEN&iid=123"
  data-color="#0ea5e9" data-name="Campagne" data-greeting="Hoi!"
  data-position="bottom-left" async></script>

data-* overschrijft alleen op die pagina de dashboard-waarden. Handig voor landingspagina’s.

CMS-pakketten

Ingelogd downloaden: WordPress-plugin of Shopify-snippet via Chatwidget → Installeren, of:

• /api/widget-cms-pack.php?pack=wordpress
• /api/widget-cms-pack.php?pack=shopify