Widget API (settings)

Widget API (settings)

Le widget de chat lit l’apparence (couleur, salutation, position, logo) via une API de paramètres publique. Si vous modifiez quelque chose dans Widget de chat, c’est en ligne endéans environ une minute — sans devoir recoller l’embed.

Public : récupérer les paramètres

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

Ou via alias : /api/widget-settings.php. Réponse (JSON), entre autres :

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

Optionnel : uniquement token (première ligne active). CORS est ouvert pour GET depuis n’importe quel site web.

Public : installation visible

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

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

Le loader fait cela automatiquement. Dans Widget de chat, vous voyez alors « Widget vu sur un site web ».

Tableau de bord : enregistrer (connecté)

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"}

Aussi PUT / PATCH sont autorisés. Les champs peuvent être en 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-* remplace uniquement sur cette page les valeurs du tableau de bord. Pratique pour les pages de destination.

Formules CMS

Télécharger connecté : plugin WordPress ou snippet Shopify via Chatwidget → Installer, ou :

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