Developer Documentation

const languages = await Naoma.getLanguages();
console.log(languages); // ["en", "es", "de"]

// Build a language selector
if (languages.length > 1) {
  const select = document.createElement('select');
  languages.forEach(lang => {
    const option = document.createElement('option');
    option.value = lang;
    option.textContent = lang.toUpperCase();
    select.appendChild(option);
  });

  select.onchange = () => Naoma.startDemo({ language: select.value });
}

const { allowed, reason } = await Naoma.checkClient();

if (allowed) {
  document.getElementById('demo-button').style.display = 'block';
} else {
  console.log('Demo not available:', reason);
}

Naoma.widget.show();
Naoma.widget.hide();

Naoma.widget.expand();
Naoma.widget.collapse();

Naoma.hero.unmount();

Authorization: Bearer <token>

Authorization: Basic <base64(client_id:token)>

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "metadata": {"email": "jane@acme.com", "utm_source": "linkedin"},
      "transcript": [
        {"role": "assistant", "content": "Hi! I'm Naoma. What brings you here today?", "audio_offset_ms": 0},
        {"role": "user", "content": "We're looking at AI for our sales team.", "audio_offset_ms": 5230},
        {"role": "assistant", "content": "Great — how large is the team?", "audio_offset_ms": 9100}
      ],
      "summary": "Jane from Acme evaluated Naoma for a 25-person sales team.",
      "evaluation": {
        "language": "en",
        "customer_name": "Jane Doe",
        "qualification": {
          "status": "qualified",
          "reasoning": "Jane manages a 25-person sales team and confirmed budget approval."
        },
        "questions": {
          "team_size": {"was_asked": true, "was_answered": true, "answer": "About 25 people."}
        },
        "insights": {
          "buying_timeline": {"value": "Decision expected this quarter", "evidence": "We want something running before the end of Q3."}
        },
        "prospect_questions": [
          {"question": "Does it integrate with HubSpot?", "answer": "Yes, via webhooks."}
        ],
        "objections": [],
        "prospect_summary": "Thanks for the chat, Jane! We covered your team setup and booked a demo.",
        "summary": "Jane Doe evaluated Naoma for inbound qualification; qualified with a Q3 timeline."
      },
      "email": "jane@acme.com",
      "email_verified": true,
      "duration_secs": 184,
      "created_at": "2026-07-14T10:30:00.123456Z"
    }
  ]
}

{
  "event_type": "session.evaluated",
  "timestamp": "2026-07-14T10:30:05.123456789Z",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "0d4f6f10-3f9e-4b21-9d2a-6a1b2c3d4e5f",
    "account_name": "Acme Inc",
    "client_id": "acme",
    "agent_id": "naoma_agent_4fz2k9qj1m8p7w3x",
    "agent_name": "Acme Discovery Agent",
    "metadata": {"email": "jane@acme.com", "utm_source": "linkedin"},
    "referrer": "https://acme.com/pricing",
    "is_test": false,
    "draft": false,
    "status": "processed",
    "engine": "conva",
    "external_conversation_id": null,
    "transcript": [
      {"role": "system", "content": "You are Acme's discovery agent..."},
      {"role": "assistant", "content": "Hi! I'm Naoma. What brings you here today?", "audio_offset_ms": 0},
      {"role": "user", "content": "We're looking at AI for our sales team.", "audio_offset_ms": 5230},
      {"role": "tool_call", "tool_call": {"id": "call_1", "name": "open_email_collection", "args": {}}, "audio_offset_ms": 9100},
      {"role": "tool_result", "tool_result": {"tool_call_id": "call_1", "result": {"status": "opened"}}, "audio_offset_ms": 9100},
      {"role": "assistant", "content": "Great — how large is the team?", "audio_offset_ms": 9400}
    ],
    "summary": "Jane from Acme evaluated Naoma for a 25-person sales team.",
    "evaluation": {"...": "same shape as in List Sessions"},
    "evaluation_error": null,
    "duration_secs": 184,
    "email": "jane@acme.com",
    "email_verified": true,
    "runtime_config_version_id": "7c1d2e30-aa11-4bde-8f00-112233445566",
    "runtime_config": {"...": "the agent configuration the session ran on"},
    "created_at": "2026-07-14T10:27:00.481920Z",
    "updated_at": "2026-07-14T10:30:04.912345Z"
  }
}

const crypto = require('crypto');

function verifyWebhookSignature(body, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return signature === expected;
}