Procedures – Automatiska workflows

En Procedure är ett multi-steg workflow som AI:n kör automatiskt när en specifik trigger matchar. Procedures konfigureras under Procedures.

Exempel: När en kund frågar om retur → AI:n hämtar orderdata från Shopify → kontrollerar beloppet → processar returen eller eskalerar till agent.

Varje procedure har:

• Trigger — Vad som startar proceduren
• Steg — En sekvens av åtgärder
• Version — Varje ändring skapar en ny version
• Enable/Disable toggle — Aktivera/inaktivera utan att radera

Varje steg i en Procedure har en typ som bestämmer vad det gör:

Steg kan kedjas via nextStep-fältet. Conditional-steg har trueStep och falseStep för branching.

Tre trigger-typer finns i Procedures:

Condition-fältet anger det specifika villkoret. T.ex. trigger Intent med condition refund_request matchar när AI:n uppfattar att kunden vill ha en retur.

Under procedurens körning byggs en kontext med variabler som varje steg kan läsa och skriva:

// Tillgängliga variabler:
{{user.email}}       — Kundens e-post
{{user.name}}        — Kundens namn
{{order.id}}         — Order-ID från data_lookup
{{order.total}}      — Orderns totalsumma
{{order.status}}     — Orderstatus

Variabler sätts automatiskt av data_lookup-steg via Connectors responseMapping. T.ex. Shopify-connectorn mappar orders[0].id → order.id och orders[0].total_price → order.total.

Komplett procedure för returer (5 steg):

1. data_lookup — Hämta order från Shopify med {{user.email}}
2. conditional — Om {{order.total}} > 100 → godkännande, annars direkt retur
3. approval — (om >100) Agent godkänner i Inbox
4. api_call — Skapa retur via Shopify refunds.create
5. message — "Your refund of ${{order.total}} has been processed."

Hela flödet körs automatiskt. Kunden behöver bara skicka "I want a refund" och AI:n tar hand om resten.

Enkel 2-stegs procedure:

1. data_lookup — Hämta order från Shopify med {{user.email}}
2. message — "Your order #{{order.id}} is currently {{order.status}}. Total: ${{order.total}}."

Trigger: Intent med condition order_status. Kunden frågar "Where is my order?" och får svar direkt med data från Shopify.

Gå till Procedures och klicka Add Procedure.

Fyll i formuläret:

• Name — T.ex. Process Refund
• Description — T.ex. Handles customer refund requests via Shopify
• Trigger Type — Välj: Intent, Keyword eller Manual
• Condition — T.ex. refund_request

Ett första steg skapas automatiskt:

{
  "id": "step_1",
  "type": "message",
  "config": { "template": "Hello, how can I help?" }
}

Proceduren visas som ett kort med: toggle, namn, trigger-badge, version-badge (v1), antal steg och condition.

Så felsöker du procedures:

1. Testa via Testing — Skapa ett testscenario med meddelanden som ska trigga proceduren
2. Kolla Inbox — Eskalerade/approval-steg visas i Inbox
3. API-logg — Streaming-API:t (POST /api/chat/stream) returnerar escalated-event om något gick fel
4. Connector-test — Testa connectors separat under Connectors med Test-knappen

Tips: Inaktivera en procedure med toggle istället för att radera den — du kan reaktivera den senare.