API: AI Brains, bozze e il Playground

Un AI Brain contiene come l'AI vende per una creator: le sue fasi di vendita, regole e impostazioni. Modifichi una bozza, la testi nel Playground, poi la pubblichi; il brain live cambia solo alla pubblicazione. Un brain è collegato a una sola creator e può essere riutilizzato dai suoi account.

Endpoints #

L'oggetto brain #

{
  "id": "br_lea_main",
  "name": "Lea · main",
  "creator_id": "cr_lea",
  "version": 12,
  "published_at": "2026-10-04T21:10:00Z",
  "has_draft": true,
  "accounts": ["acc_1001", "acc_1004"],
  "phases": [
    { "key": "warm_up", "name": "Warm up", "enabled": true },
    { "key": "first_offer", "name": "First offer", "enabled": true }
  ]
}

Brain #

Elenca brain #

GET /brains · can_engine

curl "https://api.lanachat.ai/v1/brains?creator_id=cr_lea" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

{
  "data": [
    { "id": "br_lea_main", "name": "Lea · main", "creator_id": "cr_lea", "version": 12, "published_at": "2026-10-04T21:10:00Z", "has_draft": true, "accounts": ["acc_1001", "acc_1004"], "phases": [ { "key": "warm_up", "name": "Warm up", "enabled": true }, { "key": "first_offer", "name": "First offer", "enabled": true } ] }
  ],
  "next_cursor": null
}

Crea un brain #

POST /brains · can_engine

curl -X POST https://api.lanachat.ai/v1/brains \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"creator_id": "cr_lea", "name": "Lea · TikTok test", "copy_from": "br_lea_main"}'

La risposta è il nuovo brain (201). Un copy_from che non esiste in questo workspace risponde 404.

Ottieni un brain #

GET /brains/{id} · can_engine

curl https://api.lanachat.ai/v1/brains/br_lea_main \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

La risposta è la versione live, come l'oggetto brain. La bozza si legge con GET /brains/{id}/draft.

Rinomina o ricollega un brain #

PATCH /brains/{id} · can_engine

curl -X PATCH https://api.lanachat.ai/v1/brains/br_lea_main \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Lea · main FR"}'

La risposta è il brain aggiornato.

Elimina un brain #

DELETE /brains/{id} · can_engine

curl -X DELETE https://api.lanachat.ai/v1/brains/br_lea_old \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Un brain ancora usato da un account viene rifiutato (409): collega prima quegli account a un altro brain.

Bozze e pubblicazione #

Leggi la bozza #

GET /brains/{id}/draft · can_engine

curl https://api.lanachat.ai/v1/brains/br_lea_main/draft \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

La risposta è la bozza corrente (fasi, regole e impostazioni) e cosa differisce dalla versione live.

Modifica la bozza #

PATCH /brains/{id}/draft · can_engine

curl -X PATCH https://api.lanachat.ai/v1/brains/br_lea_main/draft \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"settings": {"first_offer_after_messages": 6, "max_discount_percent": 20}}'

Cambiano solo i campi che invii. Il brain live non si modifica finché non pubblichi.

Elimina la bozza #

DELETE /brains/{id}/draft · can_engine

curl -X DELETE https://api.lanachat.ai/v1/brains/br_lea_main/draft \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

La bozza viene eliminata; la versione live resta com'è e has_draft diventa false.

Pubblica la bozza #

POST /brains/{id}/publish · can_publish

curl -X POST https://api.lanachat.ai/v1/brains/br_lea_main/publish \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

{ "id": "br_lea_main", "version": 13, "published_at": "2026-10-06T14:20:03Z", "has_draft": false }

La bozza diventa live su ogni account collegato. Pubblicare senza bozza risponde 409. I profili AI avanzati richiedono permessi proprietario, come nella Console. Un webhook brain.published avvisa il tuo server.

Versioni #

Elenca versioni #

GET /brains/{id}/versions · can_engine

curl https://api.lanachat.ai/v1/brains/br_lea_main/versions \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

La risposta elenca le versioni pubblicate, dalla più recente, paginata.

Ripristina una versione #

POST /brains/{id}/versions/{version}/restore · can_engine

curl -X POST https://api.lanachat.ai/v1/brains/br_lea_main/versions/11/restore \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

La vecchia versione viene copiata nella bozza. Per i fan non cambia nulla finché non pubblichi. Una versione sconosciuta risponde 404.

Playground #

Il Playground parla con la bozza, mai con un fan. Nulla viene inviato su Telegram e nulla viene venduto.

Invia un messaggio di test #

POST /playground/{brain_id}/message · can_engine

curl -X POST https://api.lanachat.ai/v1/playground/br_lea_main/message \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"text": "hey, are you real?", "fan": {"language": "en", "is_new": true}}'

{
  "reply": { "text": "Haha very real, just slow at typing 🙈 where are you from?", "media": [] },
  "phase": "warm_up",
  "explain": "Phrase bank answer for \"Are you a bot?\", then a question to keep the fan talking."
}

• reply è ciò che l'AI invierebbe: testo e media.
• phase è la fase di vendita in cui si trova l'AI.
• explain spiega in parole semplici perché ha risposto così.

Ogni chiamata continua la stessa conversazione di test.

Ricomincia la conversazione di test #

DELETE /playground/{brain_id}/session · can_engine

curl -X DELETE https://api.lanachat.ai/v1/playground/br_lea_main/session \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Il prossimo messaggio di test inizia una nuova conversazione, come un fan nuovo.