Returns & Refund Processing Agent

import { BimpeAI } from "@bimpeai/sdk";

const bimpe = new BimpeAI({ apiKey: process.env.BIMPEAI_API_KEY! });

const page = await bimpe.workflows.list({ scope: "public", search: "returns refund" });
const workflow = page.data[0];
console.log(workflow.id, workflow.name);

import os
from bimpeai import BimpeAI

client = BimpeAI(api_key=os.environ["BIMPEAI_API_KEY"])

page = client.workflows.list(scope="public", search="returns refund")
workflow = page.data[0]
print(workflow.id, workflow.name)

const workflow = await bimpe.workflows.create({
  name: "Returns agent",
  system_prompt: "You process return requests, check order eligibility, track refund status, and schedule replacements.",
});
console.log(workflow.id);

workflow = client.workflows.create(
    name="Returns agent",
    system_prompt="You process return requests, check order eligibility, track refund status, and schedule replacements.",
)
print(workflow.id)

const agent = await bimpe.agents.create(
  {
    name: "Returns agent",
    description: "Processes return requests, checks eligibility, and initiates refunds via Stripe.",
    workflow_id: workflow.id,
  },
  { idempotencyKey: "create-returns-agent-v1" },
);

console.log(agent.id);

agent = client.agents.create(
    name="Returns agent",
    description="Processes return requests, checks eligibility, and initiates refunds via Stripe.",
    workflow_id=workflow.id,
    idempotency_key="create-returns-agent-v1",
)

print(agent.id)

await bimpe.agents.knowledgeBases.create(agent.id, {
  type: "text",
  name: "Returns policy",
  content: `
    Items can be returned within 30 days of delivery in original condition.
    Perishables and personalised items are non-returnable.
    Refunds are issued to the original payment method within 5–7 business days.
    Replacement orders ship within 2 business days of return receipt.
  `,
});

client.agents.knowledge_bases.create(agent.id, {
    "type": "text",
    "name": "Returns policy",
    "content": (
        "Items can be returned within 30 days of delivery in original condition.\n"
        "Perishables and personalised items are non-returnable.\n"
        "Refunds are issued to the original payment method within 5-7 business days.\n"
        "Replacement orders ship within 2 business days of return receipt."
    ),
})

const { channels } = await bimpe.agents.getTestCode(agent.id);
// A tester opens channels.whatsapp.url, or sends channels.whatsapp.start_message
// to channels.whatsapp.phone_number, to open a 24-hour test window.
console.log(channels.whatsapp.start_message, channels.whatsapp.url);

// Or inject a test message yourself:
await bimpe.conversations.send(agent.id, {
  message: "I'd like to return a jacket I ordered last week — is it eligible?",
  channel_type: "whatsapp",
  channel_user_id: "<tester-whatsapp-number>",
  is_test_channel: true,
});

test_code = client.agents.get_test_code(agent.id)
# A tester opens .url, or sends .start_message to .phone_number, to open a 24-hour window.
print(test_code.channels.whatsapp.start_message, test_code.channels.whatsapp.url)

# Or inject a test message yourself:
client.conversations.send(
    agent.id,
    message="I'd like to return a jacket I ordered last week — is it eligible?",
    channel_type="whatsapp",
    channel_user_id="<tester-whatsapp-number>",
    is_test_channel=True,
)

const integrations = await bimpe.agents.integrations.list(agent.id);
console.log("Integrations:", integrations.map((i) => i.type));

integrations = client.agents.integrations.list(agent.id)
print("Integrations:", [i.type for i in integrations])

import { BimpeAI } from "@bimpeai/sdk";

const bimpe = new BimpeAI({ apiKey: process.env.BIMPEAI_API_KEY! });

// 1. Find workflow
const page = await bimpe.workflows.list({ scope: "public", search: "returns refund" });
const workflow = page.data[0];

// 2. Create agent
const agent = await bimpe.agents.create(
  {
    name: "Returns agent",
    description: "Processes return requests, checks eligibility, and initiates refunds via Stripe.",
    workflow_id: workflow.id,
  },
  { idempotencyKey: "create-returns-agent-v1" },
);

// 3. Add returns policy
await bimpe.agents.knowledgeBases.create(agent.id, {
  type: "text",
  name: "Returns policy",
  content:
    "Items can be returned within 30 days of delivery. Refunds process in 5-7 business days.",
});

// 4. Verify integrations (OMS + Stripe must be connected in the dashboard first)
const integrations = await bimpe.agents.integrations.list(agent.id);
console.log("Integrations:", integrations.map((i) => i.type));

// 5. Stream web chat conversations
const controller = new AbortController();
const conversations = await bimpe.conversations.list(agent.id, { channel: "webchat" });
const conv = conversations.data[0];

if (conv) {
  for await (const event of bimpe.conversations.messages.stream(agent.id, conv.id, {
    signal: controller.signal,
  })) {
    console.log(event.role, event.message);
  }
}

import os
from bimpeai import BimpeAI

client = BimpeAI(api_key=os.environ["BIMPEAI_API_KEY"])

# 1. Find workflow
page = client.workflows.list(scope="public", search="returns refund")
workflow = page.data[0]

# 2. Create agent
agent = client.agents.create(
    name="Returns agent",
    description="Processes return requests, checks eligibility, and initiates refunds via Stripe.",
    workflow_id=workflow.id,
    idempotency_key="create-returns-agent-v1",
)

# 3. Add returns policy
client.agents.knowledge_bases.create(agent.id, {
    "type": "text",
    "name": "Returns policy",
    "content": "Items can be returned within 30 days of delivery. Refunds process in 5-7 business days.",
})

# 4. Verify integrations (OMS + Stripe must be connected in the dashboard first)
integrations = client.agents.integrations.list(agent.id)
print("Integrations:", [i.type for i in integrations])

# 5. Stream web chat conversations
conversations = client.conversations.list(agent.id, channel="webchat")
if conversations.data:
    conv = conversations.data[0]
    for msg in client.conversations.messages.stream(agent.id, conv.id):
        print(msg.role, msg.message)