Visuele stap-voor-stap handleiding

sem.chat documentatie

Een SEMJAT handleiding met screenshot, opgebouwd uit de echte sem.chat dashboardstroom. In elke handleiding leest u wat u moet klikken, wat er na de klik moet gebeuren, hoe u dit kunt testen, hoe u problemen kunt oplossen en wat u vervolgens moet doen.

Geen overeenkomende handleidingen gevonden. Probeer een korter zoekwoord, zoals widget, API, spraak, facturering, webhook, WordPress, SendPulse of planning.
Screenshot-opmerking: elke afbeelding in deze handleiding is vastgelegd vanuit de echte sem.chat-app met een demo-werkruimte. Gevoelige accountgegevens, klantgegevens, API-sleutels, betaalgegevens en privégesprekken worden vóór publicatie gemaskeerd.
01

Aan de slag

Maak het account aan, voltooi de onboarding, begrijp het dashboard, maak de eerste bot, test deze privé, installeer hem en kies het juiste plan.

/authAanmelden, proefversie en eerste bot
Echte screenshot van de sem.chat-demo-werkruimte
1Begin met Aanmelden of Aanmelden vanaf de openbare site of app.
2Verifieer het e-mailadres voordat u vertrouwt op meldingen of factureringsberichten.
3Gebruik onboarding om de eerste bot te maken voordat u het dashboard opent.
/overzichtOverzicht na inloggen
Echte screenshot van de sem.chat-demo-werkruimte
1Gebruik snelle acties om een bot te maken, bots te bekijken, analyses te openen of de facturering te beheren.
2Beoordeel actieve bots, conversations, stemminuten en tevredenheid voordat u wijzigingen aanbrengt.
3Controleer de recente activiteit na elke installatietest.
Eerste lancering

Meld u aan, start de proefperiode en begrijp het dashboard

Waar dit voor is: Gebruik deze workflow voor een geheel nieuwe werkruimte of wanneer u een teamgenoot in dienst neemt die nog nooit sem.chat heeft gebruikt.

Voordat je begint
  • Gebruik een zakelijk e-mailadres dat verificatie- en facturerings-e-mails kan ontvangen.
  • Bepaal wie de eigenaar van de werkruimte moet zijn voordat u de rest van het team uitnodigt.
  • Houd een veilige testwebsite of testpagina gereed voor de installatie van widgets.
1

Open de aanmeldingspagina voor de app

Ga naar app.sem.chat/auth vanaf de knop Aanmelden / Aanmelden van de website.

Verwacht resultaat: De authenticatiepagina toont opties voor inloggen en het maken van accounts.
2

Maak het account aan

Voer het zakelijke e-mailadres in, maak het wachtwoord aan en verzend het aanmeldingsformulier.

Verwacht resultaat: De app vraagt om verificatie of gaat over op onboarding nadat het account is geaccepteerd.
3

Controleer de e-mail

Open de verificatie-e-mail en klik op de bevestigingslink.

Verwacht resultaat: Het account kan facturerings-, uitnodigings-, rapport- en waarschuwingsberichten ontvangen.
4

Volledige onboarding

Voer de bedrijfsnaam in, beschrijf het assistentdoel, kies een startkleur en maak de eerste bot.

Verwacht resultaat: De werkruimte wordt geopend met een botconcept en een actieve proefstatus.
5

Overzicht openen

Klik op Overzicht in de linkerzijbalk.

Verwacht resultaat: Het dashboard toont usage kaarten, snelle acties en recente activiteit.
6

Kies de volgende actie

Gebruik Nieuwe bot maken voor configuratie, Alle bots weergeven voor beheer, Analytics voor prestaties of Facturering voor abonnementslimieten.

Verwacht resultaat: Afhankelijk van de status van de werkruimte weet u waar u verder moet gaan.
Hoe het te testen: Maak één privétestbot en stuur een testbericht voordat u teamgenoten uitnodigt. Bevestig de wijzigingen in de overzichtsactiviteit na de test.
ProbleemRepareren
Verificatie-e-mail komt niet aanControleer de spam, bevestig de spelling van de e-mail en vraag vervolgens een nieuwe verificatie-e-mail aan.
Dashboard wordt geopend op FactureringDe werkruimte heeft mogelijk een actieve proefversie of plan nodig. Start de proefperiode of kies het juiste abonnement voordat u aan de slag gaat.
Een teamgenoot heeft geen toegang tot de werkruimteNodig ze uit via Instellingen, Team in plaats van de eigenaarslogin te delen.

Wat u nu moet doen: Maak de eerste bot, test deze privé en installeer de widget vervolgens op een testpagina.

Privé-lanceringstest

Maak de eerste privébottest voordat u live gaat

Waar dit voor is: Gebruik dit om het bijhouden van accounts, bots, widgets en geschiedenis te verifiëren voordat klanten de assistent zien.

Voordat je begint
  • Houd één voorbeeldklantvraag gereed.
  • Zorg ervoor dat u een stagingpagina of een lokale HTML-testpagina gereed heeft.
  • Gebruik bij de eerste test geen echte klantgegevens.
1

Open My Bots

Klik op My Bots in de zijbalk of gebruik Alle bots weergeven vanuit overzicht.

Verwacht resultaat: U kunt de bot zien die tijdens de onboarding is gemaakt of een lege status hebben met de knop Nieuwe bot.
2

Open de botbouwer

Klik op Nieuwe bot of Bewerken op de bestaande bot.

Verwacht resultaat: De Bot Builder wordt geopend met basis-, widget-, kennis-, stem- en integratiebesturingselementen.
3

Sla de bot één keer op

Vul de vereiste botnaam en het eerste bericht in en klik vervolgens op Opslaan.

Verwacht resultaat: De bot ontvangt een geldig ID en kan insluitcode genereren.
4

Privé bekijken

Gebruik het voorbeeldpaneel en stel uw voorbeeldvraag.

Verwacht resultaat: Het antwoord moet overeenkomen met uw instructies of onthullen welke kennis ontbreekt.
5

Installeer op staging

Open Embed, kopieer het fragment HTML en plak het vóór de afsluitende body-tag op de testpagina.

Verwacht resultaat: De widget verschijnt in de geconfigureerde hoek op desktop en mobiel.
6

Bevestig het volgen

Open Inbox of Chat History na het testgesprek.

Verwacht resultaat: Het testgesprek verschijnt met de juiste bot-, kanaal- en berichtgeschiedenis.
Hoe het te testen: Verzend één sms-bericht en één stemtest als stem is ingeschakeld. Bevestig dat beide verschijnen in Chat History.
ProbleemRepareren
Insluitcode is niet beschikbaarSla eerst de bot op. Als stemsynchronisatie nog steeds in behandeling is, wacht dan op synchronisatie of sla opnieuw op nadat de verplichte velden zijn ingevuld.
De widget toont de verkeerde botBevestig dat data-bot-id in het fragment overeenkomt met de bot-ID uit de Embed-modal.
Er verschijnt geen gesprek in de geschiedenisVernieuw Chat History, bevestig dat de bot actief is en zorg ervoor dat de test op de geïnstalleerde widget heeft plaatsgevonden en niet op een verouderde pagina.

Wat u nu moet doen: Ga verder met Bot Builder installatie- en kennistraining.

02

Maak en configureer een bot

Bouw, bewerk, bekijk een voorbeeld, activeer, draag over of verwijder bots van My Bots en Bot Builder.

/dashboardMy Bots controlecentrum
Echte screenshot van de sem.chat-demo-werkruimte
1Klik op Nieuwe Bot om een nieuwe assistent te starten.
2Gebruik Bewerken, Insluiten, Overdragen, Activeren of Verwijderen op elke botkaart.
3Controleer de actieve status en de laatst bijgewerkte tijd voordat u gaat testen.
/bots/:id/editTabblad Basisinformatie Bot Builder
Echte screenshot van de sem.chat-demo-werkruimte
1Vul de botnaam, avatar, eerste bericht en systeeminstructies in.
2Gebruik Preview om te testen voordat u publiceert.
3Bewaar en synchroniseer voordat u de insluitcode kopieert.
Bot maken

Maak een nieuwe bot van My Bots

Waar dit voor is: Gebruik deze workflow wanneer een nieuw merk, website, ondersteuningswachtrij of campagne een eigen assistent nodig heeft.

Voordat je begint
  • Bereid de botnaam, het doel, het eerste bericht en twee of drie voorbeeldvragen voor.
  • Verzamel de openbare website URL als u van plan bent inhoud te importeren.
  • Bevestig dat het abonnement het aantal bots en spraak-/avatarfuncties toestaat dat u nodig heeft.
1

Open My Bots

Klik op My Bots in de zijbalk.

Verwacht resultaat: Bestaande bots en de knop Nieuwe Bot zijn zichtbaar.
2

Klik op Nieuwe bot

Start een nieuwe bot vanaf de pagina My Bots.

Verwacht resultaat: Bot Builder wordt geopend met een conceptassistent.
3

Bot-identiteit instellen

Voer de Botnaam in, upload of kies een avatar en schrijf het eerste bericht dat bezoekers te zien krijgen.

Verwacht resultaat: Het voorbeeldpaneel geeft de naam, avatar en begroeting van de assistent weer.
4

Systeeminstructies schrijven

Beschrijf wat de bot moet doen, hoe hij moet spreken, wat hij moet vermijden en wanneer hij om menselijke hulp moet vragen.

Verwacht resultaat: De assistent heeft duidelijke gedragsregels voordat kennis wordt toegevoegd.
5

Voeg basiskennis toe

Plak essentiële bedrijfs-, product-, ondersteunings-, prijs- en contactgegevens in het kennisgebied.

Verwacht resultaat: De bot kan veelgestelde vragen beantwoorden zonder dat er nog een website-import nodig is.
6

Bewaar de bot

Klik op Opslaan en wacht op de opgeslagen of gesynchroniseerde bevestiging.

Verwacht resultaat: De bot heeft een stabiele ID, er kan een preview worden getest en er komen insluitopties beschikbaar.
7

Bekijk een voorbeeld van het resultaat

Stel de voorbereide voorbeeldvragen in Preview.

Verwacht resultaat: Antwoorden moeten de instructies volgen en de kennis gebruiken die u hebt ingevoerd.
8

Activeer alleen als u klaar bent

Zet de bot actief nadat de privétest is geslaagd.

Verwacht resultaat: De bot is klaar voor widget- of kanaalverkeer.
Hoe het te testen: Stel minimaal vijf realistische vragen. Controleer of het antwoord juist is, of het bij het merk blijft en of er om menselijke hulp wordt gevraagd wanneer dat nodig is.
ProbleemRepareren
Het antwoord is te algemeenVoeg meer specifieke kennis toe en herschrijf instructies met voorbeelden van goede antwoorden.
De bot weigert vragen die hij zou moeten beantwoordenVerwijder al te strikte instructies en voeg vertrouwde kennis toe voor dat onderwerp.
Opslaan genereert geen insluitcodeControleer de verplichte velden en sla opnieuw op nadat de synchronisatie van de spraakprovider is voltooid.

Wat u nu moet doen: Configureer widgetinstellingen, voeg websitekennis toe en installeer vervolgens de bot.

Beheer bots

Bewerk, kloon de workflow, breng een bot over, deactiveer of verwijder deze

Waar dit voor is: Gebruik deze workflow wanneer een bot updates, eigendomswijzigingen, tijdelijke pauzes of permanente verwijdering nodig heeft.

Voordat je begint
  • Exporteer alle gespreks- of contactgegevens die u moet bewaren voordat u een bot verwijdert.
  • Controleer of de bot niet is ingesloten op een live website voordat u deze verwijdert of overdraagt.
  • Vertel teamgenoten voordat u een productiebot deactiveert.
1

Open My Bots

Zoek de botkaart op naam of status.

Verwacht resultaat: De kaart toont de huidige status en beschikbare acties.
2

Klik op Bewerken

Open de botbouwer en breng de gewenste wijzigingen aan.

Verwacht resultaat: De editor laadt de huidige configuratie.
3

Opslaan en opnieuw testen

Klik op Opslaan na elke materiële wijziging en voer vervolgens voorbeeldvragen uit.

Verwacht resultaat: De opgeslagen configuratie wordt gebruikt door de preview en geïnstalleerde widget.
4

Tijdelijk deactiveren

Gebruik de actieve schakelaar als de bot voorlopig moet stoppen met het verwerken van bezoekers.

Verwacht resultaat: De bot stopt met het bedienen van live verkeer terwijl de configuratie behouden blijft.
5

Eigendom overdragen

Gebruik Overdracht, voer het e-mailadres van de ontvanger in en bevestig.

Verwacht resultaat: Het geselecteerde account wordt eigendom volgens het app-overdrachtsproces.
6

Alleen verwijderen na controle

Gebruik Verwijderen, lees de waarschuwing en bevestig alleen wanneer de bot niet langer nodig is.

Verwacht resultaat: De bot en gerelateerde configuratie worden verwijderd volgens de waarschuwing.
Hoe het te testen: Open na het bewerken de geïnstalleerde widget en stel de exacte vraag die de wijziging heeft gemotiveerd. Bevestig dat het live antwoord is gewijzigd.
ProbleemRepareren
Het oude antwoord verschijnt nog steedsVernieuw de websitepagina, bevestig dat u de juiste bot hebt opgeslagen en controleer of geïmporteerde kennis moet worden gesynchroniseerd.
Overdracht misluktBevestig dat het e-mailadres van de ontvanger geldig is en dat het bestemmingsaccount de bot kan accepteren.
Er is per ongeluk op Verwijderen gekliktStop vóór de definitieve bevestiging. Er bestaan ​​verwijderingswaarschuwingen omdat de actie botgegevens permanent kan verwijderen.

Wat u nu moet doen: Bekijk analyses en geschiedenis na live wijzigingen om ervoor te zorgen dat de bezoekerservaring verbetert.

03

Installeer de widget

Kopieer de juiste insluitcode, installeer deze in HTML, WordPress, React of geavanceerde SDK contexten en controleer vervolgens het desktop- en mobiele gedrag.

Modaal insluitenKopieer het website-installatiefragment
Echte screenshot van de sem.chat-demo-werkruimte
1Kies HTML, WordPress, React of NPM/SDK op basis van de sitestack.
2Kopieer de code nadat de bot is opgeslagen en gesynchroniseerd.
3Plak het fragment vóór de afsluitende body-tag of in de raamwerklay-out.
HTML installeren

Installeer de widget op een standaard HTML website

Waar dit voor is: Gebruik dit wanneer u de paginasjabloon, themavoettekst of algemene HTML-indeling kunt bewerken.

Voordat je begint
  • Sla de bot eerst op, zodat de insluitingsmodal een echte bot-ID heeft.
  • Gebruik vóór de productie een testlocatie.
  • Bewaar de exacte scriptversie en data-bot-id uit de modale versie.
1

Open My Bots

Zoek de bot die u wilt installeren en klik op Insluiten.

Verwacht resultaat: Het Embed-modal wordt geopend met installatietabbladen.
2

Selecteer HTML

Kies het tabblad HTML en klik op Code kopiëren.

Verwacht resultaat: Het widgetscript wordt gekopieerd met de bot-ID eraan gekoppeld.
3

Open de websitesjabloon

Bewerk de algemene voettekst of het lay-outbestand dat wordt weergegeven op elke pagina waar de widget zou moeten verschijnen.

Verwacht resultaat: U bewerkt de gedeelde siteshell en niet één enkele geïsoleerde pagina, tenzij dat opzettelijk is.
4

Plakken voordat je de body sluit

Plak het fragment onmiddellijk vóór de afsluitende body-tag.

Verwacht resultaat: Het script wordt na de pagina-inhoud geladen en kan de widgetcontainer koppelen.
5

Publiceren of implementeren

Sla de sjabloon op en implementeer de site.

Verwacht resultaat: Het widgetscript is live op de doelpagina's.
6

Test desktop en mobiel

Open de site in een nieuw browservenster en op een mobiele viewport.

Verwacht resultaat: De widget verschijnt in de geconfigureerde positie en wordt geopend zonder consolefouten.
Hoe het te testen: Stuur een bericht vanaf de livepagina en open vervolgens Inbox en Chat History om te bevestigen dat het gesprek bij de juiste bot hoort.
ProbleemRepareren
Widget ontbreektBevestig dat de code vóór de afsluitende body-tag staat, dat scripts niet worden geblokkeerd door de sitebouwer en dat de bot actief is.
Er verschijnt een verkeerde botKopieer het fragment opnieuw en vergelijk de data-bot-id met de gewenste bot.
Widget overlapt paginabesturingselementenWijzig de positie of grootte in Widgetinstellingen en test opnieuw op mobiel.

Wat u nu moet doen: Stem de widgetinstellingen en leadregistratie af na installatie.

HTML insluiten
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Platforminstallatie

Installeren in WordPress, React of geavanceerde spraakstromen SDK

Waar dit voor is: Gebruik dit wanneer de website wordt beheerd door een CMS, React app of aangepaste spraakintegratie.

Voordat je begint
  • Weet welke stapel eigenaar is van de gedeelde lay-out.
  • Gebruik het exacte fragment dat wordt weergegeven in sem.chat voor de geselecteerde bot.
  • Voor geavanceerd gebruik van SDK moet u bevestigen dat u over de vereiste openbare sleutel Vapi en assistent-ID beschikt.
1

WordPress optie

Gebruik Uiterlijk, Thema-editor, footer.php of een vertrouwde kop- en voettekstplug-in.

Verwacht resultaat: Het fragment wordt geladen op openbare WordPress pagina's.
2

React optie

Maak een kleine ChatWidget-component, voeg het script toe aan useEffect en geef het weer in de hoofdindeling.

Verwacht resultaat: De widget wordt één keer geladen en opgeschoond als de lay-out wordt ontkoppeld.
3

Geavanceerde SDK optie

Gebruik het tabblad NPM/SDK alleen als u aangepaste bedieningselementen voor spraakoproepen nodig heeft die verder gaan dan de standaardwidget.

Verwacht resultaat: Uw app beheert de spraaksessie terwijl sem.chat de geconfigureerde assistentbron blijft.
4

Controleer de bot-ID

Bevestig dat de geïnstalleerde code verwijst naar de bot-ID uit de Embed-modal.

Verwacht resultaat: De live widget maakt verbinding met de beoogde assistent.
5

Controleer console

Open de browserontwikkelaarstools en laad opnieuw.

Verwacht resultaat: Er zijn geen geblokkeerde script-, dubbele container- of netwerkfouten.
Hoe het te testen: Vul één testbericht in vanaf de geïnstalleerde site en bevestig vervolgens dat het in Inbox verschijnt met de verwachte pagina URL.
ProbleemRepareren
React laadt dubbele widgetsBeveilig het invoegen van scripts met een ref of geef de component alleen weer in de hoofdindeling.
WordPress verwijdert scripttagsGebruik een plug-in voor voettekstinjectie of een themabestand dat scripts toestaat.
SDK oproep kan niet startenControleer de openbare sleutel, assistent-ID, browsermachtigingen en plan toegang voor spraak.

Wat u nu moet doen: Ga naar Widget-instellingen om gedrag, branding en het vastleggen van leads te beheren.

WordPress voettekstfragment
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React onderdeel
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Geavanceerde stem SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

Widget-instellingen

Configureer modus, thema, grootte, positie, kleur, branding, reacties, geluid, toestemming, leadregistratie, beoordelingen, vervolg-e-mail en activeringsstatus.

Bot Builder / WidgetWidgetuiterlijk en bezoekersgedrag
Echte screenshot van de sem.chat-demo-werkruimte
1Kies de modus chat, spraak of hybride.
2Stel thema, kleur, positie, grootte, branding, toestemming en geluid in.
3Configureer het vastleggen van leads, beoordelingen, reacties en vervolggedrag.
Widget-gedrag

Configureer het gedrag van bezoekersgerichte widgets

Waar dit voor is: Gebruik dit na de eerste installatie of wanneer de widget bij de website moet passen en betere leads moet genereren.

Voordat je begint
  • Installeer de widget op een stagingpagina.
  • Weet of bezoekers moeten beginnen met chat, stem of beide.
  • Bereid toestemming en leadcapture-kopie voor, indien nodig voor de regio.
1

Open de botbouwer

Open My Bots, klik op Bewerken en kies vervolgens het tabblad Widget.

Verwacht resultaat: Widgetbesturingselementen verschijnen voor de geselecteerde bot.
2

Kies de modus

Selecteer Chat, Spraak of Hybride op basis van de gewenste bezoekerservaring.

Verwacht resultaat: Het voorbeeld verandert en toont de gekozen modus.
3

Uiterlijk instellen

Kies thema, kleur, grootte, knoppositie en merkopties.

Verwacht resultaat: De widget komt overeen met de site zonder belangrijke inhoud te bedekken.
4

Schakel bezoekersbeheer in

Schakel reacties, geluid, beoordelingen en toestemmingsprompts in of uit.

Verwacht resultaat: Bezoekers zien alleen de bedieningselementen die u wilt gebruiken.
5

Configureer leadregistratie

Kies verplichte velden, optioneel beschrijvingsveld en wanneer het formulier verschijnt.

Verwacht resultaat: Contacten worden vóór of tijdens conversations verzameld, afhankelijk van uw instellingen.
6

Vervolg-e-mail instellen

Configureer het vervolg-e-mailgedrag als uw abonnement dit omvat.

Verwacht resultaat: Bezoekers kunnen vervolgberichten ontvangen nadat conversations is opgelost.
7

Opslaan en testen

Klik op Opslaan, laad de stagingpagina opnieuw en open de widget.

Verwacht resultaat: De live widget komt overeen met de opgeslagen instellingen.
Hoe het te testen: Open de widget op desktop en mobiel, dien een leadformulier in, laat een beoordeling achter en bevestig dat het contact en het gesprek zijn opgenomen.
ProbleemRepareren
Kleur is niet bijgewerktSla de bot op, vernieuw de website hard en bevestig dat de geïnstalleerde widget dezelfde bot-ID gebruikt.
Leadvelden ontbrekenBevestig dat het vastleggen van leads is ingeschakeld en dat aan de geselecteerde triggervoorwaarde is voldaan.
Bezoekers kunnen geen stem gebruikenControleer de steminstellingen, de microfoontoestemming van de browser, plan de toegang en de limieten voor spreekminuten.

Wat u nu moet doen: Voeg stem-/avatarinstellingen en kennisbronnen toe voordat de productie wordt gelanceerd.

05

Stem en avatars

Selecteer standaardstemmen, configureer de stemmodus en -limieten, lees transcripties, kloon stemmen, wijs gekloonde stemmen toe en beheer standaard- of aangepaste avatars.

Bot Builder / StemStem, limieten, transcripties en avatars
Echte screenshot van de sem.chat-demo-werkruimte
1Kies een standaardstem of een opgeslagen gekloonde stem.
2Stel limieten voor spreekminuten en het opslaan van transcripties in.
3Kies voorraadavatars of upload een aangepaste avatar als het plan dit toestaat.
Stemconfiguratie

Spraakoproepen en transcripties instellen

Waar dit voor is: Gebruik dit wanneer bezoekers met de bot moeten praten in plaats van alleen te typen.

Voordat je begint
  • Bevestig dat het plan spraakminuten en de gewenste spraak-/avataropties bevat.
  • Gebruik een stille browseromgeving om te testen.
  • Bereid één realistische ondersteunings- of verkoopvraag voor om deze met uw stem te testen.
1

Open Spraakinstellingen

Open de botbouwer en selecteer het gebied Stem of Stem en Avatars.

Verwacht resultaat: Stembediening en huidige stemselectie zijn zichtbaar.
2

Selecteer een aandelenstem

Bekijk een voorbeeld van de beschikbare stemmen, kies de beste pasvorm en sla de selectie op.

Verwacht resultaat: De bot gebruikt de gekozen stem voor oproepen.
3

Configureer de spraakmodus

Gebruik Widgetinstellingen om Spraak of Hybride te kiezen wanneer stem beschikbaar moet zijn voor bezoekers.

Verwacht resultaat: Bezoekers zien een stemoptie in de widget.
4

Stel stemlimieten in

Definieer limieten per gebruiker of werkruimte, indien beschikbaar.

Verwacht resultaat: Lange of herhaalde gesprekken mogen niet meer minuten in beslag nemen dan bedoeld.
5

Schakel transcripties in

Schakel het opslaan van transcripties in als u gespreksbeoordeling in de geschiedenis nodig heeft.

Verwacht resultaat: Spraakoproepen zorgen voor leesbare transcripties na de sessie.
6

Een gesprek testen

Open de widget, geef toegang tot de microfoon, start een gesprek en stel de voorbereide vraag.

Verwacht resultaat: De bot reageert met uw stem en het gesprek eindigt netjes.
7

Lees het transcript

Open Chat History en zoek het spraakgesprek.

Verwacht resultaat: Het transcript laat zien wat de bezoeker en de bot hebben gezegd.
Hoe het te testen: Voer één kort gesprek uit en bevestig dat de stemminuten, het transcript en de gespreksmodus zijn opgenomen.
ProbleemRepareren
Browser blokkeert microfoonGeef microfoontoestemming in de browser en laad de pagina opnieuw.
Spraakoptie is vergrendeldOpen Facturering en bevestig dat het werkruimteplan spraakfuncties bevat.
Afschrift is leegBevestig dat het opslaan van transcripties is ingeschakeld en dat het gesprek normaal is beëindigd.

Wat u nu moet doen: Voeg kennis toe of verfijn deze, zodat gesproken antwoorden accuraat zijn.

Stemkloon en avatar

Kloon een stem en wijs een aangepaste avatar toe

Waar dit voor is: Gebruik dit wanneer de assistent een merkstem of pratende avatar-ervaring nodig heeft.

Voordat je begint
  • Gebruik alleen audio en afbeeldingen waarvoor u toestemming heeft om te gebruiken.
  • Neem zuivere stemsamples op met weinig achtergrondgeluid.
  • Bevestig planlimieten voor gekloonde stemmen en aangepaste avatars.
1

Open stemklonen

Klik op Stem klonen in het gebied Stem.

Verwacht resultaat: Het uploaddialoogvenster toont geaccepteerde voorbeeldvereisten.
2

Voorbeelden uploaden

Upload één tot vijf duidelijke opnames en dien het kloonverzoek in.

Verwacht resultaat: De gekloonde stem verschijnt na verwerking of het dialoogvenster toont de volgende vereiste.
3

Wijs de gekloonde stem toe

Selecteer de gekloonde stem in de stemkiezer en sla deze op.

Verwacht resultaat: Bij toekomstige oproepen wordt de gekloonde stem gebruikt.
4

Kies een aandelenavatar

Kies een inbegrepen avatar als het uploaden van een aangepaste avatar niet nodig is.

Verwacht resultaat: De stemervaring heeft een visuele identiteit.
5

Aangepaste avatar uploaden

Upload een duidelijke gezichtsafbeelding of korte video als uw abonnement dit ondersteunt.

Verwacht resultaat: De avatar wordt verwerkt en komt beschikbaar voor selectie.
6

Voer een volledige preview uit

Start een spraakoproep en bevestig samen het stem-, avatar- en transcriptiegedrag.

Verwacht resultaat: De bezoekerservaring sluit aan bij het geconfigureerde merk.
Hoe het te testen: Stel een korte vraag met de gekloonde stem geselecteerd en bevestig dat het gesprek de verwachte stem/avatar gebruikt.
ProbleemRepareren
De kwaliteit van de kloon is slechtNeem schonere samples op met één luidspreker, stabiel volume en geen muziek.
Het uploaden van aangepaste avatars is niet beschikbaarControleer Facturering voor planafhankelijke avatarlimieten.
De oude stem speelt nog steedsSla de bot op nadat u de nieuwe stem hebt geselecteerd en laad de widgetpagina opnieuw.

Wat u nu moet doen: Ga verder naar Kennis en gegevens, zodat de stemervaring nauwkeurige antwoorden heeft.

06

Kennis en gegevens

Voeg handmatige kennis toe, importeer website-inhoud, pas crawlresultaten toe, synchroniseer geïmporteerde inhoud, voeg productfeed URLs toe, vernieuw of verwijder feeds en verifieer antwoorden met testvragen.

Bot Builder / KennisKennisbronnen en antwoordtesten
Echte screenshot van de sem.chat-demo-werkruimte
1Voeg handmatige kennis toe voor beleid, prijzen en merkregels.
2Websitepagina's importeren en crawlresultaten toepassen.
3Voeg productfeeds toe en synchroniseer ze wanneer de voorraad verandert.
Kennisbronnen

Train de bot met handmatige kennis, website-import en productfeeds

Waar dit voor is: Gebruik dit wanneer de assistent onvolledige antwoorden geeft of nieuwe product-, beleids- of website-informatie nodig heeft.

Voordat je begint
  • Bereid bron URLs en productfeed URLs voor.
  • Bepaal welke pagina's niet mogen worden geïmporteerd, zoals beheerders- of privépagina's.
  • Maak testvragen voor elk onderwerp dat u toevoegt.
1

Open kennis

Open Bot Builder en kies het tabblad Kennis of Gegevens.

Verwacht resultaat: Handmatige kennis, website-import en productfeedtools zijn zichtbaar.
2

Voeg handmatige kennis toe

Plak beknopte feiten, beleid, prijzen, contactgegevens en antwoordstijlnotities.

Verwacht resultaat: De bot heeft een onmiddellijke vertrouwde bron voor antwoorden met hoge prioriteit.
3

Website-inhoud importeren

Plak de openbare website URL en start het crawlen/importeren.

Verwacht resultaat: Crawlresultaten tonen ontdekte pagina's of importstatus.
4

Resultaten bekijken en toepassen

Bewaar nuttige pagina's, verwijder irrelevante pagina's en pas vervolgens de geselecteerde inhoud toe.

Verwacht resultaat: Alleen goedgekeurde website-inhoud komt in de kennisbank.
5

Productfeed URLs toevoegen

Plak Google Merchant Center of ondersteunde feed URLs en importeer.

Verwacht resultaat: Producten, prijzen, beschikbaarheid en attributen worden beschikbaar voor de bot.
6

Vernieuw of verwijder feeds

Gebruik vernieuwen wanneer catalogusgegevens veranderen en verwijder feeds die niet langer worden gebruikt.

Verwacht resultaat: De bot vermijdt verouderde of dubbele productgegevens.
7

Opslaan en synchroniseren

Sla de bot op en wacht tot de synchronisatie is voltooid.

Verwacht resultaat: De nieuwste kennis wordt gebruikt door preview- en live widget-antwoorden.
8

Stel verificatievragen

Stel één testvraag per toegevoegde bron.

Verwacht resultaat: Het antwoord citeert of weerspiegelt de bijgewerkte inhoud nauwkeurig.
Hoe het te testen: Stel vragen over prijzen, retourzendingen, beschikbaarheid, bedrijfsinformatie en niet-ondersteunde onderwerpen. Bevestig dat de bot bekende onderwerpen beantwoordt en geen onbekende details verzint.
ProbleemRepareren
Crawler importeert irrelevante pagina'sVerwijder die pagina's uit geselecteerde resultaten en voeg duidelijkere handmatige instructies toe.
De productprijzen zijn oudVernieuw de feed en bevestig dat de feed URL zelf huidige waarden bevat.
Bot verzint antwoordenVoeg een regel toe dat de bot moet zeggen dat hij het niet zeker weet en menselijke ondersteuning moet bieden als er kennis ontbreekt.

Wat u nu moet doen: Keer terug naar Preview, test opnieuw en installeer of update de widget.

07

Inbox, Live Support, Geschiedenis, Contacten

Behandel dagelijks conversations, claim live-ondersteuningsverzoeken, geef de bediening terug aan AI, exporteer de geschiedenis, beheer contacten en synchroniseer contacten met SendPulse.

/inboxWorkflow voor inboxgesprekken
Echte screenshot van de sem.chat-demo-werkruimte
1Filter op bot of kanaal.
2Open een gesprek en antwoord als mens wanneer dat nodig is.
3Gebruik de besturingselementen voor vertalen, oplossen en overdracht zorgvuldig.
/live-ondersteuningLive-ondersteuning overdrachtscontrole
Echte screenshot van de sem.chat-demo-werkruimte
1Claim snel wachtende overdrachten.
2Reageer als agent of geef het gesprek terug aan AI.
3Los op wanneer de bezoeker geen menselijke hulp meer nodig heeft.
/chat-geschiedenisGespreksgeschiedenis en export
Echte screenshot van de sem.chat-demo-werkruimte
1Zoek op bezoeker, bot, kanaal of datum.
2Open volledige transcripties voor tekst- en spraaksessies.
3Exporteer CSV of JSON indien nodig.
/contactenContacten en SendPulse exporteren
Echte screenshot van de sem.chat-demo-werkruimte
1Filter contacten op bot of bron.
2Open contactgegevens en gesprekscontext.
3Exporteer of synchroniseer geselecteerde contacten naar SendPulse.
Antwoord inbox

Open een gesprek en stuur een menselijk antwoord

Waar dit voor is: Gebruik dit wanneer een operator moet reageren op een klant van sem.chat in plaats van AI alleen verder te laten gaan.

Voordat je begint
  • Bevestig dat de operator toegang heeft tot de bot of werkruimte.
  • Lees het gesprek voordat u antwoordt.
  • Weet of de bezoeker hetzelfde taalgebruik verwacht.
1

Open Postvak IN

Klik op Postvak IN in de zijbalk.

Verwacht resultaat: Recente conversations verschijnt met bot, kanaal, bezoeker, status en tijd.
2

Filter indien nodig

Gebruik kanaal-, bot-, ongelezen- of statusfilters om het gesprek te vinden.

Verwacht resultaat: De lijst wordt beperkt tot de gespreksset die u nodig hebt.
3

Open het gesprek

Klik op de bezoekersrij.

Verwacht resultaat: De volledige thread, bezoekersinformatie en antwoordopties zijn zichtbaar.
4

Vertaal indien nodig

Gebruik vertaalopties wanneer de taal van de bezoeker verschilt van de taal van de agent.

Verwacht resultaat: De agent kan het begrijpen en op de juiste manier antwoorden.
5

Stuur een antwoord

Schrijf het menselijke antwoord en verzend het.

Verwacht resultaat: Het bericht wordt aan de thread toegevoegd als een agent/menselijk antwoord.
6

Oplossen of openhouden

Los het gesprek op als het afgerond is, of laat het open voor vervolg.

Verwacht resultaat: De status van de inbox komt overeen met de echte klantstatus.
Hoe het te testen: Stuur een veilig testantwoord op een testgesprek en bevestig dat het verschijnt in de bezoekerswidget en Chat History.
ProbleemRepareren
Het antwoord kan niet worden verzondenControleer de netwerkstatus, de gespreksstatus en of er live ondersteuning is geclaimd.
Bezoekerstaal is verkeerdGebruik vertaling of update bottaalinstellingen voordat u antwoordt.
Het gesprek staat niet in InboxZoek Chat History en bevestig dat de widgettest de juiste bot heeft gebruikt.

Wat u nu moet doen: Gebruik Live Support voor actieve overdrachtswachtrijen en Chat History voor audits.

Live-ondersteuning

Claim, antwoord, geef het terug aan AI en los een overdracht op

Waar dit voor is: Gebruik dit wanneer AI om een mens vraagt of als een bezoeker expliciet een agent nodig heeft.

Voordat je begint
  • Zorg ervoor dat er een agent beschikbaar is voordat u live ondersteuning inschakelt.
  • Bepaal wanneer AI overdracht moet aanvragen in botinstructies.
  • Houd de meldingsinstellingen ingeschakeld voor overdrachtswaarschuwingen.
1

Open Live Support

Klik op Live Support in de zijbalk.

Verwacht resultaat: Wachten en actieve overdracht conversations zijn zichtbaar.
2

Claim het verzoek

Klik op Claimen in het wachtende gesprek.

Verwacht resultaat: Andere agenten kunnen zien dat het gesprek actief wordt afgehandeld.
3

Lees de context

Open berichten en bezoekersgegevens voordat u antwoordt.

Verwacht resultaat: De agent begrijpt waarom de overdracht heeft plaatsgevonden.
4

Stuur het menselijke antwoord

Reageer duidelijk en houd de draad up-to-date.

Verwacht resultaat: De bezoeker krijgt een menselijk antwoord.
5

Indien nodig teruggeven aan AI

Gebruik de hand terug wanneer het probleem is beantwoord en de AI verder kan gaan.

Verwacht resultaat: AI hervat het gesprek.
6

Oplossen als u klaar bent

Klik op Oplossen nadat de bezoeker geen hulp meer nodig heeft.

Verwacht resultaat: De overdracht wordt gesloten en verwijderd uit de actieve wachtrij.
Hoe het te testen: Maak een testoverdracht, claim deze, antwoord één keer, geef hem terug en bevestig de statuswijzigingen in Live Support en Chat History.
ProbleemRepareren
Agenten missen verzoekenSchakel browser-/e-mail-/pushmeldingen in en voeg een proces toe voor wachtrij-eigendom.
AI neemt het steeds te snel overPas de instructies en overdrachtsregels aan, zodat de menselijke controle actief blijft totdat deze wordt opgelost of teruggegeven.
Externe CRM is niet gesynchroniseerdGebruik webhooks of polls uit de sectie Recepten voor ontwikkelaars.

Wat u nu moet doen: Verbind CRM/webhooks als ondersteuningsteams buiten sem.chat werken.

Geschiedenis en contacten

Zoek, exporteer en gebruik gespreks-/contactgegevens

Waar dit voor is: Gebruik dit voor audits, leadbeoordeling, CSV export en SendPulse synchronisatie.

Voordat je begint
  • Bepaal of je conversations, contacten of beide nodig hebt.
  • Pas het juiste datumbereik toe voordat u exporteert.
  • Exporteer niet meer persoonlijke gegevens dan nodig is.
1

Open Chat History

Klik op Chat History in de zijbalk.

Verwacht resultaat: Gespreksfilters, statistieken en de transcriptielijst zijn zichtbaar.
2

Zoek en filter

Filter op bot, kanaal, modus, bezoeker of datumbereik.

Verwacht resultaat: Alleen overeenkomende conversations blijven zichtbaar.
3

Open een transcriptie

Klik op een gesprek om de volledige berichtenthread te lezen.

Verwacht resultaat: De volledige context, contactgegevens en metadata van gesprekken zijn zichtbaar.
4

Exporteer conversations

Klik op Exporteren en kies het gewenste formaat, indien beschikbaar.

Verwacht resultaat: De export bevat de gefilterde gespreksgegevens.
5

Contacten openen

Klik op Contacten in de zijbalk.

Verwacht resultaat: Lead-/contactrecords verschijnen met bron, bot en status.
6

Filter en exporteer contacten

Zoek contacten, selecteer de gewenste records en exporteer of synchroniseer vervolgens naar SendPulse.

Verwacht resultaat: De geselecteerde contacten zijn beschikbaar buiten sem.chat volgens de gekozen actie.
Hoe het te testen: Exporteer een kleine gefilterde CSV en open deze lokaal om te bevestigen dat de kolommen en het datumbereik correct zijn.
ProbleemRepareren
Contact ontbreekt in ContactenBevestig dat het vastleggen van leads is ingeschakeld en dat de bezoeker het formulier heeft verzonden.
De export is te grootBeperk het datumbereik of botfilter voordat u exporteert.
SendPulse synchronisatie niet beschikbaarVerbind eerst SendPulse in Integraties en ga dan terug naar Contacten.

Wat u nu moet doen: Bekijk Analytics om prestatietrends te begrijpen nadat de bewerkingen zijn uitgevoerd.

08

Kanalen en integraties

Verbind Slack, Facebook, Instagram, WhatsApp, Telegram via BotFather, handmatige inloggegevens, alternatieve chat links, SendPulse en CRM integraties.

/integratiesKanalen, CRM en e-mailverbindingen
Echte screenshot van de sem.chat-demo-werkruimte
1Kies het kanaal of de CRM integratiekaart.
2Volg OAuth- of referentiestappen voor elke provider.
3Ontkoppel of test integraties opnieuw vanaf dezelfde pagina.
Kanalen verbinden

Sluit een berichtenkanaal of CRM integratie aan

Waar dit voor is: Gebruik dit wanneer sem.chat conversations buiten de websitewidget moet ontvangen of contacten naar andere tools moet sturen.

Voordat je begint
  • Zorg voor beheerderstoegang tot het externe platform.
  • Weet welke bot kanaalberichten moet ontvangen.
  • Gebruik testkanalen voordat u productieaccounts koppelt.
1

Open integraties

Klik op Integraties in de zijbalk.

Verwacht resultaat: Beschikbare kanalen, CRM tools, SendPulse en websitewidgetopties zijn zichtbaar.
2

Kies de integratie

Klik op Verbinden op Slack, Metakanalen, Telegram, SendPulse, CRM of handmatige inloggegevens.

Verwacht resultaat: Het installatiedialoogvenster of de OAuth-stroom wordt geopend.
3

Volledige providerconfiguratie

Voor OAuth-kanalen keurt u de gevraagde machtigingen goed. Voor handmatige kanalen plakt u het vereiste token, geheim, account-ID of webhook URL.

Verwacht resultaat: sem.chat slaat de verbinding op en toont de integratie als verbonden.
4

Wijs de bot toe

Kies welke bot berichten van dat kanaal moet afhandelen wanneer het dialoogvenster daarom vraagt.

Verwacht resultaat: Inkomende berichten worden doorgestuurd naar de juiste assistent.
5

Test het kanaal

Stuur een testbericht vanaf het externe kanaal.

Verwacht resultaat: Het bericht verschijnt in Inbox of Chat History onder het juiste kanaal.
6

Ontkoppel indien nodig

Gebruik Verbinding met de integratiekaart verbreken wanneer het kanaal moet stoppen.

Verwacht resultaat: sem.chat stopt met het ontvangen of verzenden via die integratie.
Hoe het te testen: Stuur één testbericht via het verbonden kanaal en bevestig het botantwoord, de Inbox-rij en het geschiedenisrecord.
ProbleemRepareren
Telegram-token misluktMaak of reset het token in BotFather en plak het opnieuw.
Slack berichten komen niet aanControleer het bereik van de app, gebeurtenisabonnement URL, bottoken, ondertekeningsgeheim en kanaallidmaatschap.
Metakanaalverbinding misluktBevestig dat het Facebook/Instagram/WhatsApp account beheerdersrechten heeft en vereiste zakelijke toegang.
SendPulse synchronisatie misluktMaak opnieuw verbinding met SendPulse en bevestig dat de contactvelden zijn toegewezen.

Wat u nu moet doen: Documenteer het kanaaleigendom voor het team en controleer Inbox na de lancering.

09

Planning

Maak gebeurtenistypen aan, configureer beschikbaarheid, koppel kalenders, beheer boekingen, maak eenmalige links, configureer boekings-e-mails, bekijk analyses, stel betaalde evenementen in en test openbare boekingslinks.

/planningWerkruimte plannen
Echte screenshot van de sem.chat-demo-werkruimte
1Gebruik tabbladen voor gebeurtenistypen, boekingen, analyses, eenmalige links, agenda's, e-mails en instellingen.
2Gebeurtenistypen bewerken, kopiëren, insluiten, activeren of onderbreken.
3Kopieer de openbare link en voer een privéboekingstest uit.
EvenementredacteurConfiguratie van gebeurtenistype
Echte screenshot van de sem.chat-demo-werkruimte
1Voer naam, beschrijving, duur, locatie en buffers in.
2Stel de beschikbaarheid, boekingsperioden, vragen, opties voor betaalde evenementen en annuleringsregels in.
3Sla het evenement op voordat u de link deelt.
/book/:gebruikersnaam/:eventSlugOpenbare boekingspagina
Echte screenshot van de sem.chat-demo-werkruimte
1Bezoekers kiezen een datum op de openbare boekingspagina.
2Bezoekers kiezen een beschikbaar tijdslot.
3Bezoekers bevestigen de boeking en ontvangen bevestigingsmails.
Type evenement

Maak een evenementtype aan en publiceer een boekingslink

Waar dit voor is: Gebruik dit wanneer bezoekers demo's, consultaties, verkoopgesprekken, onboarding of ondersteuningssessies moeten boeken.

Voordat je begint
  • Kies de naam, de duur, het type vergadering en de eigenaar van het evenement.
  • Stel de tijdzone en beschikbaarheid in voordat u links deelt.
  • Verbind kalenders als dubbele boeking belangrijk is.
1

Planning openen

Klik op Plannen in de zijbalk.

Verwacht resultaat: De planningswerkruimte toont tabbladen voor gebeurtenistypen, boekingen, analyses, eenmalige links, agenda's, e-mails en instellingen.
2

Maak een gebeurtenistype

Klik op Maken en voeg vervolgens naam, beschrijving, duur, locatie, buffer en boekingsregels toe.

Verwacht resultaat: Het evenement heeft voldoende openbare informatie zodat bezoekers het kunnen begrijpen.
3

Beschikbaarheid instellen

Configureer wekelijkse uren, datumoverschrijvingen, kennisgevingsperioden en boekingsperiode.

Verwacht resultaat: Bezoekers zien alleen tijden die u bereid bent aan te bieden.
4

Voeg vragen toe

Voeg de vereiste vragen toe, zoals telefoon, bedrijf, website of vergaderdoel.

Verwacht resultaat: Boekingen verzamelen de context die uw team nodig heeft vóór het gesprek.
5

Verbind kalenders

Open Agenda's en maak verbinding met Google, Outlook of iCal, indien beschikbaar.

Verwacht resultaat: Drukke tijden kunnen worden geblokkeerd en bevestigde boekingen kunnen naar de kalender worden geschreven.
6

Stel e-mails en herinneringen in

Open e-mails en configureer berichten voor bevestiging, herinnering, annulering en opnieuw plannen.

Verwacht resultaat: Bezoekers ontvangen correcte boekingscommunicatie.
7

Deel en test de openbare link

Kopieer de evenementlink, open deze in een privévenster, kies een tijdslot en voltooi een testboeking.

Verwacht resultaat: De boeking verschijnt op het tabblad Boekingen en er worden bevestigingsberichten verzonden.
Hoe het te testen: Voltooi één testboeking, één herschikking en één annulering. Bevestig dat elke gebeurtenis wordt weergegeven in Planning en gekoppelde agenda's.
ProbleemRepareren
Er verschijnen geen tijden op de openbare paginaControleer de tijdzone, wekelijkse beschikbaarheid, datumoverschrijvingen, kennisgevingsvenster en verbonden kalenderconflicten.
Boekings-e-mail ontbreektControleer de e-mailinstellingen en de spammap en stuur vervolgens nog een testboeking.
Betaling mislukt bij betaald evenementBevestig dat de instellingen voor facturerings-/betalingsintegratie en de valuta geldig zijn voordat u deze publiceert.

Wat u nu moet doen: Sluit boekingslinks in de bot, website of vervolg-e-mails in.

Geavanceerde planning

Gebruik eenmalige links, analyses, insluitingen en betaalde evenementen

Waar dit voor is: Gebruik dit wanneer de planning tijdelijke beschikbaarheid, rapportage, geïntegreerde boeking of betaling vereist.

Voordat je begint
  • Maak eerst minimaal één gebeurtenistype aan.
  • Verbind agenda's voordat u eenmalige koppelingen intensief gebruikt.
  • Definieer het restitutie-/annuleringsbeleid voordat u betaalde evenementen inschakelt.
1

Maak een eenmalige koppeling

Open eenmalige links, selecteer de aangeboden slots of regels en genereer vervolgens de link.

Verwacht resultaat: De ontvanger kan alleen boeken vanaf de geselecteerde beschikbaarheid.
2

Planning insluiten

Gebruik de optie voor het insluiten van evenementenkaarten als het boekingsproces op uw website moet verschijnen.

Verwacht resultaat: De boekingsinterface kan op de pagina worden geplaatst waar bezoekers converteren.
3

Bekijk planningsanalyses

Open Analytics binnen Planning.

Verwacht resultaat: U kunt boekingen, voltooiingstrends en prestaties van het gebeurtenistype bekijken.
4

Schakel betaalde evenementen in

Open de evenementeditor en stel de prijs, valuta en betalingsgedrag in.

Verwacht resultaat: Bezoekers moeten de betalingsstap voltooien volgens de evenementopstelling.
5

Boekingen controleren

Open Boekingen en bekijk komende, voltooide, geannuleerde en opnieuw geplande boekingen.

Verwacht resultaat: Het team kan de aanwezigheid en opvolging beheren.
Hoe het te testen: Boek via de openbare pagina en via een ingesloten pagina, indien gebruikt. Bevestig dat beide hetzelfde type boekingsrecord maken.
ProbleemRepareren
Eenmalige link legt verkeerde slots blootGenereer de link opnieuw met een kleinere slotset of een strikter datumbereik.
Ingebedde boeking is te beperktPlaats de insluiting in een bredere inhoudscontainer en controleer de mobiele lay-out.
Analytics zien er leeg uitMaak of wacht op echte boekingen; analyses zijn afhankelijk van boekingsgegevens.

Wat u nu moet doen: Koppel planningsresultaten aan rapporten en analyses.

10

Analyses en rapporten

Kies datumbereiken, gebruik aangepaste datums, lees kernstatistieken, exporteer CSV, bekijk tevredenheids- en gesprekstrends, configureer e-mailrapporten en verifieer de bezorging.

/analyseAnalytics-dashboard
Echte screenshot van de sem.chat-demo-werkruimte
1Kies datumbereiken of aangepaste datums.
2Lees gespreks-, tevredenheids-, taal-, kanaal- en conversiestatistieken.
3Exporteer CSV voor offline analyse.
Instellingen / RapportenE-mailrapport instellen
Echte screenshot van de sem.chat-demo-werkruimte
1Kies de dagelijkse, wekelijkse of maandelijkse rapportcadans.
2Rapportontvangers toevoegen.
3Stuur direct een rapport om de levering te testen.
Analytics-beoordeling

Analyses lezen en prestatiegegevens exporteren

Waar dit voor is: Gebruik dit voor wekelijkse beoordelingen, lanceringscontroles, ondersteuningskwaliteitsbeoordelingen en conversieanalyses.

Voordat je begint
  • Kies het datumbereik voordat u de statistieken leest.
  • Weet welke bot of kanaal je evalueert.
  • Sluit privétestdata uit bij het rapporteren van productieprestaties.
1

Analytics openen

Klik op Analytics in de zijbalk.

Verwacht resultaat: Dashboardstatistieken en grafiekpanelen zijn zichtbaar.
2

Kies een datumbereik

Selecteer vandaag, 7 dagen, 30 dagen of aangepaste datums.

Verwacht resultaat: Alle grafieken worden bijgewerkt naar de geselecteerde periode.
3

Lees kernstatistieken

Bekijk conversations, belminuten, tevredenheid, conversie en kanaalmix.

Verwacht resultaat: Je begrijpt het volume en de kwaliteit van klantinteracties.
4

Beoordeel trends

Kijk naar gesprekstrends, tevredenheidsveranderingen, belangrijkste vragen en taal-/kanaalpatronen.

Verwacht resultaat: U kunt identificeren waar u botinstructies of personeelsbezetting kunt verbeteren.
5

Exporteer CSV

Gebruik Export CSV wanneer het team spreadsheetanalyse nodig heeft.

Verwacht resultaat: De CSV bevat het geselecteerde datumbereik en de statistieken.
6

Zet bevindingen om in veranderingen

Update botinstructies, kennis, widgetinstellingen of ondersteuningsdekking op basis van de gegevens.

Verwacht resultaat: Analytics leidt tot concrete productverbeteringen.
Hoe het te testen: Exporteer een kleine aangepaste datum CSV en controleer of het datumbereik en de statistieken overeenkomen met wat het dashboard laat zien.
ProbleemRepareren
De statistieken lijken te hoogControleer of enscenering/test conversations in het geselecteerde datumbereik valt.
Tevredenheid is leegSchakel beoordelingen in Widget-instellingen in en wacht tot bezoekers beoordelingen achterlaten.
Spraakminuten komen niet overeen met de verwachtingenBevestig dat de spraakmodus alleen is ingeschakeld op de beoogde bots.

Wat u nu moet doen: Plan e-mailrapporten voor terugkerende zichtbaarheid.

Rapporten

Configureer terugkerende e-mailrapporten en testbezorging

Waar dit voor is: Gebruik dit wanneer eigenaren, managers of klanten automatische prestatieoverzichten nodig hebben.

Voordat je begint
  • Bepaal wie rapporten moet ontvangen.
  • Gebruik geverifieerde e-mailadressen.
  • Kies een cadans die past bij het ritme van bedrijfsbeoordelingen.
1

Open Instellingen en vervolgens Rapporten

Ga naar Instellingen en selecteer het tabblad Rapporten, of gebruik de Rapportenomleiding, indien beschikbaar.

Verwacht resultaat: Rapportcadans, ontvangers en geschiedenis zijn zichtbaar.
2

Kies cadans

Schakel dagelijkse, wekelijkse of maandelijkse rapporten in.

Verwacht resultaat: Het rapportschema wordt opgeslagen voor de werkruimte.
3

Ontvangers toevoegen

Voer de e-mailadressen in die rapporten moeten ontvangen.

Verwacht resultaat: Rapportages worden naar de juiste stakeholders gestuurd.
4

Verzend direct een rapport

Klik op Nu verzenden of een gelijkwaardige directe rapportactie.

Verwacht resultaat: Er wordt onmiddellijk een rapport-e-mail verzonden ter verificatie.
5

Bekijk de rapportgeschiedenis

Controleer het geschiedenispaneel nadat rapporten zijn verzonden.

Verwacht resultaat: U kunt de bezorgstatus en -tijd bevestigen.
Hoe het te testen: Stuur direct een rapport naar een testontvanger en bevestig ontvangst en opmaak.
ProbleemRepareren
Rapport-e-mail komt niet aanControleer de spelling van de ontvanger, de spammap en de rapportgeschiedenisstatus.
Verkeerde mensen ontvangen meldingenUpdate ontvangers en sla op vóór de volgende geplande verzending.
De inhoud van het rapport voelt luidruchtig aanPas de verwachtingen voor de periode aan en gebruik Analytics voor diepgaandere handmatige beoordeling.

Wat u nu moet doen: Gebruik de rapportcadans als werkritme voor botverbeteringen.

11

Facturering, Team, Beveiliging, Instellingen, Partner

Start of upgrade plannen, beheer het facturatieportaal, nodig teamgenoten uit, stel rollen in, bewerk profiel/taal, configureer meldingen, schakel 2FA in, gebruik gevarenzone-acties en voer de affiliate-workflow uit.

/factureringPlan- en facturatiecontroles
Echte screenshot van de sem.chat-demo-werkruimte
1Bekijk het huidige abonnement, de proefstatus en de usage-limieten.
2Vergelijk abonnementsfuncties voordat u upgradet.
3Open het facturatieportaal voor facturen, betaalmethoden, annulering of reactivering.
/instellingenInstellingen, team en beveiliging
Echte screenshot van de sem.chat-demo-werkruimte
1Gebruik Algemeen voor profiel en taal.
2Gebruik Team voor uitnodigingen en rollen.
3Gebruik beveiliging voor 2FA, API sleutels en acties in gevarenzones.
/ aangeslotenAffiliate programmacontroles
Echte screenshot van de sem.chat-demo-werkruimte
1Sluit u aan bij het programma om een verwijzingslink te maken.
2Kopieer de verwijzingslink voor campagnes.
3Stel een uitbetalings-e-mailadres in en vraag in aanmerking komende uitbetalingen aan.
Facturering

Een abonnement starten, upgraden, annuleren of opnieuw activeren

Waar dit voor is: Gebruik dit wanneer de werkruimte proefactivatie, meer limieten, facturen, betalingsupdates of abonnementswijzigingen nodig heeft.

Voordat je begint
  • De accounteigenaar of factureringsbeheerder moet factureringsacties uitvoeren.
  • Bevestig welke functies planafhankelijk zijn: stem, gekloonde stemmen, aangepaste avatars, API, team, CRM en kanalen.
  • Gebruik het beveiligde facturatieportaal voor betalingsmethode- en factuurwijzigingen.
1

Facturering openen

Klik op Facturering in de zijbalk.

Verwacht resultaat: Huidig abonnement, proefstatus, usage limieten en abonnementskaarten zijn zichtbaar.
2

Vergelijk abonnementen

Bekijk chat, stem, team, API, avatar, integratie, planning en ondersteuningslimieten.

Verwacht resultaat: U weet welk abonnement de benodigde functie ontgrendelt.
3

Kies factureringsinterval

Selecteer maandelijks of jaarlijks als de schakelaar beschikbaar is.

Verwacht resultaat: Prijzen en besparingen worden bijgewerkt voor het geselecteerde interval.
4

Upgrade of start het afrekenen

Kies het gewenste abonnement en voltooi het afrekenen.

Verwacht resultaat: Het abonnement wordt actief na bevestiging van de betaling.
5

Klantenportaal openen

Gebruik het facturatieportaal voor betaalmethode, facturen, annulering of reactivering.

Verwacht resultaat: Gevoelige factureringsacties vinden plaats in het beveiligde providerportaal.
6

Functietoegang verifiëren

Keer terug naar de functie die vergrendeld was en laad de app opnieuw.

Verwacht resultaat: De ontgrendelde functie is nu beschikbaar als het abonnement deze bevat.
Hoe het te testen: Open na het upgraden de eerder vergrendelde functie, zoals spraakkloon of API-toetsen, en bevestig dat de vergrendeling verdwenen is.
ProbleemRepareren
Functie blijft vergrendeld na de upgradeVernieuw de app, wacht even tot het abonnement is gesynchroniseerd en controleer vervolgens opnieuw Facturering.
Het afrekenen is geannuleerdGa terug naar Facturering en begin opnieuw met afrekenen; Er vinden geen planwijzigingen plaats na een geannuleerde check-out.
Factuur- of kaartwissel nodigOpen het klantportaal in plaats van de betalingsgegevens in de app te bewerken.

Wat u nu moet doen: Nodig teamgenoten uit en beveilig het eigenaarsaccount.

Team en veiligheid

Nodig teamgenoten uit, stel rollen in, bewerk profiel, schakel 2FA in en beheer instellingen

Waar dit voor is: Gebruik dit wanneer de werkruimte van solo-opstelling naar teamwerking gaat.

Voordat je begint
  • Ken de rol van elke teamgenoot voordat u uitnodigingen verzendt.
  • Gebruik toegang met de minste rechten: Eigenaar, Beheerder, Editor, Viewer.
  • Zorg dat er een authenticator-app gereed is voor 2FA.
1

Instellingen openen

Klik op Instellingen in de zijbalk.

Verwacht resultaat: Algemeen, meldingen, team, rapporten, ontwikkelaars, beveiliging en gerelateerde tabbladen zijn zichtbaar.
2

Profiel en taal bewerken

Update de weergavenaam, profielinformatie en voorkeurstaal in Algemeen.

Verwacht resultaat: De app identificeert de gebruiker correct en gebruikt, indien beschikbaar, de gekozen taal.
3

Nodig teamleden uit

Open Team, voer een e-mailadres in, kies een rol en verstuur de uitnodiging.

Verwacht resultaat: De teamgenoot ontvangt een uitnodigingslink en wordt weergegeven als in behandeling totdat deze wordt geaccepteerd.
4

Stel rolmachtigingen in

Gebruik Eigenaar voor volledige controle, Beheerder voor beheer, Editor voor inhoudswijzigingen en Viewer voor alleen-lezen toegang.

Verwacht resultaat: Elke gebruiker heeft toegang die past bij zijn verantwoordelijkheid.
5

Configureer meldingen

Kies voor e-mail-, browser-, push-, live-ondersteuning, facturering en rapportmeldingen.

Verwacht resultaat: De juiste mensen krijgen waarschuwingen zonder onnodige ruis.
6

Schakel 2FA in

Open Beveiliging, schakel tweefactorauthenticatie in, scan de code en sla herstelgegevens op.

Verwacht resultaat: Het account vereist een tweede factor na het inloggen met een wachtwoord.
7

Maak zorgvuldig gebruik van acties in de gevarenzone

Exporteer de benodigde gegevens en bevestig actieve widgets/integraties vóór destructieve accountacties.

Verwacht resultaat: De werkruimte voorkomt onbedoeld gegevensverlies.
Hoe het te testen: Nodig een testteamgenoot uit, accepteer de uitnodiging in een aparte browser en bevestig dat de rol alleen de beoogde functies blootlegt.
ProbleemRepareren
E-mailadres voor uitnodiging ontbreektControleer de spam, verzend de uitnodiging opnieuw en verifieer het adres.
Teamgenoot ziet te veelVerlaag hun rol en bekijk de instellingen voor bottoegang.
2FA-installatie misluktControleer de apparaattijd, scan de QR-code opnieuw en sla herstelgegevens op voordat u erop vertrouwt.

Wat u nu moet doen: Configureer API sleutels alleen voor gebruikers en services die deze nodig hebben.

Partner

Sluit u aan bij een partner, kopieer de verwijzingslink, stel het uitbetalings-e-mailadres in en vraag uitbetaling aan

Waar dit voor is: Gebruik dit wanneer een partner of klant nieuwe sem.chat gebruikers wil doorverwijzen en de commissie-activiteit wil volgen.

Voordat je begint
  • Gebruik het account dat de verwijzingsattributie moet bezitten.
  • Bereid de uitbetalings-e-mail voor voordat u uitbetaling aanvraagt.
  • Controleer de programmaregels voordat u verwijzingscampagnes publiceert.
1

Partner openen

Klik op Affiliate in de zijbalk of open het affiliate-tabblad vanuit Instellingen als daar naartoe is gelinkt.

Verwacht resultaat: De pagina van het partnerprogramma toont de gebieden deelname, verwijzing, uitbetaling en geschiedenis.
2

Doe mee aan het programma

Klik op Deelnemen als het account nog niet is aangemeld.

Verwacht resultaat: Er worden een verwijzingscode en een verwijzingslink aangemaakt.
3

Kopieer de verwijzingslink

Kopieer de unieke link en gebruik deze in content, campagnes of partnerberichten.

Verwacht resultaat: Aanmeldingen via de link kunnen worden toegeschreven aan het affiliate-account.
4

Uitbetalings-e-mailadres instellen

Voer de uitbetalings-e-mail in en sla deze op.

Verwacht resultaat: In aanmerking komende uitbetalingen kunnen correct worden gerouteerd.
5

Beoordeel verwijzingen en commissies

Controleer de verwijzingslijst, commissiestatus en uitbetalingsgeschiedenis.

Verwacht resultaat: U weet wat er in behandeling is, in aanmerking komt of al is betaald.
6

Uitbetaling aanvragen

Klik op Uitbetaling aanvragen wanneer aan de programmaregels en minima is voldaan.

Verwacht resultaat: Het uitbetalingsverzoek wordt geregistreerd voor verwerking.
Hoe het te testen: Open de verwijzingslink in een privébrowser en bevestig dat deze op de verwachte aanmeldingsstroom terechtkomt met verwijzingstracking.
ProbleemRepareren
Verwijzingslink ontbreektSluit u eerst aan bij het programma of vernieuw de partnerpagina nadat u lid bent geworden.
Uitbetalingsverzoek niet beschikbaarControleer de minimale uitbetalingsdrempel, de in aanmerking komende commissiestatus en de uitbetalings-e-mail.
Verwijzing niet toegeschrevenControleer of de bezoeker de exacte verwijzingslink heeft gebruikt en de trackingparameters niet heeft verwijderd.

Wat u nu moet doen: Gebruik analyses en rapporten om de impact van doorverwezen klanten te monitoren, indien van toepassing.

12

Meldingen en App Updates

Bekijk waarschuwingen, markeer meldingen als gelezen, filter belangrijke gebeurtenissen en gebruik app-updates om nieuwe productwijzigingen te begrijpen.

/meldingenMeldingscentrum
Echte screenshot van de sem.chat-demo-werkruimte
1Gebruik Markeer alles als gelezen na het bekijken van ongelezen waarschuwingen.
2Filter op ongelezen, facturering, live ondersteuning of systeemgebeurtenissen.
3Open de gerelateerde functie na het lezen van de waarschuwing.
/app-updatesFeed voor app-updates
Echte screenshot van de sem.chat-demo-werkruimte
1Lees de releaseopmerkingen voor nieuwe functies en oplossingen.
2Gebruik details om teamgenoten te trainen voordat de workflow verandert.
3Controleer updates nadat u veranderingen in de gebruikersinterface of gedrag heeft opgemerkt.
Meldingen

Bekijk meldingen en handel naar aanleiding van waarschuwingen

Waar dit voor is: Gebruik dit wanneer de app overdrachten, factureringsstatus, systeemgebeurtenissen, levering van rapporten of belangrijke activiteiten in de werkruimte rapporteert.

Voordat je begint
  • Zorg ervoor dat de meldingsvoorkeuren zijn ingesteld in Instellingen.
  • Zorg voor live ondersteuning als overdrachtswaarschuwingen zijn ingeschakeld.
  • Bekijk ongelezen waarschuwingen voordat u ze als gelezen markeert.
1

Meldingen openen

Klik op Meldingen in de zijbalk of in het meldingsitem in de app-koptekst.

Verwacht resultaat: Het meldingscentrum vermeldt recente waarschuwingen.
2

Filter waarschuwingen

Gebruik ongelezen of categoriefilters om u te concentreren op facturering, live ondersteuning, bot-, rapport- of systeemgebeurtenissen.

Verwacht resultaat: Alleen overeenkomende waarschuwingen blijven zichtbaar.
3

Open de gerelateerde pagina

Klik op de waarschuwing of gebruik de context ervan om Facturering, Live Support, Rapporten of de relevante bot te openen.

Verwacht resultaat: U handelt op basis van de melding in plaats van deze alleen maar te lezen.
4

Markeer gelezen

Markeer een enkele waarschuwing als gelezen of gebruik Markeer alles als gelezen na beoordeling.

Verwacht resultaat: Het aantal ongelezen berichten daalt en beoordeelde items worden niet langer gemarkeerd.
5

Pas voorkeuren aan

Open Instellingen, Meldingen als er te veel of te weinig waarschuwingen binnenkomen.

Verwacht resultaat: De meldingenstroom komt overeen met de teambehoeften.
Hoe het te testen: Creëer een veilige testgebeurtenis, zoals een live-ondersteuningsverzoek of direct rapport, en bevestig vervolgens dat de melding verschijnt en als gelezen kan worden gemarkeerd.
ProbleemRepareren
Er komt geen melding binnenControleer de instellingen voor meldingsvoorkeuren, browsertoestemming en of de gebeurtenis daadwerkelijk heeft plaatsgevonden.
Te veel waarschuwingenSchakel luidruchtige categorieën uit of stuur ze alleen naar de verantwoordelijke teamleden.
Het aantal ongelezen berichten lijkt vast te zittenVernieuw de app nadat u alle gelezen items hebt gemarkeerd en bevestig dat filters ongelezen items niet verbergen.

Wat u nu moet doen: Bekijk App Updates wanneer gedrag verandert of er nieuwe bedieningselementen verschijnen.

App-updates

Gebruik app-updates om productwijzigingen te begrijpen

Waar dit voor is: Gebruik dit wanneer teamgenoten moeten weten wat er is veranderd voordat ze een nieuwe functie kunnen gebruiken.

Voordat je begint
  • Open updates na grote releases of wanneer de gebruikersinterface verandert.
  • Deel relevante update-opmerkingen met ondersteunings- en verkoopgebruikers.
  • Test kritieke workflows opnieuw na grote wijzigingen.
1

Open App Updates

Klik op App Updates in de zijbalk.

Verwacht resultaat: De updatefeed toont nieuwe functies, oplossingen en release-opmerkingen.
2

Lees de laatste update

Open de meest recente updatekaart of detailweergave.

Verwacht resultaat: Je ziet wat er is veranderd en op welke workflow dit van invloed is.
3

Breng de verandering in kaart in uw workflow

Bepaal of de update gevolgen heeft voor bots, widgets, ondersteuning, planning, facturering of ontwikkelaars.

Verwacht resultaat: De juiste teamleden weten wat ze moeten controleren.
4

Test kritieke paden opnieuw

Als de update een productieworkflow beïnvloedt, herhaal dan de relevante handmatige stappen uit deze documentatie.

Verwacht resultaat: Het team bevestigt dat de gewijzigde workflow nog steeds werkt.
5

Deel intern

Stuur het updateoverzicht naar gebruikers die eigenaar zijn van het getroffen gebied.

Verwacht resultaat: De adoptie door teams verloopt soepeler en het aantal ondersteuningsvragen neemt af.
Hoe het te testen: Herhaal na een relevante update de handleiding voor de betreffende functie en controleer of de schermafbeeldingen of stapnamen nog steeds overeenkomen.
ProbleemRepareren
Update vermeldt een vergrendelde functieOpen Facturering om te bevestigen of dit in het huidige abonnement is inbegrepen.
Team miste een wisselVoeg App Updates beoordeling toe aan release- of wekelijkse bewerkingsroutines.
Documentatie ziet er oud uit na een updateGebruik de Engineer Guide om schermafbeeldingen en stappen bij te werken.

Wat u nu moet doen: Houd de openbare documentatie actueel naarmate de functies zich ontwikkelen.

13

Recepten voor ontwikkelaars

Genereer API sleutels, gebruik x-api-key authenticatie, roep op actie gebaseerde eindpunten aan, overbrug live ondersteuning naar een CRM, registreer webhooks, verifieer handtekeningen en sluit de widget in code in.

Instellingen / OntwikkelaarsAPI toetsen, snelstart en usage tabbladen
Echte screenshot van de sem.chat-demo-werkruimte
1Genereer en trek API sleutels in op het tabblad API Sleutels.
2Gebruik Quick Start voor voorbeelden van eerste krullen.
3Controleer het gebruik voordat u automatisering van grote volumes inschakelt.
API snelle start

Genereer een API sleutel en voer de eerste API oproepen uit

Waar dit voor is: Gebruik dit voor rapportagescripts, apps op maat, CRM bridges, externe live-ondersteuning of automatisering.

Voordat je begint
  • Gebruik een server-side omgeving. Stel de API-sleutels niet beschikbaar in browser JavaScript.
  • Genereer voor elke integratie een aparte sleutel.
  • Kopieer de sleutel meteen, want geheimen worden één keer getoond.
1

Open ontwikkelaars

Open Instellingen en selecteer Ontwikkelaars, of gebruik de ontwikkelaarsomleiding, indien beschikbaar.

Verwacht resultaat: De tabbladen API Sleutels, Quick Start, Documentatie en Gebruik zijn zichtbaar.
2

Genereer een sleutel

Klik op Sleutel genereren, geef deze een duidelijk label en kopieer deze onmiddellijk.

Verwacht resultaat: De sleutel begint met sk_live_ en is beschikbaar voor verzoeken aan de serverzijde.
3

Verzend x-api-key koptekst

Voeg x-api-key toe aan elk openbaar API verzoek.

Verwacht resultaat: De openbare API kan het verzoek verifiëren en doorgeven aan de eigenaar.
4

Maak een lijst van bots

Roep actie=list-bots aan om de bot-ID te vinden die u nodig heeft.

Verwacht resultaat: Het antwoord retourneert bot-ID's, namen, actieve status en configuratieoverzicht.
5

Stuur een chat bericht

POST actie chat met botId en bericht.

Verwacht resultaat: Het antwoord retourneert antwoord-, model- en usage-informatie.
6

Controleer usage

Roep action=usage op voordat u taken met een hoog volume uitvoert.

Verwacht resultaat: U kent het huidige plan en de status usage voordat de automatisering wordt uitgevoerd.
7

Draai toetsen wanneer dat nodig is

Trek ongebruikte sleutels in en genereer nieuwe voor gewijzigde leveranciers of services.

Verwacht resultaat: Oude services kunnen geen verouderde inloggegevens blijven gebruiken.
Hoe het te testen: Voer list-bots en chat uit vanaf een lokale terminal of serveromgeving en bevestig vervolgens dat het gesprek verschijnt in Chat History als chat is verzonden.
ProbleemRepareren
401 of ongeautoriseerde reactieControleer de spelling van x-api-key, kopieer de volledige sleutel en bevestig dat deze niet is ingetrokken.
Bot niet gevondenGebruik list-bots opnieuw en bevestig dat de bot toebehoort aan de sleuteleigenaar van API.
Browser CORS-probleemVerplaats de API-aanroep naar uw backend; API sleutels zijn bedoeld voor gebruik op de server.

Wat u nu moet doen: Gebruik /api-docs voor gerichte eindpuntreferentie en bewaar deze pagina als workflowbegeleiding.

Maak een lijst van bots
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
Stuur een chat bericht
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
Live-ondersteuning CRM bridge

Poll of push live-ondersteuningsverzoeken naar een CRM

Waar dit voor is: Gebruik dit wanneer agenten in een ander systeem werken, maar sem.chat het bezoekersgesprek ontvangt.

Voordat je begint
  • Maak een speciale API sleutel met de naam voor de CRM bridge.
  • Bepaal of polling of webhooks bij uw infrastructuur passen.
  • Zorg ervoor dat de CRM gespreks-ID's opslaat voor toekomstige antwoorden/oplossing.
1

Maak een lijst van wachtende overdrachten

GET actie=live-support-list met status=aangevraagd of status=alles.

Verwacht resultaat: De CRM ontvangt open conversations die menselijke aandacht vereist.
2

Berichten ophalen

GET actie=live-support-messages met conversationId.

Verwacht resultaat: De CRM heeft de volledige threadcontext en bezoekersgegevens.
3

Claim voordat u antwoordt

POST actie=live-support-claim.

Verwacht resultaat: sem.chat markeert het gesprek als actief afgehandeld.
4

Antwoord van agent verzenden

POST actie=live-support-reply met conversationId, bericht en agentnaam.

Verwacht resultaat: De bezoeker ontvangt het menselijke antwoord en de thread-updates.
5

Oplossen of teruggeven

POST actie=live-support-resolve met resolutie, besluit of teruggave.

Verwacht resultaat: Het gesprek verlaat de wachtrij of AI hervat de controle.
6

Logstatus in CRM

Bewaar de laatste overdrachtsstatus, bericht-ID en tijdstempels.

Verwacht resultaat: CRM en sem.chat blijven controleerbaar.
Hoe het te testen: Creëer een veilige overdracht, spiegel deze naar de CRM, antwoord vanaf de bridge en bevestig de updates van de bezoekersthread.
ProbleemRepareren
Dubbele CRM ticketsGebruik conversationId als de idempotency-sleutel in uw CRM-bridge.
De antwoorden komen in de verkeerde volgorde binnenBewaar berichttijdstempels en vermijd gelijktijdige antwoorden van meerdere systemen.
AI antwoordt terwijl de agent werktClaim eerst de overdracht en geef deze pas terug als de agent klaar is.

Wat u nu moet doen: Registreer webhooks als pollen te langzaam of te duur is.

Webhaken

Registreer webhooks en verifieer X-SemChat-Signature

Waar dit voor is: Gebruik dit wanneer uw systeem realtime gebeurtenissen nodig heeft voor overdrachten, berichten en resolutie-updates.

Voordat je begint
  • Webhook URL moet HTTPS zijn en bereikbaar vanaf het openbare internet.
  • Bewaar het webhookgeheim onmiddellijk; het wordt één keer getoond.
  • Controleer handtekeningen voordat u gebeurtenissen verwerkt.
1

Registreer de webhook

POST actie webhook-register met url en gebeurtenissen.

Verwacht resultaat: Het antwoord bevat webhookdetails en een eenmalig ondertekeningsgeheim.
2

Bewaar het geheim

Bewaar het geheim in uw serveromgeving of geheimmanager.

Verwacht resultaat: Toekomstige leveringen kunnen worden geverifieerd.
3

Controleer handtekening

Lees X-SemChat-Signature en vergelijk het met een HMAC SHA-256 over de onbewerkte verzoektekst.

Verwacht resultaat: Alleen echte sem.chat leveringen worden geaccepteerd.
4

Behandel nieuwe pogingen idempotent

Gebruik gebeurtenis-ID of gespreks-/bericht-ID om dubbele verwerking te voorkomen.

Verwacht resultaat: Bij nieuwe pogingen worden geen dubbele CRM-records gemaakt.
5

Maak een lijst van webhooks

GET actie webhook-list om geconfigureerde eindpunten te controleren.

Verwacht resultaat: U kunt URLs, gebeurtenissen, ingeschakelde status en recente leveringsstatus zien.
6

Verwijder verouderde webhooks

POST actie webhook-delete met webhook-ID.

Verwacht resultaat: Oude eindpunten ontvangen geen gebeurtenissen meer.
Hoe het te testen: Registreer een testeindpunt, activeer een live-ondersteuningsgebeurtenis, verifieer de handtekening en bevestig dat uw handler 2xx retourneert.
ProbleemRepareren
Handtekening komt niet overeenGebruik de onbewerkte hoofdtekst, niet geparseerde JSON, en bevestig het juiste webhookgeheim.
Webhook ontvangt geen gebeurtenissenBevestig dat de gebeurtenislijst de gebeurtenis bevat die u test en dat het eindpunt HTTPS is.
Webhook-time-outErken snel en verwerk lang werk asynchroon.

Wat u nu moet doen: Koppel engineers aan /api-docs voor eindpuntdetails en voorbeelden.

Webhook registreren
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Controleer de webhookhandtekening
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Eindpunt kaart

Gebruik de op actie gebaseerde openbare API correct

Waar dit voor is: Gebruik dit bij het kiezen van de juiste actie voor een object.

Voordat je begint
  • Elk verzoek gebruikt dezelfde openbare API-functie URL.
  • GET acties gebruiken queryparameters. POST acties gebruiken JSON hoofdtekst.
  • Stuur x-api-key voor alle verzoeken.
Hoe het te testen: Roep usage en list-bots op als rooktest na elke wijziging van de sleutel of het eindpunt van API.
ProbleemRepareren
Methode komt niet overeenGebruik de methode die wordt weergegeven in de eindpunttabel. Sommige acties zijn alleen voor GET of alleen voor POST.
Ontbrekende vereiste waardeControleer botId, conversationId, webhook-ID en actiespelling.

Wat u nu moet doen: Gebruik Quick Start voor de eerste verzoeken en vervolgens /api-docs voor de volledige referentie.

MethodeActieDoel
GETlist-botsMaak een lijst van alle bots die beschikbaar zijn voor de sleuteleigenaar API.
GETget-botHaal één botconfiguratie op per bot-ID.
POSTchatStuur een bezoekersbericht naar een bot en stuur het AI-antwoord terug.
GETconversationsGeef recente conversations weer voor een bot, maximaal 100 records.
GETusageRetourplan, tegoeden, aantal bots, conversations en API sleutel usage.
GETlive-support-listLijst conversations die wacht op of wordt afgehandeld door een menselijke agent.
GETlive-support-messagesHaal een overdrachtsthread op met berichten en bezoekersinformatie.
POSTlive-support-replyStuur een antwoord van een menselijke agent vanaf een extern systeem.
POSTlive-support-claimClaim een wachtend overdrachtsgesprek.
POSTlive-support-resolveLos de overdracht op of geef de controle terug aan AI.
POSTwebhook-registerRegistreer een HTTPS webhookeindpunt.
GETwebhook-listGeef webhookregistraties weer zonder geheimen terug te sturen.
POSTwebhook-deleteVerwijder een webhookregistratie op ID.
14

Handleiding voor ingenieurs: Functies toevoegen

Voeg routes, dashboardnavigatie, botbuilder-instellingen, Supabase tabellen/functies/migraties, API documenten, openbare documentatie, SEO-controles en lokale verificatie toe.

Workflow voor app-functies

Voeg een app-route, pagina, navigatie-item en documentinvoer toe

Waar dit voor is: Gebruik dit bij het toevoegen van een nieuwe klantgerichte dashboardfunctie.

Voordat je begint
  • Maak een vertakking voordat u deze bewerkt.
  • Bepaal of de functie thuishoort in de app-opslagplaats of in de openbare sem.chat frontend-opslagplaats.
  • Inspecteer bestaande route-, zijbalk-, i18n- en instellingenpatronen voordat u een nieuwe structuur toevoegt.
1

Voeg de route toe

Update src/App.tsx met een beveiligde route voor klantpagina's, of alleen een openbare route als de pagina openbaar moet zijn.

Verwacht resultaat: De URL wordt opgelost in de app zonder NotFound te raken.
2

Maak of update de paginacomponent

Gebruik bestaande paginapatronen, het laden van gegevens, lege statussen, laadstatussen en machtigingen.

Verwacht resultaat: De functie gedraagt zich consistent met het dashboard.
3

Voeg dashboardnavigatie toe

Werk indien nodig de zijbalk/navigatiebron bij met label, pictogram, route en planpoorten.

Verwacht resultaat: Gebruikers kunnen de nieuwe pagina ontdekken vanuit de app-shell.
4

Voeg het tabblad of de instelling voor botbouwers toe

Als de functie bij een bot hoort, voeg deze dan toe binnen de tabbladen Bot Builder en behoud deze via bestaande opslagstromen.

Verwacht resultaat: Bot-specifieke configuratie wordt opgeslagen met de bot en is niet gestrand in de lokale staat.
5

Voeg Supabase schema-/functiewijzigingen toe

Creëer migraties voor tabellen/beleid en edge-functies voor werk op de server.

Verwacht resultaat: Database- en servergedrag kan herhaaldelijk worden ingezet.
6

Update de vorm API indien openbaar

Voeg actieafhandeling toe of breid deze uit in supabase/functions/public-api/index.ts en documenteer x-api-key gedrag.

Verwacht resultaat: Integraties kunnen de functie veilig gebruiken.
7

Update app-documenten en openbare documentatie

Update de in-app-ontwikkelaarsdocumentatie en deze /documentatiepagina met schermafbeeldingen en klik-voor-klik-stappen.

Verwacht resultaat: Gebruikers en technici zien de functie op beide plaatsen.
8

Voer controles uit

Voer app-tests/build uit, SEO-optimalisatie op de openbare site, sitemapcontroles en browserverificatie.

Verwacht resultaat: De functie werkt lokaal en de openbare site blijft crawlbaar.
Hoe het te testen: Open de nieuwe route, gebruik de functie van begin tot eind, inspecteer console-/netwerkfouten en verifieer eventuele databasewijzigingen vanuit de gebruikersinterface.
ProbleemRepareren
Route werkt, maar navigatie markeert nietControleer de routematching in de zijbalk en stuur paden om.
Gegevens werken lokaal, maar worden niet geïmplementeerdBevestig migratie, RLS-beleid en omgevingsvariabelen voor edge-functies.
Openbare documenten ontbreken in de sitemapVoer de SEO-optimalisatie uit en inspecteer sitemap.xml op de canonieke URL.

Wat u nu moet doen: Leg documentatiescreenshots vast of genereer deze opnieuw wanneer de gebruikersinterface verandert.

Onderhoudsworkflow voor Documenten

Update deze openbare documentatiepagina na productwijzigingen

Waar dit voor is: Gebruik dit wanneer schermafbeeldingen, workflows, API gedrag of navigatiewijzigingen plaatsvinden.

Voordat je begint
  • Gebruik alleen veilige demogegevens.
  • Geef nooit echte klanten, e-mails, betalingsgegevens, API sleutels of privé conversations bloot.
  • Werk eerst de Engelse handleiding bij en vernieuw daarna elke gelokaliseerde documentatiepagina vóór de SEO-controles.
1

Controleer de gewijzigde route

Open de app-route en identificeer wat er visueel en procedureel is veranderd.

Verwacht resultaat: U weet welke gids-, screenshot- en probleemoplossingsrijen moeten worden bewerkt.
2

Maak of genereer een veilige screenshot

Gebruik een demowerkruimte en maskeer geheimen voordat u WebP-middelen opslaat onder middelen/documentatie.

Verwacht resultaat: De schermafbeelding is nauwkeurig en veilig om te publiceren.
3

Update de gids

Bewerk de relevante secties Waar dit voor is, Voordat u begint, Stappen, Verwachte resultaten, Testen, Probleemoplossing en Volgende.

Verwacht resultaat: De gids vertelt gebruikers waarop ze moeten klikken en wat er na elke klik moet gebeuren.
4

Update de navigatie indien nodig

Voeg de sectie toe aan de vastgezette inhoudsopgave, de mobiele sectiekiezer en de visuele index als het een hoofdpagina is.

Verwacht resultaat: Lezers kunnen de nieuwe inhoud snel vinden.
5

Voer SEO-tools uit

Voer node tools/seo-optimize-static-pages.js en node tools/seo-optimize-static-pages.js uit --check.

Verwacht resultaat: Canonieke, metadata, sitemap en robots-uitvoer blijven correct.
6

Voer opschonings- en diff-controles uit

Voer node tools/static-translation-cleanup.js --audit en git diff --check uit.

Verwacht resultaat: Statische vertalingen en witruimte zijn schoon.
7

Browserverificatie

Bedien de site lokaal en test/documentatie op desktop en mobiel.

Verwacht resultaat: Afbeeldingen worden geladen, zoeken werkt, kopieerknoppen werken, TOC-highlights en lay-out overlapt de cookiebanner niet.
Hoe het te testen: Zoek de gewijzigde functienaam op /documentation en bevestig dat het juiste geleideblok verschijnt.
ProbleemRepareren
Schermafbeeldingmarkeringen drijven op mobielHoud markeringen binnen de schermafbeelding of gebruik responsieve markercoördinaten.
Zoeken mist de nieuwe gidsVoeg nuttige trefwoorden toe aan de datatitel en neem de exacte producttermen op waarnaar gebruikers zoeken.
Gelokaliseerde documentatie raakt verouderdNadat u de Engelse handleiding hebt bewerkt, vernieuwt u elke gelokaliseerde documentatiepagina, voert u de SEO-optimalisatie opnieuw uit en controleert u of sitemap.xml elke documentatie-URL bevat.

Wat u nu moet doen: Voer de wijzigingen in de documentenpagina, middelen, kop-/voettekstlinks, .htaccess en sitemap samen door.

Heeft u de gerichte API referentie nodig?

De oudere /api-docs pagina blijft beschikbaar voor API details op eindpuntniveau.

Open API Documenten