Put your Lina inside your own software.

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.linasystems.org/v1", api_key=os.environ["LINA_API_KEY"])
reply = client.chat.completions.create(
    model="lina",
    messages=[{"role": "user", "content": "What are your opening hours?"}],
)
print(reply.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.linasystems.org/v1", apiKey: process.env.LINA_API_KEY });
const reply = await client.chat.completions.create({
  model: "lina",
  messages: [{ role: "user", content: "What are your opening hours?" }],
});
console.log(reply.choices[0].message.content);

A webhook is told that something happened, never what was said. The body names the event and the ids involved, so you fetch the rest with the API, within the scopes the key was given. Nothing is delivered until the organization switches delivery on, which is off when a space starts: GET /webhooks reports it as delivery_enabled, and Settings, then API access, has a Turn on delivery button. The events:

• chat.handoff_requested
• call.received
• call.escalated
• text.received
• form.submitted
• email.received
• knowledge.updated
• usage.allowance_reached

Each delivery carries X-Lina-Signature: t=<unix seconds>,v1=<hex>, where v1 is the HMAC-SHA256 of <t>.<body> with the webhook’s signing secret. Refuse a delivery whose t is more than 5 minutes old. Answer with any 2xx. A delivery is tried once, so fetch anything you missed from the API.

import hashlib
import hmac
import time


def verify(secret, header, body, tolerance=300):
    parts = dict(piece.split("=", 1) for piece in header.split(","))
    stamp = int(parts["t"])
    if abs(time.time() - stamp) > tolerance:
        return False
    message = f"{stamp}.".encode() + body
    expected = hmac.new(secret.encode(), message, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts["v1"])

Every failure has the same shape. Branch on code, and quote request_id when you write to support.

{"error": {"message": "That API key is not valid. It may be mistyped, revoked or expired.",
           "type": "authentication_error", "code": "invalid_api_key", "param": null,
           "request_id": "0123456789abcdef"}}