AI Action-variabler

Överallt där du kan skriva ett värde i en API Action (URL, headers, body eller query parameters) kan du infoga dynamiska värden med syntaxen {{...}}. Quickchat byter ut dessa platshållare vid requesttillfället, precis innan din endpoint anropas.

Klicka på knappen + Add AI Data bredvid valfritt värdefält för att bläddra bland alla variabler som är tillgängliga i det aktuella scenariot.

Knappen + Add AI Data är tillgänglig bredvid varje värdefält: endpointens URL, varje header-värde, body-fält och query parameters.

Tre kategorier av variabler

Kategori	Syntax	När den fylls i
AI-parametrar. Värden som din AI‑agent extraherar från konversationen. Du definierar dem under varje Actions Parameters-sektion.	{{order_number}}, {{customer_email}}	AI‑agenten fyller i dem vid anropet, baserat på reglerna du skriver i varje parameters beskrivning.
Inbyggda variabler. Konversationskontext som Quickchat injicerar automatiskt.	{{scenario_id}}, {{conversation_id}}, {{language}}, {{country}}, …	Alltid tillgängliga. Quickchat byter ut dem vid varje request.
Konversationsmetadata. Anpassade nyckel-värde-par kopplade till konversationen.	{{metadata_<key>}}	När motsvarande nyckel finns på konversationen (satt av widgeten, en kanal-integration, Smart Data Gathering eller API:t).

Tip

Varje variabel renderas som en färgad pill inne i editorn. Blå betyder att det är en AI-parameter eller en inbyggd variabel. Orange betyder att det är en metadatavariabel eller en system token. Röd betyder att namnet inte matchar något som Quickchat känner till (oftast ett stavfel).

Dropdownen ”+ Add AI Data”

Dropdownen listar alla variabler som är tillgängliga för det aktuella scenariot, grupperade i fem sektioner:

1. Parameters: AI-parametrarna du har definierat i denna Action.
2. Visitor: fyra metadata-nycklar som auto-fångas för varje besökare när deras kanal tillhandahåller dem.
3. Metadata (used in recent conversations): anpassade metadata-nycklar som setts i scenariots senaste 20 konversationer, med ett exempelvärde för var och en.
4. Built-in: de sex konversationsvariablerna som alltid är tillgängliga, med sitt aktuella värde eller ett exempel inline.
5. System Tokens: behörigheter från en ansluten integration (t.ex. HubSpot). Visas endast om integrationen är ansluten.

Dropdownen grupperar variabler i sektioner. Built-in-rader visar det aktuella värdet där det redan är känt (scenario_id) och e.g. …-exempel för resten. Gruppen Metadata (used in recent conversations) byggs om per scenario från verkliga nyligen genomförda konversationer. Sektionen System Tokens (visas inte här) syns endast när en integration är ansluten.

Note

Listan Metadata (used in recent conversations) byggs om från dina senaste 20 konversationer i scenariot och cachas i 5 minuter per AI‑agent. En metadata-nyckel som sätts på en helt ny konversation kan ta upp till 5 minuter innan den dyker upp i denna sektion. Du kan alltid skriva {{metadata_<your_key>}} direkt: Quickchat kräver inte att nyckeln syns i dropdownen för att utbytet ska fungera.

Inbyggda variabler

Dessa sex variabler är alltid tillgängliga. Dropdownen + Add AI Data visar det aktuella värdet (där det redan är känt) eller ett exempelvärde bredvid varje rad.

Variabel	Exempel	Vad det är
{{scenario_id}}	abc123xyz	ID för AI‑agenten som konversationen tillhör.
{{conversation_id}}	conv-d8a8…	Unik identifierare för konversationen.
{{conversation_url}}	https://app.quickchat.ai/.../conv-d8a8…	Direktlänk i Inkorgen till denna konversation.
{{conversation_channel}}	widget, telegram, slack, whatsapp, …	Kanal där konversationen pågår.
{{language}}	en, nl, de, fr, …	ISO 639-1-kod med små bokstäver för konversationens språk.
{{country}}	US, GB, NL, DE, …	ISO 3166-1 alpha-2-landskod med stora bokstäver.

Några bra saker att känna till:

• {{scenario_id}} syns även i webbläsarens URL medan du redigerar Actionen. Dropdownen + Add AI Data visar det levande ID:t för scenariot du redigerar, inte ett exempel.
• {{conversation_url}} är praktiskt för att posta klickbara länkar i Slack, Jira eller andra verktyg där det är värdefullt att kunna hoppa direkt tillbaka till Inkorgen.
• {{language}} härleds i denna ordning: från sidans URL-prefix (för Shopify Markets), från konversationens metadata och därefter från det språk som konfigurerats på din AI‑agent.
• {{country}} härleds i denna ordning: från sidans URL-prefix, från URL-värdens TLD och därefter från en språk-till-land-fallback.

Konversationsmetadata

Prefixet metadata_ är obligatoriskt. Quickchat slår upp <key> i konversationens metadata och byter ut värdet i requesten.

{{metadata_order_id}}      →   ord_8a4f3…
{{metadata_customer_tier}} →   gold

Besökarens metadata-nycklar

Dessa fyra nycklar beskriver besökarens session och får en egen Visitor-sektion i dropdownen. De auto-fångas av kanalen, integrationen, widgeten/embedden eller API:t. Du behöver inte skicka dem själv.

Variabel	Auto-fångas av
{{metadata_fullPathURL}}	Webbsidewidget, webbsideembed eller chattkanal-integrationer som har sin egen widget (HubSpot, Intercom etc.).
{{metadata_visitor_name}}	Chattkanalsprofil (Telegram, Slack etc.), kanal-integrationer, Smart Data Gathering, din widget/embed eller Quickchats API.
{{metadata_visitor_email}}	Chattkanalsprofil, kanal-integrationer, Smart Data Gathering, din widget/embed eller Quickchats API.
{{metadata_visitor_phone_number}}	WhatsApp och andra telefonmedvetna kanaler, kanal-integrationer, Smart Data Gathering, din widget/embed eller Quickchats API.

Anpassade metadata-nycklar

Du kan koppla godtyckliga nyckel-värde-par till en konversation och referera dem som {{metadata_<key>}}.

Från webbsidewidgeten eller embedden

Skicka in custom_params när du initierar widgeten. Se sektionen Website-kanalen: Advanced Features: Custom Parameters för det fullständiga snippet:et.

<script>
  _quickchat("custom_params", {
    "order_id": "ord_8a4f3",
    "customer_tier": "gold"
  });
</script>

Referera dem i valfri Action som {{metadata_order_id}} och {{metadata_customer_tier}}.

Caution

Metadata-nycklar måste matcha ^[a-zA-Z0-9_]+$ (bokstäver, siffror, understreck). Nycklar med mellanslag eller annan interpunktion kan inte refereras som {{metadata_<key>}}. De syns fortfarande i konversationens metadatavy i Inkorgen, men Action-utbytet kommer att hoppa över dem. Håll dig till snake_case-namn när du tänker använda dem i Actions.

Från Smart Data Gathering

Varje fältnamn du konfigurerar i en Smart Data Gathering-kampanj blir en metadata-nyckel med samma namn. Om din kampanj samlar in delivery_address kan du genast använda {{metadata_delivery_address}} i alla efterföljande API Actions.

Från kanal-integrationer

HubSpot, Intercom, Telegram, Slack, WhatsApp och liknande integrationer skjuter in egen metadata på konversationen (besökarens namn, e-post, sidans URL, kontoegenskaper etc.). Allt som syns i konversationens metadatavy i Inkorgen kan refereras via {{metadata_<key>}}.

Från Quickchats API

Använd POST /v1/api_core/conversations/{conv_id}/metadata för att koppla metadata programmatiskt. Se Conversation Metadata i API-referensen.

Pill-färger i editorn

Varje {{...}}-referens renderas som en färgad pill så att du på en gång ser om Quickchat känner igen variabeln.

Pills fungerar i alla värdefält. Ovan: en orange {{metadata_user_type}}-pill i endpointens URL och en blå {{language}}-pill i ett headervärde.

Samma färgregler gäller inuti en JSON-requestbody. Inbyggda variabler som {{country}} renderas i blått, metadatavariabler som {{metadata_fullPathURL}} i orange.

• 🔵 Blå: en inbyggd variabel eller en AI-parameter du har definierat.
• 🟠 Orange: en metadatavariabel ({{metadata_*}}) eller en System Token från en ansluten integration.
• 🔴 Röd: Quickchat känner inte igen det här namnet. Nästan alltid ett stavfel. Rätta stavningen, definiera variabeln som AI-parameter eller (om det verkligen är en metadata-nyckel) se till att den börjar med metadata_.

Tip

Att skriva {{metadata_anything}} direkt är alltid giltigt, även om nyckeln aldrig dykt upp i en konversation. Pillen blir orange, inte röd. Det är rätt sätt att koppla in nycklar du själv sätter från ett widget-skript eller Smart Data Gathering innan första konversationen har skett.

Testa din Action

Panelen Test Response (bredvid Done i Action-editorn) låter dig skicka en riktig HTTP-request utan att gå via en chatt. För varje variabel som refereras i Actionen ser du en inmatningsrad där du fyller i värdet som Quickchat ska byta ut.

Två praktiska förifyllningar:

• {{language}} har som standard en
• {{country}} har som standard US

Skriv över något av fälten för att testa en annan locale. Alla andra variabler (dina AI-parametrar, {{metadata_*}}-nycklar och övriga inbyggda) startar tomma. Skriv vilket värde som helst för att simulera vad som skulle hända i en live-konversation.

FAQ

Varför visas min variabel i rött? Editorn känner inte igen namnet. Antingen är det ett stavfel, det matchar ingen AI-parameter du har definierat, det är ingen inbyggd variabel, eller det är en metadata-nyckel som saknar prefixet metadata_.

Kan jag injicera {{language}} eller {{country}} även om jag aldrig sätter dem? Ja. Quickchat härleder alltid båda från konversationskontexten (sidans URL, webbläsarens locale eller AI‑agentens konfigurerade språk). Du får alltid ett värde, även om det faller tillbaka till en / US.

Vad är skillnaden mellan {{language}} och {{metadata_locale}}?

• {{language}} är den inbyggda. Alltid tillgänglig, alltid i formatet en / nl / de … Använd den i 99 % av fallen.
• {{metadata_locale}} finns bara om en kanal-integration eller din widget uttryckligen satt en locale-nyckel på konversationens metadata, ofta i formatet xx_YY (t.ex. en_GB). Använd den bara när du behöver den exakta locale-strängen ordagrant.

Finns det ett tak för antalet AI-parametrar per Action? Ja, 30 per Action. Om du verkligen behöver fler, kontakta supporten.

Skickas inbyggda och metadatavärden till AI:n? Nej. De injiceras i HTTP-requesten efter att AI:n har bestämt sig för att anropa Actionen. AI:n ser dem inte och blir inte ombedd att fylla i dem. Därför behöver de inte definieras som AI-parametrar.

Hur ofta uppdateras listan “Metadata (used in recent conversations)”? Den cachas i 5 minuter per AI‑agent. En metadata-nyckel som sätts på en helt ny konversation kan ta upp till 5 minuter innan den syns i dropdownen, men du kan alltid skriva {{metadata_<your_key>}} direkt utan att vänta.

Är metadata-nyckelnamn skiftlägeskänsliga? Ja. {{metadata_orderId}} och {{metadata_orderid}} är olika nycklar. Använd exakt samma skiftläge som du satte på widget-, integrations- eller API-sidan.

Känner Test Response-panelen till dessa variabler? Ja. När din Action refererar {{language}} eller {{country}} förifyller Test Response-panelen dem med en respektive US. Alla andra variabler startar tomma. Skriv vilket värde som helst för att simulera ett live-anrop.

Relaterat

• Custom Actions: hur du skapar och konfigurerar en API Action.
• Website-kanalen: Custom Parameters: hur du skickar metadata från din webbplats.
• API: Conversation Metadata: hur du skickar metadata programmatiskt.