Documentatie

Widget-styling & aanpassing

Bepaal het uiterlijk van de widget via init-opties of de dashboard-UI.

Vooraf ingestelde formaten#

Kies uit drie ingebouwde formaatpresets via chatSize en launcherSize:

chatSizeChatvenster
compact340 x 460 px
default380 x 520 px
large420 x 600 px

launcherSize bepaalt de zwevende knop onafhankelijk van chatSize:

launcherSizeLauncherIcoon
small48 px22 px
default60 px28 px
large68 px32 px
Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  chatSize: 'large',        // breder & hoger chatvenster
  launcherSize: 'small'     // kleinere zwevende knop
});

Positionering#

Verfijn de positie van de widget met offsetBottom en offsetSide (in pixels). In combinatie met position (bottom-right of bottom-left) geeft dit volledige controle over de plaatsing.

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  position: 'bottom-left',
  offsetBottom: 40,          // 40px vanaf onderkant (standaard: 20)
  offsetSide: 30             // 30px vanaf linkerrand (standaard: 20)
});

Randstraal & Z-index#

borderRadius bepaalt de afronding van de hoeken van het chatvenster (standaard: 20px).zIndex bepaalt de stapelvolgorde (standaard: 999999).

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  borderRadius: 12,    // scherpere hoeken
  zIndex: 100000       // lagere z-index om conflicten te voorkomen
});

Aangepaste CSS#

Voor geavanceerde styling die verder gaat dan de ingebouwde opties, geef je een customCSS-string door. Deze wordt in de Shadow DOM van de widget geïnjecteerd — het kan elke widget-stijl overschrijven, maar heeft geen invloed op je pagina.

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  customCSS: `
    .respondoai-chat {
      border-radius: 24px;
      box-shadow: 0 12px 48px rgba(0,0,0,0.2);
    }
    .respondoai-launcher {
      box-shadow: none;
      border: 2px solid #e5e7eb;
    }
    .respondoai-header {
      backdrop-filter: blur(10px);
    }
    .respondoai-message.assistant {
      background: #f0f9ff;
    }
    /* Stijl de CTA-knop in aankondigingskaarten */
    .respondoai-announcement-cta-button {
      border-radius: 999px;
      font-weight: 600;
      letter-spacing: 0.2px;
    }
    /* Plaats de CTA-knoppen van aankondigingen in een rij in plaats van de standaard stapel */
    .respondoai-announcement-ctas {
      flex-direction: row;
    }
  `
});
Aangepaste CSS draait binnen de Shadow DOM — deze is volledig geïsoleerd van je paginastijlen. Je kunt elke widget-klasse veilig overschrijven zonder bijwerkingen.

Beschikbare CSS-klassen:

KlasseElement
.respondoai-widgetHoofdcontainer (positie, z-index)
.respondoai-launcherZwevende knop
.respondoai-chatChatvenster
.respondoai-headerChat-koptekstbalk
.respondoai-messagesContainer voor berichtenlijst
.respondoai-message.userBerichtbubbel van gebruiker
.respondoai-message.assistantBerichtbubbel van bot
.respondoai-input-areaContainer voor invoerbalk
.respondoai-inputTekstinvoerveld
.respondoai-sendVerzendknop
.respondoai-suggestion-btnKnoppen voor snelle vragen
.respondoai-announcement-cta-buttonCTA-knop in een aankondigingskaart
.respondoai-announcement-ctasWrapper rond de CTA-knoppen in een aankondigingskaart (doelindeling)
Je kunt alle styling-opties ook vanuit het dashboard configureren — ga naar Channels → Widget → Appearance. Wijzigingen in het dashboard worden automatisch via de config-API aan de widget geleverd.