Wiring Lab

I Wiring Lab kopplar du en persona till en motor. Den kopplingen kallas en länk — den parar exakt en persona med en motor, så att motorn körs i den personans röst. Varje länk får sitt eget api_slug, ett unikt id för just den kopplingen, så att plattformen alltid vet vilken persona-och-motor-kombination en förfrågan tillhör.

Så här kopplar du en länk:

Öppna Wiring Lab och välj den persona du vill ta online.
Dra en motor från biblioteket till arbetsytan för att koppla den till den personan.
Tryck på Spara (knappen Bekräfta koppling) för att spara länken. Kopplingen sparas inte förrän du bekräftar.

Du kan koppla flera persona-motor-länkar i ett konto — var och en är sin egen anslutning med sitt eget api_slug.

API-nycklar

En API-nyckel är hur en extern bot eller integration autentiserar sig mot FluidTalk. Det finns två sätt att skapa en:

Skapa — generera en vanlig, kontoövergripande nyckel som ännu inte är kopplad till någon persona eller motor.
Provisionera — generera en nyckel som är avgränsad till en specifik persona och motor i ett steg. Det är den rekommenderade vägen, eftersom en redan avgränsad nyckel är redo att hantera live-trafik.

Du hanterar nycklar från Wiring Lab:

Länka / avgränsa en nyckel — bind en befintlig kontoövergripande nyckel till en persona och motor (och döp om den valfritt). En nyckel som aldrig avgränsas kan inte hantera live-anrop.
Lista — se alla nycklar på kontot.
Återkalla — radera en nyckel så att den inte längre kan användas.

Obs

En API-nyckels hemlighet visas bara en gång, i det ögonblick den skapas. Kopiera den då och förvara den någonstans säkert — om du tappar bort den kan du inte se den igen. Återkalla bara den nyckeln och skapa en ny.

Obs

En nyckel måste vara avgränsad till en persona (och motor) innan den kan hantera live-trafik. En oavgränsad, kontoövergripande nyckel avvisas på live-anrop — provisionera en avgränsad nyckel, eller länka en befintlig, först.

Checklista för att gå live

När alla fyra stämmer är du live:

Persona klar — identitet och foton konfigurerade.
Motor kopplad — motorn kopplad till den personan och bekräftad i Wiring Lab.
En avgränsad API-nyckel — provisionerad (eller länkad) till just den personan och motorn.
Peka din bot mot handskakningen — din integration skickar varje inkommande meddelande till live handshake-endpointen och skickar nyckeln i X-API-Key headern. FluidTalk svarar med nästa meddelande och åtgärd att vidta.

För de exakta endpoints, förfrågningsfält och svar, se Developer API-referensen.

Tips

Du behöver inte gå live för att prova det. Kör hela konversationen i den inbyggda simulatorn först — samma motor, ingen nyckel och ingen riktig trafik — koppla sedan upp den när den beter sig som du vill.

Obs

Live-serving kräver en aktiv betald plan. Ett gratis- eller förfallet konto avvisas vid handskakningen, så din bot slutar serva i det ögonblick planen avslutas. Se Fakturering & planer.

Relaterade guider

Motorbyggaren — designa konversationen innan du kopplar den.
Testning i simulatorn — prova motorn end-to-end utan nyckel.
Developer API-referens — de exakta handshake-anropen och headrarna.
Fakturering & planer — vad en betald plan låser upp för live-serving.