Quickstart

curl -X POST "$CHATTLER_BASE_URL/v1/agents/$CHATTLER_AGENT_ID/chat" \
  -H "Authorization: Bearer $CHATTLER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"external_user_id": "customer-123", "message": "I want to know the price"}'

import os
import uuid

import httpx

BASE_URL = os.environ["CHATTLER_BASE_URL"]
AGENT_ID = os.environ["CHATTLER_AGENT_ID"]
HEADERS = {"Authorization": f"Bearer {os.environ['CHATTLER_API_KEY']}"}


def chat(external_user_id: str, message: str) -> dict:
    response = httpx.post(
        f"{BASE_URL}/v1/agents/{AGENT_ID}/chat",
        headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
        json={"external_user_id": external_user_id, "message": message},
        timeout=120,
    )
    if response.status_code >= 400:
        error = response.json()["error"]
        raise RuntimeError(f"{error['code']}: {error['message']} ({error['request_id']})")
    return response.json()


print(chat("customer-123", "I want to know the price")["message"]["content"])

const baseUrl = process.env.CHATTLER_BASE_URL;
const agentId = process.env.CHATTLER_AGENT_ID;
const apiKey = process.env.CHATTLER_API_KEY;

async function chat(externalUserId, message) {
  const response = await fetch(`${baseUrl}/v1/agents/${agentId}/chat`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Idempotency-Key": crypto.randomUUID(),
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ external_user_id: externalUserId, message }),
  });
  const body = await response.json();
  if (!response.ok) {
    throw new Error(`${body.error.code}: ${body.error.message} (${body.error.request_id})`);
  }
  return body;
}

const reply = await chat("customer-123", "I want to know the price");
console.log(reply.message.content);