Example

This is an example site. Acacia Lane Hotel is fictional, and the answers are pre-written samples, not live. It shows Ask Addis as a custom UI on the API on a partner's website.

All examples Add it to your site →
✦Acacia Lane Book a stay
The Acacia Concierge

Our own chat,
Ask Addis's answers

This concierge is the hotel's own design: its header, bubbles and result tiles. Behind it, the page calls POST /v1/chat and draws the streamed text and cards itself.

The greeting and suggestions come from GET /v1/config, so it matches the other Ask Addis surfaces.

Acacia ConciergeAsk about the city, any time
Powered by Ask Addis

Answers can be wrong. Questions are saved anonymously to improve the service.

How this page uses Ask Addis

No widget: the page sends the recent history to POST /v1/chat and reads the streamed events, one JSON object per line. View this page's source for the full script.

const res = await fetch("https://ASK_ADDIS_HOST/v1/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-Ask-Addis-Key": "YOUR_KEY" },
  body: JSON.stringify({ messages, client: { surface: "acacia-concierge", visitor } }),
});
// then, line by line: {"type":"text"} · {"type":"cards"} · {"type":"error"} · {"type":"done"}

On this example site the answers are saved samples. On your site, with your key, the same code gives live answers.