Åtgärder

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

Quickchat AI-agenter har två typer av åtgärder.

Quickchat AI Actions är inbyggda, du slår bara på dem och konfigurerar dem:

• Human Handoff lämnar över samtalet till en människa.
• Smart datainsamling samlar in leads och andra data under chatten.

Anpassade åtgärder når utanför Quickchat AI:

• API-åtgärder anropar vilken HTTP-endpoint som helst. De beskrivs på den här sidan.
• MCP-åtgärder ansluter en hel MCP-server på en gång.
• Google Sheets är en genväg som med ett klick sätter upp en loggningsåtgärd åt dig.

Varje åtgärd kan läsa livedata från samtalet via AI Action Variables, och Jira-exemplet bygger en från början till slut.

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 normalt åtgärdsbeskrivningen och tillgängliga verktygs- eller parameteruppgifter för att avgöra när den ska köras. En API‑åtgärd kan i stället ställas in så att den körs automatiskt före det första svaret.
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. Under När den ska köras väljer du AI bestämmer eller Före första svaret.
5. Ställ in Connection:
   • Action Type: GET eller POST
   • Action endpoint URL: fullständig URL
   • Headers: t.ex. Authorization, content-type: application/json
6. 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.
7. Test request → validera → Done.

Utöver själva requesten har en API‑åtgärd tre valfria inställningar värda att känna till: Spara i minnet, Kör endast när och Response filter.

Välj när en API-åtgärd ska köras

Använd När den ska köras för att välja ett av två lägen:

• AI bestämmer: standardläget. AI:n läser åtgärdsbeskrivningen och avgör om besökarens request kräver åtgärden. Använd detta när åtgärden bara ska köras för vissa frågor eller efter att AI:n har samlat in information från besökaren.
• Före första svaret: Quickchat kör åtgärden en gång efter att besökaren skickar sitt första meddelande och innan AI:n skriver sitt första svar. AI:ns vanliga svar får resultatet och alla värden som sparats med Spara i minnet. AI:n kan inte längre välja den här åtgärden som ett verktyg, så den körs bara i första turen och inte igen senare i konversationen. Använd detta för kundidentifiering, kontokontext, behörighetskontroller eller andra förberedelser som varje verklig konversation behöver.

Före första svaret är kopplat till besökarens första meddelande, inte till att konversationen skapas. Att öppna en chatt eller ta emot ett välkomstmeddelande kör inte åtgärden, så övergivna chattar utlöser ingen request. Quickchat registrerar körningen innan endpointen anropas. Den körs därför inte igen i samma konversation, även om requesten misslyckas eller resultatet är osäkert.

Det första svaret väntar på requesten, så det här läget kan öka svarstiden. Om flera åtgärder använder läget körs de efter varandra och deras requesttider läggs ihop. Om nödvändig metadata saknas, endpointen inte är tillgänglig eller en request misslyckas svarar AI:n ändå. Öppna Begäranslogg på åtgärden för att se vad som hände.

Eftersom åtgärden körs innan AI:n kan välja parametervärden måste varje AI-parameter som används ha ett standardvärde. Metadata och inbyggda variabler kan infogas direkt i URL:en, headers, query eller body.

Identifiera via e-post eller telefon

För kanaler som kan tillhandahålla antingen en e-postadress eller ett telefonnummer skapar du en uppslagsåtgärd för varje identifierare. Ställ in båda som Före första svaret och lägg sedan till ett motsvarande villkor under Kör endast när, till exempel visitor_email exists eller visitor_phone_number exists. Quickchat skickar bara ett uppslagsanrop när motsvarande metadata finns.

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.

Spara i minnet

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 Spara i minnet 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.

Memory keys delas med agentens Remote MCP-verktyg. Om ett MCP-verktyg redan sparar till samma nyckel rapporterar fältet memory key konflikten när du sparar, så välj en annan nyckel.

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.

Kör endast när

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 Kör endast när 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