Åtgärder

Definiera vad din AI‑agent kan göra i en konversation: svar med realtids‑API‑data, leaduppsamling och skräddarsydda åtgärder.

Överföring till människa (Human Handoff)

Human Handoff säkerställer att ärenden som kräver mänsklig handläggning smidigt överförs till en mänsklig agent.

Det är särskilt användbart när frågan ligger utanför kunskapsbasen eller användaren uttryckligen vill prata med en människa. Under handoff pausar AI‑assistenten och en mänsklig agent tar över i Inkorgen.

Så här ser det ut för användaren:

1. Användaren chattar med AI‑assistenten.
2. Om frågan ligger utanför AI:ns förmåga eller användaren ber om människa, meddelar AI att ärendet överförs.
3. Konversationen avassigneras från AI och tilldelas en mänsklig agent.
4. Den mänskliga agenten löser ärendet eller återtilldelar AI.

I Quickchat‑gränssnittet ser du:

1. Den oassignerade konversationen dyker upp i Inkorgen.
2. Teammedlemmen läser AI‑sammanfattningen för kontext.
3. Tar över och hanterar ärendet.
4. Avslutar eller återtilldelar.

Aktivera Human Handoff

Gå till Capabilities > Human Handoff och slå på växeln.

Konfigurera därefter:

Tillgänglighet för mänskliga agenter

Säkerställ att handoff endast sker under arbetstid.

• Arbetstider – start/slut och arbetsdagar
• Tidszon
• Meddelande utanför arbetstid

Fråga

Definiera frågan AI ställer före handoff.

Exempel: Vill du att jag kopplar dig till vårt supportteam?

Bekräftelse

Definiera bekräftelsen som skickas när handoff initieras.

Exempel: Jag förstår. Jag kopplar dig till vårt supportteam. Ett ögonblick.

AI‑sammanfattning

Aktivera AI‑sammanfattningar för att generera en kort summering av dialogen hittills.

Överlämningsregler

Beskriv situationerna där Human Handoff ska utlösas. Varje regel har ett Regelnamn, en lättbegriplig Beskrivning och en Status-växel så att du kan aktivera eller inaktivera regler utan att radera dem.

Quickchat AI innehåller en standarduppsättning regler för de vanligaste orsakerna till överlämning:

• Media Message: användaren skickade en bild, fil eller annat media som AI inte kan hantera.
• User Frustration: användaren är uttryckligen arg, frustrerad eller missnöjd.
• Customer Support Suggestion: AI-agenten har angett kontakt med kundsupport som nästa steg eller tydligt avslutat den AI-baserade hjälpen.
• Lack Of Knowledge: AI-agenten har medgett att den saknar nödvändig information.
• Irrelevant Advice: AI-agenten har upprepade gånger försökt hjälpa till, men användaren är fortfarande inte nöjd.

Du kan aktivera eller inaktivera dessa regler och lägga till egna regler med ett anpassat Regelnamn och en Beskrivning som talar om för AI när en överlämning ska utlösas.

Tip

Skriv regelbeskrivningar som instruktioner till AI. ”Användaren har uttryckligen begärt en återbetalning på mer än 100 USD” går att testa; ”eskalera VIP-kunder” gör det inte, eftersom AI inte kan veta vem som är VIP om det inte står i konversationens metadata.

Utöver regler kan du ange Nyckelord som alltid tvingar fram Human Handoff oavsett sammanhang. Det är användbart för ord som rör regelefterlevnad, till exempel ”stämning”, ”GDPR” eller ”chargeback”, som AI aldrig ska hantera.

Ämnesbaserad dirigering

När Human Handoff utlöses skickar Ämnesbaserad dirigering konversationen till den mänskliga agent som är bäst lämpad för ämnet i stället för att lämna den otilldelad i en gemensam kö.

Konfigurera dirigeringen genom att koppla varje ämne som definieras under Insikter → Hantera ämnen till en eller flera teammedlemmar. När en överlämning utlöses läser Quickchat konversationens identifierade ämne och dirigerar den till en av de agenter som tilldelats ämnet. Om ingen dirigeringsregel matchar lämnas konversationen otilldelad så att en teammedlem kan ta den från Inkorg.

E‑postaviseringar

Ställ in e‑post för meddelanden när en ny konversation kräver handoff.

---

Smart datainsamling / leadgenerering

Med smart datainsamling kan agenten naturligt fråga efter uppgifter (namn, e‑post, telefon) och skicka dem till ditt CRM.

Så fungerar det

Integrerat i samtalsflödet.

1. AI upptäcker insamlingsmöjligheter.
2. Ställer riktade frågor, t.ex.:
   • ”Vad heter du så att jag kan hjälpa dig bättre?”
   • ”Vilken e‑post når vi dig bäst på?”
3. Lagrar svaren för granskning eller integration.

Konfiguration

Aktivera

• Gå till Actions & MCPs
• Öppna Smart Data Gathering
• Slå på

Vilka uppgifter

• E‑postadress
• Förnamn
• Telefonnummer

När frågar man

• Efter några meddelanden
• Direkt efter uttryckt intresse

Hur frågar man

• Subtilt – naturligt i dialogen
• Direkt – tydlig begäran

Exportera insamlade uppgifter

1. Gå till Inbox
2. Klicka export
3. Välj Export Gathered Data
4. Ställ in datumintervall
5. Välj format (CSV, XLSX)
6. Klicka Download

---

Skräddarsydda åtgärder

Låt AI anropa externa API:er under samtalet. Använd för att söka i interna verktyg, skapa ärenden, trigga aviseringar eller hämta färska data utanför kunskapsbasen. Finns i Actions & MCPs → Custom Actions.

Så fungerar åtgärder

1. Välj en åtgärdstyp: API-åtgärd, MCP, HubSpot-åtgärd, Discord-åtgärd, Google Sheets eller Shopify MCP. Konfigurera anslutningen och instruktionerna som AI:n behöver.
2. Under chatten använder AI:n åtgärdsbeskrivningen och tillgängliga verktygs- eller parameteruppgifter för att avgöra när den ska köras.
3. Quickchat kör anropet och returnerar resultatet till AI:n. AI:n läser svaret och svarar användaren på naturligt språk.
4. Testa eller anslut åtgärden i dess redigerare innan du använder den i konversationer.

Tip

Skriv beskrivningen som en instruktion: när använda, vad som returneras och skyddsräcken.

Skapa en API‑åtgärd

1. Gå till Actions & MCPs.
2. Klicka + i Custom Actions och välj API Action.
3. Fyll i Details:
   • Name – tydligt och beskrivande
   • Description – när använda och vad parametrar ska innehålla
4. Ställ in Connection:
   • Action Type – GET eller POST
   • Action endpoint URL – fullständig URL
   • Headers – t.ex. Authorization, content-type: application/json
5. Definiera Parameters med name, location (query, body eller header) och en description som guidar AI. Sökvägsvärden (path) är ingen parameter‑location; lägg in dem direkt i endpoint‑URL:en med {{placeholder}}‑mallar.
6. Test request → validera → Done.

Utöver själva requesten har en API‑åtgärd tre valfria inställningar värda att känna till: Save to memory, Run only when och Response filter.

Discord-åtgärder

Discord-åtgärder öppnar ett galleri med förifyllda, redigerbara API-åtgärder:

• Support och ärenden: Öppna supportärende ber dig välja en server och en textkanal. Du kan även välja en supportroll som kan omnämnas, men det är valfritt. Den skapar tre åtgärder som öppnar en privat tråd, lägger till den som begär hjälp och publicerar en sammanfattning med ett valfritt omnämnande av rollen.
• Moderering: Timeout för medlem, Kicka medlem, Banna medlem, Ta bort bannlysning, Tilldela roll, Ställ in slowmode och Skicka tillkännagivande. Varje mall installeras med ett klick och använder servern, medlemmen, rollen eller kanalen från aktuell Discord-request.

Quickchat skapar HTTP-metod, URL, headers, body, parametrar, beskrivning, svarsinställningar och körvillkor i backend. Korten som skapas är vanliga HTTP Request-åtgärder. Du kan granska och redigera varje fält.

Alla sju modereringsmallar innehåller villkoret author_is_admin is true under Kör endast när. Discord beräknar den aktuella avsändarens Administrator-behörighet, Discord-gatewayen tillhandahåller värdet och Quickchat kontrollerar det innan requesten skickas. Offentlig chatt och API-metadata kan inte ange den här nyckeln. Testa modereringsåtgärderna i Discord med både ett administratörskonto och ett konto som inte är administratör. AI Preview tillhandahåller ingen auktoriserad Discord-avsändare.

Caution

Modereringsåtgärderna är redigerbara. Om du tar bort eller försvagar villkoret author_is_admin is true tas den medföljande auktoriseringsgränsen bort. Kicka medlem och Banna medlem ber inte om bekräftelse innan de körs.

Boten behöver fortfarande den Discord-behörighet som varje request kräver:

Åtgärd	Botbehörighet eller åtkomst
Timeout för medlem	Moderate Members
Kicka medlem	Kick Members
Banna medlem, Ta bort bannlysning	Ban Members
Tilldela roll	Manage Roles
Ställ in slowmode	Manage Channels
Skicka tillkännagivande	View Channels och Send Messages

Discord tillämpar också rollhierarkin. Placera botens roll över de medlemmar och roller som den ska hantera. Mallen gör ingen ytterligare kontroll av hierarkin eller enskilda behörigheter för administratören som skickar requesten.

Ställ in slowmode och Skicka tillkännagivande tar emot ett kanal-ID som parameter. Utan ett ytterligare fast mål verifierar mallen inte att kanalen tillhör servern där administratören skickade requesten. Om samma bot finns på flera servrar ska du redigera åtgärderna så att de använder ett fast kanal-ID, eller hålla servrarna inom separata tillitsgränser med olika Agenter och inloggningsuppgifter för botar.

Installationen av Support Ticket använder befintliga åtgärdsfunktioner för att skicka data:

1. open_support_ticket skapar en privat tråd i den valda kanalen, fångar $.id och sparar det i konversationens minne som discord_ticket_thread_id. Den kräver discord_message is true, körs bara på den valda servern och bara så länge minnesnyckeln inte finns.
2. add_ticket_requester läser {{metadata_discord_ticket_thread_id}} och det Discord-tillhandahållna {{metadata_discord_author_id}}. Den kräver discord_message is true och körs bara på den valda servern efter att tråd-ID:t finns.
3. post_in_ticket läser samma sparade tråd-ID, publicerar Agentens enradsöversikt över ärendet och omnämner den som begär hjälp. Om du har valt en supportroll omnämns även den. Åtgärden har samma villkor för Discord-meddelande, server och sparad tråd. Fältet allowed_mentions i Discord-requestens body begränsas till den som begär hjälp samt den valda rollen, om en sådan har konfigurerats.

Beskrivningarna och Agentens huvudprompt ska tala om för Agenten att köra åtgärderna i den här ordningen. Det finns inget separat lager för arbetsflödesstatus, låsning, bekräftelse, återförsök, återställning, avstämning eller replay-skydd. Om resultatet är osäkert ska du kontrollera Discord och åtgärdsloggen innan du försöker igen, eftersom Discord redan kan ha slutfört requesten.

discord_ticket_thread_id rensas inte automatiskt. Mallen stöder därför ett ärende per Quickchat-konversation. Starta en ny Discord-konversation eller tråd för ett nytt ärende, eller redigera åtgärderna och lägg till den minneslivscykel du behöver.

För Support Ticket ska boten ha View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads och Manage Threads i den valda ärendekanalen. Låt Meddela en roll (valfritt) vara inställt på Meddela ingen roll om ingen roll ska omnämnas. Om du väljer en roll måste den kunna omnämnas och dess medlemmar behöver åtkomst till de privata trådarna. Om du inte väljer någon roll eller om inga roller som kan omnämnas är tillgängliga öppnas ärenden ändå som vanligt utan att en roll meddelas. Galleriet listar textkanaler och roller som kan omnämnas, men validerar inte alla kanalens behörighetsundantag.

Caution

Discord-åtgärder behöver token från din egen Discord-app under Externa appar → Discord → Avancerad konfiguration. Den delade boten med ett klick kan inte ensam tillhandahålla denna token. Se Discord.

Galleriet är en genväg för konfiguration, inte ett extra policylager. Om du redigerar en genererad åtgärd eller skapar en anpassad Discord API-åtgärd ska du granska autentiseringsuppgifter, mål, parametrar, svarsexponering och villkoren under Kör endast när innan du aktiverar den.

Save to memory

Fånga ett värde från API‑svaret och lagra det i konversationens minne under en nyckel du väljer. Senare åtgärder kan återanvända det som {{metadata_<key>}}, och det syns i konversationens detaljer (Inkorgen, API:t och exporter).

Ta till detta när en åtgärd producerar något som en senare åtgärd behöver. En uppslagsåtgärd kan spara ett customer_id från sitt svar; en uppföljande åtgärd skickar sedan {{metadata_customer_id}} utan att AI:n behöver kopiera värdet mellan dem.

I sektionen Save to memory i API‑åtgärdens editor ger du det fångade värdet en memory key och pekar den mot den del av svaret du vill behålla. Från och med då är det en metadatavariabel som vilken annan som helst.

Tip

Använd snake_case-nycklar (bokstäver, siffror, understreck). En nyckel som customer_id kan refereras som {{metadata_customer_id}}; nycklar med mellanslag eller annan interpunktion kan inte användas i platshållare. Se Konversationsmetadata för hur metadatavariabler fungerar.

Run only when

Begränsa en åtgärd så att den körs endast när villkor på konversationsmetadatan är uppfyllda. Villkoren kontrolleras på vår sida, vid anropstillfället, efter att AI:n har bestämt sig för att anropa åtgärden men innan någon request skickas, så de kan inte pratas runt från chatten.

Detta är rätt verktyg för privilegierade eller oåterkalleliga åtgärder (banna en medlem, utfärda en återbetalning, radera en post). En rad i din prompt som säger ”bara administratörer kan göra detta” är en hjälpsam instruktion, men det är ingen säkerhetsgräns: en målmedveten användare kan argumentera med modellen eller försöka med en prompt-injektion. Ett körvillkor är deterministiskt och lever utanför prompten, så det håller oavsett vad konversationen säger.

• Körvillkoret är gränsen. Det utvärderas på serversidan och är inte en del av prompten modellen läser. Det är detta som faktiskt hindrar åtgärden från att köras.
• Promptregeln är användarupplevelsen. Behåll en rad i prompten också, så att AI:n avböjer artigt och förklarar varför i stället för att tystna.

Lägg till villkor i sektionen Run only when i åtgärdens editor. Klicka på Add condition, välj en metadatanyckel (till exempel telegram_sender_is_admin) och välj hur den ska jämföras:

Villkor	Uppfylls när metadatavärdet…
is true	är sant (truthy)
is false	är falskt (falsy)
exists	finns på konversationen
does not exist	saknas
equals	matchar ett värde du anger
does not equal	skiljer sig från ett värde du anger

Åtgärden körs bara när alla villkor är uppfyllda. Ett villkor på en nyckel som inte är satt på konversationen uppfylls inte.

När ett villkor inte uppfylls skickas ingen request och AI:n talar om för användaren att den inte kan göra det. Nedan blockeras samma ban-request för en icke-administratör och tillåts för en administratör, utan att något ändrats förutom vem som frågar:

Caution

Sätt endast villkor på metadata som Quickchat sätter (såsom en kanal-verifierad telegram_sender_is_admin-flagga), inte på värden som besökaren kan påverka. Se Konversationsmetadata för var varje nyckel kommer ifrån.

Response filter

Som standard ser AI:n hela API‑svaret. Lägg till JSONPath-uttryck i sektionen Response filter för att begränsa AI:n till specifika delar av det.

Två vanliga skäl att filtrera:

• Dölj känsliga fält. Håll kunders e-postadresser, betalningsuppgifter eller interna id:n utanför modellens kontext när endpointen returnerar mer än AI:n behöver.
• Krymp prompten. Pratglada API:er kan returnera stora payloads; att filtrera till de få fält som spelar roll håller svaret litet och AI:n fokuserad.

Lägg till ett eller flera JSONPath-uttryck så får AI:n bara de matchade delarna. Till exempel behåller $.data.items[*].name bara artikelnamnen ur ett större svar.

Tip

Använd panelen Test Response för att se exakt vad AI:n får efter filtrering innan du förlitar dig på det. Se Testa din Action.

Caution

Ett JSONPath som inte matchar något lämnar AI:n med ett tomt svar. Börja utan filter, bekräfta att anropet fungerar och skärp det sedan.

Bästa praxis

• Var explicit i beskrivningar.
• Minimera scope – bara nödvändiga headers/tokens.
• Testa före driftsättning – statuskoder och payloads.

Guider

• Sök Jira‑ärenden i AI‑konversation
• Skicka Slack‑notis med en AI‑åtgärd

MCP‑åtgärder

MCP (Model Context Protocol) är en öppen standard som låter en AI använda en annan tjänsts verktyg direkt. I stället för att du beskriver en endpoint och dess parametrar för hand publicerar MCP‑servern sina egna verktyg, och din AI‑agent upptäcker och använder dem.

För de flesta tjänster räcker ett klick för att ansluta. Gå till Åtgärder & MCPs, klicka på + Lägg till åtgärd och välj MCP.

Anslut från katalogen

MCP‑vyn öppnas med en sökbar katalog över kända tjänster, grupperade i kategorier (Populära, Kundsupport, CRM & försäljning, Schemaläggning, E-handel, Betalningar & fakturering, Marknadsföring & e-post, Kommunikation, Produktivitet, Data & analys, Sök & webb, Resor & bokning, Design, Utvecklare & infra).

1. Hitta tjänsten du vill ha, genom att bläddra eller via sökrutan.
2. Klicka på dess ruta. Quickchat kontrollerar servern och upptäcker vilka verktyg den erbjuder.
3. Om tjänsten kräver att du loggar in visas panelen Auktorisering krävs. Klicka på Anslut med <tjänst>, godkänn åtkomsten i popup‑fönstret som öppnas, så växlar panelen till ansluten.
4. Åtgärden skapas, aktiveras och dess verktyg listas. Din AI‑agent kan använda dem från och med nästa meddelande.

Note

Om du stänger popup‑fönstret utan att godkänna sparas ingen anslutning och åtgärden kasseras.

Tip

Din webbläsare måste tillåta popup‑fönster för Quickchat‑panelen, annars kan auktoriseringsfönstret inte öppnas. Om det blockeras visas ett meddelande som ber dig tillåta popup‑fönster och försöka igen.

Anslut en server som inte finns i katalogen

Klicka på Ange en URL manuellt under katalogen och sedan:

1. Klistra in MCP-serverns URL (måste börja med https://).
2. Om servern autentiserar med en statisk token i stället för ett inloggningsflöde, öppna Anslutnings-headers (valfritt) och lägg till den header som servern förväntar sig, till exempel Authorization: Bearer <din-token>.
3. Klicka på Anslut.

Använd Bläddra i katalogen för att komma tillbaka till rutvyn. Om en tjänst du behöver saknas öppnar Saknas en integration? Föreslå en ett förifyllt e‑postmeddelande till vårt team.

Välj vilka verktyg AI:n får använda

När anslutningen är klar listar åtgärden under Verktyg varje verktyg som servern exponerar, vart och ett med en egen växel. Stäng av allt du inte vill att AI:n ska anropa: en bokningsservers skrivskyddade uppslagningar kan vara påslagna medan dess avbokningsverktyg är avstängt.

Standardverktygsaktivering avgör vad som händer när servern lägger till ett nytt verktyg senare: påslagen gör nya verktyg tillgängliga direkt, avstängd innebär att du aktiverar varje verktyg medvetet.

Tip

Ge åtgärden ett tydligt Namn på MCP-åtgärd och en tydlig Beskrivning av MCP-åtgärd. Beskrivningen talar om för AI:n när den överhuvudtaget ska använda den här servern, så en specifik beskrivning (”Använd detta för alla frågor relaterade till Linear-projektet”) fungerar bättre än en generell.

Vad besökaren ser

Medan ett verktyg körs visar chattwidgeten en kort statusrad som beskriver vad AI:n gör, härledd från verktygets namn: ett verktyg som heter search_flights visar ”Söker flyg…”. Det ger besökaren något meningsfullt under pausen i stället för bara en skrivindikator. Statusraden genereras automatiskt och behöver inte konfigureras.

Återanslut och koppla från

• Återanslut: kör auktoriseringen på nytt. Använd det om anslutningen har gått ut, om du vill auktorisera ett annat konto eller om serverns verktygslista har ändrats och du vill hämta in de nya verktygen.
• Koppla från: återkallar den sparade auktoriseringen och tar åtgärden offline. Själva åtgärden ligger kvar i din lista, så du kan ansluta igen senare utan att konfigurera om den.

Om du ändrar MCP-serverns URL på en ansluten åtgärd rensas dess auktorisering och åtgärden stängs av, eftersom inloggningsuppgifter som utfärdats av en server aldrig återanvänds mot en annan. Auktorisera på nytt för att få åtgärden online igen.

Felsökning

Det du ser	Vad det betyder
Auktoriseringen misslyckades	Inloggningen slutfördes inte. Prova Återanslut. Om popup‑fönstret stängdes för tidigt sparades ingenting.
Ansluten, men det gick inte att ladda verktygen	Auktoriseringen lyckades, men verktygslistan laddades inte. Klicka på Återanslut.
Inga verktyg hittades på den här servern. Försök att ansluta igen.	Servern auktoriserade men publicerade inga verktyg. Kontrollera att kontot du godkände har åtkomst till de data du förväntar dig.
Ange en giltig URL som börjar med https://	URL:en kunde inte tolkas. Använd serverns fullständiga adress som börjar med https://. Quickchat ansluter alltid via https, så inloggningsuppgifter skickas aldrig okrypterat.
Åtgärden stängde av sig själv	Auktoriseringen gick ut eller återkallades hos leverantören. Öppna åtgärden och klicka på Återanslut.

Note

MCP‑åtgärder räknas mot din plans kvot för Anpassade åtgärder, precis som API‑åtgärder.