私たちが開発に使っているのと同じAPIの上で開発する

無料API ― アカウント不要、キー不要

無料の層もAPIを話します。`POST /v1/free/widget-snippet`は、無料ページのビジュアルジェネレーターが組み立てるのとまったく同じ設定を受け取り、貼り付け可能なHTMLスニペットを返します ― 認証も登録も不要です。クライアントのサイト向けにウィジェットを一括生成したり、スケジュール変更時にCIから埋め込みを再生成したり、あるいは1セントも払う前にAPIに触れてみるために使ってください。

curl -X POST https://api.inteligenciaviva.com/v1/free/widget-snippet \
  -H "Content-Type: application/json" \
  -d @widget-config.json
# → { "snippet": "<link rel=\"stylesheet\" ..." }

本物の例

エージェントのメッセージを送信する（curl）

curl -X POST \
  https://api.inteligenciaviva.com/v1/workspaces/$WS/conversations/$CONV/messages \
  -H "Authorization: Bearer $IV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hi! I checked your order — it ships tomorrow."}'

会話を一覧する（JavaScript）

const res = await fetch(
  `https://api.inteligenciaviva.com/v1/workspaces/${WS}/conversations`,
  { headers: { Authorization: `Bearer ${process.env.IV_KEY}` } }
);
const { data } = await res.json();

Webhookの署名を検証する（Node）

import { createHmac, timingSafeEqual } from "node:crypto";

function verify(secret, rawBody, header, toleranceSec = 300) {
  const { t, v1 } = Object.fromEntries(
    header.split(",").map((p) => p.split("="))
  );
  if (Math.abs(Date.now() / 1000 - Number(t)) > toleranceSec) return false;
  const expected = createHmac("sha256", secret)
    .update(`${t}.${rawBody}`)
    .digest("hex");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

リアルタイムストリーミング

ライブUIのためには、ワークスペースのストリームに対してWebSocketを開き、会話イベントを発生と同時に受信してください ― 私たち自身のエージェント向けアプリが使っているのと同じチャネルです。

wss://api.inteligenciaviva.com/v1/workspaces/{workspaceId}/stream

よくある質問