API: skrypty, kroki i foldery

Skrypt to ustalona sekwencja kroków dla jednej twórczyni: każdy krok to tekst, opcjonalnie media z Vault, cena w Stars i czas oczekiwania przed kolejnym krokiem. Skrypty są w folderach. Jeden skrypt na twórczynię może być oznaczony jako first: uruchamia się przy nowych rozmowach.

Endpoints #

Obiekt skryptu #

{
  "id": "scr_204",
  "creator_id": "cr_lea",
  "name": "Welcome message",
  "goal": "First sale within the first day",
  "folder_id": "fld_12",
  "active": true,
  "first": true,
  "account_ids": null,
  "steps": [
    { "id": "st_1", "name": "Hello", "text": "Hey you 😊 glad you found me here", "media": [], "wait_minutes": 0, "pricing": { "mode": "free" } },
    { "id": "st_2", "name": "First set", "text": "Made this one this morning…", "media": ["med_5521", "med_5522"], "wait_minutes": 20, "pricing": { "mode": "paid", "stars": 250, "discount_stars": 200 } }
  ],
  "created_at": "2026-09-30T10:00:00Z",
  "updated_at": "2026-10-05T16:22:00Z"
}

Każdy krok zawiera:

Ustawienie first: true w skrypcie usuwa to oznaczenie z innych skryptów twórczyni.

Skrypty #

Lista skryptów #

GET /scripts · can_setup

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

Odpowiedź to strona z obiektami skryptów w data, z next_cursor. Bez creator_id API zwraca 400.

Utwórz skrypt #

POST /scripts · can_setup

curl -X POST https://api.lanachat.ai/v1/scripts \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"creator_id": "cr_lea", "name": "Win back", "steps": [{"name": "Miss you", "text": "Hey stranger, where did you go?", "wait_minutes": 0, "pricing": {"mode": "free"}}]}'

{
  "id": "scr_231",
  "creator_id": "cr_lea",
  "name": "Win back",
  "goal": null,
  "folder_id": null,
  "active": true,
  "first": false,
  "account_ids": null,
  "steps": [ { "id": "st_1", "name": "Miss you", "text": "Hey stranger, where did you go?", "media": [], "wait_minutes": 0, "pricing": { "mode": "free" } } ],
  "created_at": "2026-10-06T14:30:00Z",
  "updated_at": "2026-10-06T14:30:00Z"
}

Odpowiedź to nowy skrypt (201), aktywny, nie first, bez folderu. Id medium z Vault innej twórczyni jest odrzucane (400).

Pobierz skrypt #

GET /scripts/{id} · can_setup

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

Odpowiedź to obiekt skryptu ze wszystkimi krokami.

Zastąp skrypt #

PUT /scripts/{id} · can_setup

Wyślij cały skrypt: name, steps, folder_id i account_ids, jak w Utwórz skrypt. Kroki pominięte zostaną usunięte.

curl -X PUT https://api.lanachat.ai/v1/scripts/scr_231 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Win back", "folder_id": "fld_12", "account_ids": null, "steps": [{"name": "Miss you", "text": "Hey stranger, where did you go?", "wait_minutes": 0, "pricing": {"mode": "free"}}, {"name": "Gift", "text": "Kept this one for you", "media": ["med_5522"], "wait_minutes": 30, "pricing": {"mode": "paid", "stars": 200}}]}'

Odpowiedź to zaktualizowany skrypt. Pusta tablica account_ids zwraca 400: użyj null dla wszystkich kont.

Włącz, oznacz jako first, przenieś #

PATCH /scripts/{id} · can_setup

curl -X PATCH https://api.lanachat.ai/v1/scripts/scr_231 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first": true}'

Odpowiedź to zaktualizowany skrypt. Poprzedni skrypt first tej twórczyni traci oznaczenie first.

Duplikuj skrypt #

POST /scripts/{id}/duplicate · can_setup

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

Odpowiedź to kopia (201). Kopia nigdy nie jest first.

Usuń skrypt #

DELETE /scripts/{id} · can_setup

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

Foldery #

Lista folderów #

GET /scripts/folders · can_setup

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

Utwórz folder #

POST /scripts/folders · can_setup

curl -X POST https://api.lanachat.ai/v1/scripts/folders \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"creator_id": "cr_lea", "name": "Win back"}'

Zmień nazwę folderu #

PATCH /scripts/folders/{id} · can_setup

curl -X PATCH https://api.lanachat.ai/v1/scripts/folders/fld_12 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Welcome"}'

Usuń folder #

DELETE /scripts/folders/{id} · can_setup

curl -X DELETE https://api.lanachat.ai/v1/scripts/folders/fld_12 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Skrypty z folderu zostają i trafiają do "No folder".

Uruchom skrypt w rozmowie #

POST /conversations/{id}/script · can_chat

Uruchamia skrypt w rozmowie z jednym fanem: state zmienia się na script do końca skryptu. Treść, przykład i zasady znajdziesz w Conversations.