Website chat

Met Website chat plaats je een chatknop op je eigen website. Bezoekers sturen berichten via het widget; uw team antwoordt in de Tillor inbox naast WhatsApp, Messenger en Instagram.

Integratie installeren

1. Ga naar Instellingen > Integraties (sidebar onder Ondersteuning)
2. Open Website chat in de lijst
3. Klik Installeren (geen OAuth - Tillor maakt direct een widget-sleutel aan)
4. Stel onder Instellingen de widget in (welkomstbericht, accentkleur, optioneel toegestane domeinen)
5. Kopieer het Embed-snippet onder Embedden op je website en plak het vóór </body> op elke pagina waar de chatknop moet verschijnen

Widget instellen

Bezoekersformulier

Onder Instellingen bij Website chat stelt u in welke velden bezoekers invullen vóór het eerste bericht. Zijn er verplichte velden, dan verschijnen die samen met het berichtveld in één scherm. De bezoeker vult alles in en stuurt met Versturen - geen aparte tussenstap.

Standaardvelden

Vink per veld aan of het verplicht is:

U kunt elk veld apart aan- of uitzetten. Alleen telefoon aan? Dan verschijnt alleen het telefoonveld.

Extra velden

Klik Veld toevoegen voor eigen vragen (max. 8). Per veld stelt u in:

Waarden van extra velden staan in de inbox onder het gesprek, naast kanaal en bezoeker-id.

Embed-opties

Naast data-org-id en data-widget-key kunt u optionele attributen op het script zetten:

Voorbeeld met Nederlandse teksten:

<link rel="preload" href="https://tillor.eu/inbox-widget.css" as="style" />
<script
  src="https://tillor.eu/inbox-widget.js"
  data-org-id="org_abc123"
  data-widget-key="iwk_xxx"
  data-locale="nl"
  data-debug="true"
  async
  defer
></script>

U kunt debug ook aanzetten zonder het snippet te wijzigen: in de browserconsole localStorage.setItem('tillor-inbox-debug', '1') en de pagina verversen.

Typen (beide kanten)

Typen werkt in beide richtingen:

Het ingebouwde widget stuurt automatisch typ-signalen terwijl de bezoeker in het berichtveld typt. Uw team ziet dat in de inbox zodra het gesprek openstaat (ook vóór het eerste verzonden bericht).

Bouwt u een eigen chat-UI in plaats van het widget? Roep dan de widget-API aan:

POST /api/inbox-widget/{orgId}/typing
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json

{
  "visitorId": "vis_…",
  "active": true,
  "visitorName": "Jan",
  "visitorEmail": "jan@voorbeeld.nl",
  "visitorPhone": "+32470123456"
}

• active: true wanneer de bezoeker typt; false wanneer het veld leeg is of de bezoeker stopt (het widget stuurt false na ongeveer 4 seconden zonder input)
• visitorName / visitorEmail / visitorPhone zijn optioneel, maar helpen bij het koppelen vóór het eerste bericht
• Gebruik hetzelfde visitorId als bij /send en /messages

Staff-typ-indicator in het widget komt mee in GET /messages als staffTyping: true (widget pollt elke paar seconden).

Bezoekersactiviteit (alleen in de inbox)

Na het eerste bericht stuurt het widget info-regels naar Tillor (chat openen of sluiten, tab wisselen, pagina verlaten, navigatie). Uw team ziet die als grijze tekst in het gesprek; de bezoeker ziet ze niet in het widget. Vóór dat eerste bericht verschijnt er nog geen gesprek in de inbox.

Navigatie werkt bij gewone websites (elke pagina laadt opnieuw) en bij single-page apps (history API). De huidige pagina-URL staat ook in het zijpaneel van het gesprek. Info-regels verhogen geen ongelezen teller en geven geen pushmelding.

Eigen UI? Roep POST /api/inbox-widget/{orgId}/info aan met event: chat_closed, tab_hidden of navigation (bij navigatie ook url).

In de inbox

• Gesprekken verschijnen als kanaal Website chat
• Tillor onthoudt bezoekers via een id in localStorage op hun browser (zelfde apparaat = zelfde thread)
• Naam, e-mail en telefoon uit het bezoekersformulier worden opgeslagen bij het gesprek
• Extra velden verschijnen in de inbox bij het gesprek
• Antwoorden vanuit Tillor komen terug in het widget (bezoeker moet het chatvenster open hebben of later opnieuw openen; het widget ververst berichten automatisch)
• Wanneer u typt in de inbox, ziet de bezoeker Typen… in het widget
• Wanneer de bezoeker typt op uw site, ziet u Typen… in het gesprek

Berichten zijn tekst tot 4096 tekens. Afbeeldingen en bestanden worden in deze versie niet ondersteund.

Gerelateerd