De Wiring Lab

De Wiring Lab is waar je een persona aan een engine koppelt. Die verbinding heet een koppeling — het koppelt precies één persona aan één engine, zodat de engine in de stem van die persona draait. Elke koppeling krijgt zijn eigen api_slug, een unieke identificator voor die specifieke bedrading, zodat het platform altijd weet welke persona-en-engine-combinatie bij een verzoek hoort.

Om een koppeling te bedraden:

Open de Wiring Lab en kies de persona die je online wilt brengen.
Sleep een engine vanuit de bibliotheek op het canvas om hem aan die persona te koppelen.
Klik op Opslaan (de Bedrading vastleggenknop) om de koppeling op te slaan. Totdat je vastlegt, wordt de bedrading niet opgeslagen.

Je kunt meerdere persona-engine-koppelingen in één account bedraden — elk is zijn eigen verbinding met zijn eigen api_slug.

API-sleutels

Een API-sleutel is de manier waarop een externe bot of integratie zich authenticeert bij FluidTalk. Er zijn twee manieren om er een te maken:

Aanmaken — genereer een eenvoudige, accountbrede sleutel die nog niet aan een persona of engine is gekoppeld.
Inrichten — genereer een sleutel die gekoppeld is aan een specifieke persona en engine in één stap. Dit is het aanbevolen pad, omdat een al gekoppelde sleutel direct klaar is voor live verkeer.

Je beheert sleutels vanuit de Wiring Lab:

Koppelen / scopebepaling van een sleutel — bind een bestaande accountbrede sleutel aan een persona en engine (en geef hem optioneel een andere naam). Een sleutel die nooit is gekoppeld kan geen live aanroepen bedienen.
Overzicht — zie elke sleutel op het account.
Intrekken — verwijder een sleutel zodat hij niet meer kan worden gebruikt.

Let op

Het geheim van een API-sleutel wordt slechts één keergetoond, op het moment dat hij wordt aangemaakt. Kopieer hem dan en bewaar hem ergens veilig — als je hem kwijtraakt, kun je hem niet meer zien. Trek die sleutel gewoon in en maak een nieuwe.

Let op

Een sleutel moet aan een persona zijn gekoppeld (en engine) voordat hij live verkeer kan bedienen. Een ongekoppelde, accountbrede sleutel wordt afgewezen bij live aanroepen — richt een gekoppelde sleutel in, of koppel een bestaande, eerst.

Controlelijst voor live gaan

Wanneer alle vier waar zijn, ben je live:

Persona klaar — identiteit en foto's ingesteld.
Engine gekoppeld — de engine bedraden aan die persona en vastgelegd in de Wiring Lab.
Een gekoppelde API-sleutel — ingericht (of gekoppeld) aan die exacte persona en engine.
Wijs je bot naar de handshake — je integratie stuurt elk inkomend bericht naar het live handshake-endpoint, met de sleutel in de X-API-Key header. FluidTalk antwoordt met het volgende bericht en de te ondernemen actie.

Voor de exacte endpoints, verzoeksvelden en antwoorden, zie de Developer API-referentie.

Tip

Je hoeft niet live te gaan om het te proberen. Voer het hele gesprek uit in de ingebouwde simulator eerst — zelfde engine, geen sleutel en geen echt verkeer — en bedraad het dan zodra het zich gedraagt zoals je wilt.

Let op

Live serving vereist een actief betaald abonnement. Een gratis of verlopen account wordt geweigerd bij de handshake, zodat je bot stopt met bedienen zodra het abonnement eindigt. Zie Facturering & abonnementen.

Gerelateerde handleidingen

Engine builder — ontwerp het gesprek voordat je het bedraadt.
Testen in de simulator — probeer de engine van begin tot eind zonder sleutel.
Developer API-referentie — de exacte handshake-aanroepen en headers.
Facturering & abonnementen — wat een betaald abonnement ontsluit voor live serving.