MagicAI Chat instellen

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
• Fast Finance Link
• Activeren en autoriseren (whitelist)
• De chatwidget insluiten
• Gegevens van derden en licenties
• Waar leden de chat vinden

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).

Let op: Leden moeten duidelijk kunnen herkennen dat ze met een AI-systeem communiceren (conform de EU-AI-verordening, artikel 50). Formuleer het welkomstbericht dienovereenkomstig. Voorbeeld: “Hallo! Ik ben je digitale AI-assistent. Ik help je graag met vragen over je lidmaatschap, onze lessen of algemene info over de studio. Waarmee kan ik je vandaag helpen?”

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 een 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.

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.

Fast Finance Link

Als je Fast Finance Link activeert in de sectie Functies, kan de chatbot een geauthenticeerd lid na controle van de betaalstatus een Fast Finance Link per e-mail sturen, zodat het openstaande claims kan afwikkelen of zijn betaalmethode kan bijwerken. De verzending verloopt op dezelfde manier als het handmatig versturen vanuit het ledenaccount, inclusief het daar geconfigureerde communicatiesjabloon.

• Vereiste: in de Fast-Finance Link-instellingen van de studio moet een communicatiesjabloon voor de handmatige verzending zijn geconfigureerd. Zonder sjabloon kan de chatbot geen e-mail versturen. Meer informatie in het artikel De Fast-Finance Link configureren.
• De link zelf verschijnt nooit in het chatgesprek. Na verzending toont de chatbot het lid alleen een gemaskeerde bevestiging van het ontvangeradres (bijvoorbeeld d***n@example.com).
• Welke onderdelen (betaling, betaalmethode) de e-mail bevat, hangt af van de Fast-Finance Link-configuratie van de studio; de chatbot maakt hierin geen eigen keuze.
• De chatbot belooft nooit dat een toegangsbeperking direct na betaling wordt opgeheven. Hij laat het lid weten dat de beperking hierdoor kan worden opgelost en adviseert contact op te nemen met de studio als het probleem aanhoudt.

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).

Dit geldt voor de eigen studiowebsite. In de Member Platform en in Branded Web is geen embedcode nodig. Waar leden de chat vinden.

Een configuratie activeren:

1. Open het overzicht onder Instellingen / MagicAI / Chat.
2. Selecteer de configuratie die je wilt activeren.
3. 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. Het snippet heb je alleen nodig voor je eigen website. In de Member Platform en in Branded Web verschijnt de chat zonder snippet.

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.

Waar leden de chat vinden

Leden bereiken de chat op drie plekken. Op je eigen website verschijnt hij zodra je de embedcode hebt geplaatst. In de Member Platform en in Branded Web verschijnt hij van zichzelf als zwevende chatknop, zonder verdere instellingen.

Een lid ziet de chat in de Member Platform en in Branded Web wanneer de eigen studio een configuratie heeft die zowel gepubliceerd als geactiveerd is. Bepalend is de studio van het lid, niet de studio die het bezoekt. In een groep met meerdere studio's beslis je dus per studio of de leden daarvan de chat krijgen.

Twee gevolgen die je moet kennen:

• Een configuratie met de status concept bereikt leden nergens, niet op de website en niet in de Member Platform.
• Als je een configuratie in een studio deactiveert, verdwijnt de chat voor de leden van die studio ook in de Member Platform en in Branded Web, niet alleen op de website.

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.

Let op: Dit artikel is met behulp van AI vertaald. Onze excuses voor eventuele fouten.