In dit artikel leer je hoe je een chatconfiguratie aanmaakt in het Backoffice, de secties van het configuratievenster doorloopt, deze opslaat als concept of direct publiceert, en uitrolt naar je studio's.
Inhoud
- Vereisten
- Overzicht van de configuraties
- Een nieuwe configuratie aanmaken
- De configuratie opslaan
- Detailweergave en status
- Configuratie van zelfbediening voor klanten
- Activeren en autoriseren (whitelist)
- De chatwidget insluiten
- Gegevens van derden en licenties
Vereisten
- Bevoegdheid: MagicAI chat-instellingen configureren, beschikbaar onder Instellingen / Bevoegdheden in de subcategorie Kunstmatige intelligentie . Een aparte bevoegdheid, MagicAI chatgesprekken, regelt de zichtbaarheid van de inbox aan de agentkant en bevindt zich in de subcategorie Communicatie .
- Licentie: MagicAI Chat maakt geen deel uit van de reguliere prijspakketten; het wordt geleverd onder een eigen licentiemodel. Neem contact op met je Sport Alliance accountmanager om het voor een studio in te schakelen.
- Avatarafbeeldingen: een hoofd-chatbot-avatar voor de geopende chatwidget en een call-to-action-avatar voor de zwevende chatknop, elk tot 3 MB.
- Ten minste één kennisbron: bestand (max. 10 MB), URL of Zendesk Help Center.
- Voor een menselijke overdracht via Zendesk: Zendesk-subdomein, gebruikersnaam van de agent en API-token.
- Voor lidmaatschapsaanbiedingen: een onderhouden aanbiedingskanaal (Sales tool, Studio pages and Connect API, MySports of Open API).
- Geldige standaard factureringsstudio: de standaard factureringsstudio van de configuratie moet een studio zijn waar de chatbot contractueel beschikbaar is en die deel uitmaakt van de geautoriseerde studio's van de configuratie. Als aan een van beide voorwaarden niet wordt voldaan, kan de configuratie niet worden opgeslagen.
Overzicht van de configuraties
Open het configuratie-startpunt onder Instellingen / MagicAI / Chat. De zijbalk toont de nieuwe sectie MagicAI met een vermelding Chat en draagt een badge Nieuw bij de lancering.
De overzichtspagina toont alle chatconfiguraties van je locatie.
Kolommen in de lijst:
- Naam: de interne identificatie, alleen zichtbaar voor Backoffice-gebruikers. Er verschijnt een Concept chip naast de naam zolang de configuratie nog wordt opgebouwd.
- Merknaam: de merknaam van je studio. Op zichzelf niet zichtbaar voor leden, maar handig om configuraties tussen merken te onderscheiden.
- Chatbotnaam: de openbare naam die leden in de chatwidget zien.
- Laatst bijgewerkt: het tijdstempel van de laatste wijziging aan de configuratie.
- Gepubliceerd voor: een badge met het aantal studio's waarin de configuratie momenteel actief is. Er verschijnt hier een Actief chip zodra de configuratie in ten minste één studio is geactiveerd.
- Locaties: een badge met het aantal studio's waarvoor de configuratie geautoriseerd is; beweeg de muis of klik om de studiolijst te zien.
Vanuit de lijst kun je filteren op status, zoeken op naam of merknaam, sorteren en kolommen tonen of verbergen. Gebruik de locatiekiezer rechtsboven om configuraties van andere locaties te zien. Start het configuratievenster met Chatconfiguratie aanmaken rechtsboven.
Activeren en deactiveren gebeurt altijd vanaf deze overzichtspagina. De detailweergave beheert alleen de inhoud en de autorisatie (whitelist). Zie Activeren en autoriseren (whitelist) voor alle activeringsregels.
Een nieuwe configuratie aanmaken
Chatconfiguratie aanmaken opent één venster dat je door vijf secties leidt, elk eindigend met een knop Volgende . De koptekst van het venster biedt een actie Concept opslaan die je op elk moment kunt gebruiken om je werk in uitvoering te bewaren. Er worden geen stapnummers weergegeven; de sectietitel en de voortgang in het venster geven aan waar je bent.
Basisinformatie
De eerste sectie legt de basisgegevens van de configuratie vast.
Namen
- Naam: interne naam van de configuratie (max. 30 tekens). Alleen zichtbaar voor Backoffice-gebruikers.
- Merknaam: je merknaam (max. 30 tekens). Wordt getoond in het Backoffice-overzicht.
- Chatbotnaam: de naam die leden in de chatwidget zien (max. 30 tekens).
Welkomstbericht
- Welkomstbericht: de begroeting die wordt getoond wanneer een lid de chat opent (max. 400 tekens).
Factureringsstudio
- Standaard factureringsstudio: de terugvalstudio die wordt gebruikt voor chatgesprekken die nog niet aan een specifieke studio kunnen worden toegewezen (bijvoorbeeld een niet-geverifieerde prospect). De studio moet op de autorisatielijst van de configuratie staan en een studio zijn waar de chatbot contractueel beschikbaar is; anders kan de configuratie niet worden opgeslagen.
Wettelijke toestemming
Als je beide velden invult, toont het voorbeeld een toestemmingsvenster met de acties Weigeren en Accepteren die leden zien vóór hun eerste bericht. Beide velden zijn optioneel: als je ze leeg laat, wordt er geen toestemmingsvenster getoond.
- Titel wettelijke toestemming: titel van het toestemmingsvenster (max. 30 tekens).
- Beschrijving wettelijke toestemming: de bodytekst die uitlegt waarmee het lid instemt, met opmaakopties (vet, cursief, onderstreept, tekstkleur, link).
Voorgestelde toestemmingstekst
De volgende tekst is door Legal (Bjoern Baltbardis) aangeleverd als werkconcept voor het toestemmingsvenster. Pas de tijdelijke links aan naar je eigen privacyverklaring en gebruiksvoorwaarden voordat je live gaat.
- Titel: Kennisgeving gegevensverwerking
- Beschrijving: Je invoer, inclusief persoonsgegevens, wordt automatisch verwerkt om je verzoek te beantwoorden. Je kunt deze toestemming op elk moment intrekken met werking voor de toekomst. Voer geen gezondheidsgegevens of andere gevoelige informatie in. Meer informatie over de gegevensverwerking en je rechten vind je in onze [privacyverklaring] en onze [gebruiksvoorwaarden].
Vormgeving
Pas het visuele uiterlijk van de chatwidget aan zodat het bij je merk past. Je configureert drie basiskleuren plus een belvorm; alle andere interfacekleuren (tekst, randen, foutstatussen) worden automatisch afgeleid.
Kleuren en look
-
Primair: hoofdaccentkleur als hexadecimale waarde, gebruikt voor primaire interface-elementen zoals knoppen en markeringen, bijv.
#166cb8. -
Achtergrond chat: oppervlaktekleur van de chatwidget als hexadecimale waarde, bijv.
#6d2929. - Kleur kleurverloop kopregel: optionele tweede kleur die wordt gebruikt voor het kleurverloop van de kopregel. Indien leeg, gebruikt de kopregel de primaire kleur. Hexadecimale waarde.
- Gebruik ronde vorm voor chatbellen: ja/nee-schakelaar.
Avatar
Er worden twee avatarvelden ondersteund. Per veld is slechts één afbeelding toegestaan.
- Geopende chatbot-avatar: het hoofdlogo dat in de kopregel van de chatwidget wordt getoond (max. 3 MB).
- Gesloten chatbot-avatar: het logo of pictogram dat op de zwevende chatknop wordt getoond die de widget opent (max. 3 MB).
Functies
Schakel de functies in die de bot moet afhandelen. Elke functie ontgrendelt specifieke functionaliteit voor eindgebruikers. Na het opslaan kun je elke workflow op de bijbehorende kaart in de detailweergave verfijnen.
| Functie | Wat het doet |
|---|---|
| Gym/studio-informatie | De chatbot kan vragen over studiogegevens beantwoorden (openingstijden, adres, faciliteiten). |
| Proefsessie boeken | Eindgebruikers kunnen via de chatbot een proef- of testtraining boeken. |
| Cursusrooster | De chatbot kan de lessen en cursussen tonen die beschikbaar zijn in een specifieke studio binnen een gekozen datumbereik. |
| Contract annuleren | Leden kunnen via de chatbot een contractannulering starten. |
| Menselijke overdracht | Wanneer de chatbot een verzoek niet kan oplossen, maakt het een supportverzoek aan en stuurt het door naar een menselijke agent. Vereist aanvullende configuratie van Menselijke overdracht (zie hieronder). |
| Zelfbediening voor klanten | Leden kunnen via de chatbot hun accountgegevens bekijken en wijzigen (algemene gegevens, adres, contactgegevens, pauzeperiodes, contractgegevens). Vereist aanvullende zelfbedieningsconfiguratie (zie Configuratie van zelfbediening voor klanten). |
| Lidmaatschapsaanbiedingen | De chatbot kan lidmaatschapsaanbiedingen presenteren en aanbevelen aan prospects. Vereist het selecteren van een tariefbundel-groepstype. |
Menselijke overdracht configureren
Als je Menselijke overdracht, inschakelt, kies dan het Type. van overdracht. Per chatbot is slechts één configuratie van Menselijke overdracht toegestaan.
Type E-mail
- E-mail: ontvangstadres voor doorgestuurde gesprekken. Moet een geldig e-mailadres zijn.
Type Zendesk
- URL: URL van je Zendesk-instantie.
- Gebruikersnaam: de gebruikersnaam van de agent die wordt gebruikt om tickets aan te maken.
- Token: API-token voor authenticatie.
Lidmaatschapsaanbiedingen configureren
Als je Lidmaatschapsaanbiedingen, inschakelt, moet je ook het Tariefbundel-groepstype selecteren waaruit de aanbiedingen worden gehaald. Zonder selectie kan de configuratie niet worden opgeslagen. De vier opties komen overeen met de waarden van RateBundleGroupTypeEnum:
- Sales tool: aanbiedingen uit de tariefbundelgroep Sales tool.
- Studio pages and Connect API: aanbiedingen uit de tariefbundelgroep Studio pages and Connect API.
- MySports: aanbiedingen uit de tariefbundelgroep MySports.
- Open API: aanbiedingen uit de tariefbundelgroep Open API.
Je selectie bepaalt waar de bot de aanbiedingen vandaan haalt en waar de inschrijving plaatsvindt.
Kennisbronnen
Er is ten minste één kennisbron vereist. Gebruik + Kennisbron toevoegen om er meer toe te voegen. Voor elke bron kies je de Bron: File, URL of Zendesk.
Een bron toevoegen is slechts het halve werk. Hoe je de inhoud binnen je bronnen structureert, heeft rechtstreeks invloed op de antwoordkwaliteit, en sommige onderwerpen kun je beter helemaal weglaten omdat de software ze al levert. Voor wat je moet opnemen, wat je moet weglaten en hoe je je inhoud opmaakt, zie De kennisbasis voor MagicAI Chat opbouwen.
Type File
Upload direct een tekst- of PDF-bestand (max. 10 MB per bestand). Voor meerdere bestanden maak je meerdere bronnen aan.
Type URL
Voer de start-URL van een webpagina in. Het systeem crawlt tot 5 niveaus diep en volgt maximaal 50 links vanaf de start-URL. Beide limieten zijn vast en kunnen niet worden gewijzigd.
Type Zendesk
Voer de basis-URL van je Zendesk Help Center in, bijvoorbeeld https://yourstudio.zendesk.com. Artikelen worden opgehaald in alle talen die beschikbaar zijn in je Zendesk Help Center, zoals per tenant geconfigureerd.
Kennisbronnen bijwerken
Wanneer je een nieuwe kennisbron opslaat, wordt deze automatisch gepubliceerd en geïndexeerd zodat de bot deze kan gebruiken.
Als de inhoud achter een bestaande kennisbron verandert (bijvoorbeeld je website is bijgewerkt of je hebt een nieuw bestand geüpload), activeer dan een onmiddellijke update met de knop Kennisbronnen bijwerken onderaan de kennisbronnenkaart op de detailpagina. Dit herindexeert alle bronnen direct, zodat de wijzigingen meteen in de antwoorden van de bot verschijnen. Als je geen handmatige update uitvoert, worden alle kennisbronnen elke nacht automatisch opnieuw geïndexeerd.
Aanbevolen inhoud en formaat
Of de chatbot goed kan antwoorden, hangt veel meer af van de structuur en de taal van je bronnen dan van het brontype. Volg de volgende aanbevelingen wanneer je inhoud voorbereidt.
- Voorkeursformaten: Markdown of platte tekst. Beide zijn duidelijk gestructureerd en worden netjes in blokken opgesplitst. PDF's werken zolang de tekst extraheerbaar is; vermijd gescande PDF's, bestanden met alleen afbeeldingen en Excel-bladen.
- Gebruik een FAQ-structuur: de kop is de vraag, de body is een op zichzelf staand antwoord. Elke sectie moet op zichzelf logisch zijn; enige herhaling tussen secties is prima als elk blok daardoor zelfvoorzienend blijft.
- Consistente terminologie: gebruik overal dezelfde woorden voor hetzelfde begrip. Vermijd marketingtaal, tegenstrijdige uitspraken tussen bronnen en verouderde inhoud.
De configuratie opslaan
Het venster biedt twee manieren om de aanmaakstroom te verlaten:
- Concept opslaan (actie in de koptekst van het venster): bewaart de configuratie in de status Concept . In deze modus mogen verplichte velden leeg zijn. Gebruik het om configuraties in uitvoering te bewaren zonder ze activeerbaar te maken.
- Volgende (de primaire knop onderaan elke sectie): gaat door de secties. In de laatste sectie wordt het de verzendactie en wordt de configuratie opgeslagen in de status Gepubliceerd . Verplichte velden moeten volledig zijn; anders blokkeert het venster het verzenden. Gepubliceerd betekent alleen dat de configuratie is opgeslagen en volledig is; het maakt de chat nog niet live voor leden. Activering in studio's is een aparte stap (zie Activeren en autoriseren (whitelist)).
In beide gevallen kom je op de detailpagina, waar elke sectie als een kaart verschijnt en afzonderlijk kan worden bewerkt.
Detailweergave en status
De detailpagina heeft twee tabbladen:
- Instellingen: kaarten voor Basisinformatie, Wettelijke toestemming, Vormgeving (met de subkaarten Kleuren en look en Avatar), Functies, Kennisbronnen en Codefragment.
- Self-service: kaarten voor Persoonlijke lidmaatschapsgegevens en Contractgegevens. Zie Configuratie van zelfbediening voor klanten.
De detailpagina toont de huidige status op twee plaatsen.
Statuschip naast de configuratietitel:
- Concept: de configuratie wordt nog opgebouwd en kan niet worden geactiveerd.
- Actief: gepubliceerd en geactiveerd in ten minste één studio.
- Inactief: gepubliceerd maar momenteel nergens geactiveerd.
Waarschuwingsbanner bovenaan de pagina:
- Concepten tonen: Deze configuratie is nog niet voltooid en heeft momenteel de status "Concept". Om deze te activeren, moet je eerst alle verplichte velden invullen.
- Gepubliceerde configuraties tonen een bevestigingsbanner (informatieve ernst).
De actie Instellingen bewerken in de kop van de detailpagina is alleen beschikbaar wanneer de configuratie de status Gepubliceerd heeft.
Configuratie van zelfbediening voor klanten
Wanneer je Zelfbediening voor klanten inschakelt in de sectie Functies, wordt het tabblad Self-service op de detailpagina de plek om te bepalen welke accountgebieden leden via de chat kunnen lezen en bewerken. Het tabblad bevat twee kaarten.
Persoonlijke lidmaatschapsgegevens
- Algemene gegevens: of leden hun algemene gegevens kunnen bekijken of wijzigen.
- Adres: toegang tot adresgegevens.
- Contactgegevens: toegang tot telefoon, e-mail en vergelijkbare contactgegevens.
Contractgegevens
- Contractgegevens: welke contracten zichtbaar zijn (Alle contracten of Actieve contracten).
- Beëindiging van het hoofdcontract: of leden hun hoofdcontract via de chat kunnen beëindigen.
- Pauzeperiode voorstellen vóór beëindiging: of de chat proactief een pauzeperiode voorstelt wanneer een lid probeert te beëindigen.
- Pauzeperiodes: of leden een pauzeperiode kunnen aanvragen.
Elk bewerkbaar veld toont zijn huidige status (bijvoorbeeld Ingeschakeld) en een link Wijzigingen controleren die de verificatie-instellingen voor het veld opent.
Activeren en autoriseren (whitelist)
Twee afzonderlijke concepten bepalen waar een configuratie beschikbaar is en waar deze is geactiveerd:
- Autorisatie (whitelist): de studio's die toegang hebben tot een configuratie. Ingesteld in de detailweergave van de configuratie.
- Activering: de studio's waar deze configuratie de actieve is. Ingesteld vanuit het configuratieoverzicht. De chat wordt pas zichtbaar voor leden zodra de insluitcode ook aanwezig is op de studiowebsite (zie De chatwidget insluiten).
Een configuratie activeren:
- Open het overzicht onder Instellingen / MagicAI / Chat.
- Selecteer de configuratie die je wilt activeren.
- Kies de studio's waar deze moet draaien.
Belangrijke regels:
- Er kan per studio slechts één configuratie actief zijn. Een configuratie in een studio activeren deactiveert automatisch elke configuratie die daar eerder actief was.
- Als je een configuratie activeert in een studio die nog niet geautoriseerd is, wordt de studio automatisch aan de autorisatielijst toegevoegd.
- Je kunt een configuratie die nog in conceptstatus is niet activeren. Sla deze eerst op als een volledige, gepubliceerde configuratie; anders mislukt de activering met Kan een conceptconfiguratie niet activeren.
- Je kunt een configuratie niet verwijderen zolang deze in een studio actief is. Deactiveer deze eerst overal.
De chatwidget insluiten
De detailpagina bevat een kaart Codefragment met de insluitcode voor je studiowebsite. Kopieer het fragment en plak het in de broncode van je website om de chatwidget te tonen.
De kaart gedraagt zich anders afhankelijk van de configuratiestatus:
- Concept: de kaart toont het bericht De huidige configuratie is momenteel in conceptmodus. Om een codefragment te verkrijgen, moet je de chatbotconfiguratie voltooien. De kopieeractie is uitgeschakeld.
- Gepubliceerd: het fragment wordt getoond samen met een actie Kopiëren die de code op het klembord plaatst.
Gegevens van derden en licenties
Voor studiolocatiegegevens gebruiken we geogegevens van GeoNames.org, gelicentieerd onder CC BY 4.0. De licentie verplicht ons het gebruik transparant te vermelden; laat deze kennisgeving op zijn plaats wanneer je het artikel hergebruikt.