Чат и рассылки

TEASE даёт вам две поверхности для обмена сообщениями над одним подключённым аккаунтом: единые входящие DM, которые поднимают наверх фанатов, ждущих ответа, и рассылки — размеренные, безопасные для бана массовые кампании с предпросмотром аудитории и ROI по каждой кампании. Обе читаются и управляются целиком через ваш ключ al_live_*.

Как всё устроено

Входящие

Входящие — это поверхность чтения. Она перечисляет диалоги, ожидающие-новейшими первыми, позволяет открыть отдельный тред вживую и возвращает предлагаемую цену для любого фаната, которому вы собираетесь выставить счёт.

Список диалогов

GET /api/admin/inbox/conversations

Возвращает ваши треды, упорядоченные так, что фанаты, ждущие ответа, поднимаются наверх (самое долгое ожидание первым), затем всё остальное по самой недавней активности.

curl "https://app.tease.link/api/admin/inbox/conversations?status=open&limit=100" \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch(
  'https://app.tease.link/api/admin/inbox/conversations?status=open&limit=100',
  { headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` } },
);
const { conversations, count } = await res.json();

import os, requests

res = requests.get(
    "https://app.tease.link/api/admin/inbox/conversations",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    params={"status": "open", "limit": 100},
)
data = res.json()

Query-параметры

Ответ

{
  "conversations": [
    {
      "fan_id": "f_91kd2",
      "of_account_id": "acct_main",
      "platform": "of",
      "last_msg_ts": 1751290800,
      "last_inbound_ts": 1751290800,
      "last_outbound_ts": 1751280000,
      "unread_count": 2,
      "assigned_operator_id": null,
      "status": "open",
      "waiting_seconds": 10800
    }
  ],
  "count": 1
}

Прочитать тред

GET /api/admin/inbox/conversations/{fan_id}/messages

Открывает один тред и возвращает его сообщения, прочитанные вживую из вашего подключённого аккаунта и нормализованные к стабильной форме. Поскольку тела не хранятся, это всегда отражает истинное текущее состояние чата.

curl "https://app.tease.link/api/admin/inbox/conversations/f_91kd2/messages?limit=50" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Ответ

{
  "fan_id": "f_91kd2",
  "error": false,
  "messages": [
    {
      "msg_id": "m_88210",
      "ts": 1751290800,
      "direction": "in",
      "text": "hey is the new set out yet?",
      "price_cents": 0,
      "is_opened": true,
      "can_purchase": false,
      "media": []
    }
  ]
}

Назначить цену фанату

GET /api/admin/chatters/fan-pricing?fan_id={fan_id}

Возвращает предлагаемую цену PPV и тир трат для одного фаната, выведенные из собственной истории покупок этого фаната на вашем аккаунте. Входящие вызывают это, когда вы собираетесь отправить платное сообщение, чтобы цена подходила фанату перед вами.

curl "https://app.tease.link/api/admin/chatters/fan-pricing?fan_id=f_91kd2" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Ответ

{
  "fan_id": "f_91kd2",
  "tier": "medium",
  "suggested_cents": 2000,
  "min_cents": 1400,
  "max_cents": 3200
}

Очередь ожидающих фанатов

GET /api/admin/chatters/waiting

Командно-ориентированный срез того же SLA: открытые треды с непрочитанными сообщениями фанатов, самое долгое ожидание первым, с приоритетом для китов, чтобы высокоценный фанат не сидел в очереди.

curl "https://app.tease.link/api/admin/chatters/waiting?min_wait_min=5&limit=50" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Ответ

{
  "waiting": 1,
  "longest_wait_min": 180,
  "fans": [
    {
      "fan_id": "f_91kd2",
      "of_account_id": "acct_main",
      "unread_count": 2,
      "last_inbound_ts": 1751290800,
      "minutes_waiting": 180,
      "assigned_operator_id": null,
      "lifetime_net_cents": 6400,
      "tier": "medium"
    }
  ]
}

Отправить DM (Beta)

POST /api/admin/inbox/send

Каждый вызов скринится, затем маршрутизируется через gated-движок. Ответ говорит вам ровно, что произошло, единым вердиктом status:

curl -X POST https://app.tease.link/api/admin/inbox/send \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "fan_id": "f_91kd2",
        "text": "new set just dropped — want it?",
        "media_ids": ["vault_55012"],
        "price_cents": 2000
      }'

Параметры тела

Ответ

{
  "status": "shadow",
  "firewall": {
    "state": "ok",
    "reasons": [],
    "policy_version": "v3"
  },
  "outcome": {
    "mode": "shadow",
    "ok": true,
    "result": "shadow"
  }
}

Рассылки

Рассылка — это кампания: выберите аудиторию, напишите сообщение, просмотрите охват, затем запланируйте её в размеренный план отправок. Вы строите и осматриваете кампании через API; воркер доставки, который опустошает план, gated (см. ниже).

Режимы кампании

Задайте mode, когда создаёте кампанию. Четыре режима определяют, как выбирается аудитория и как секвенируются отправки.

Создать кампанию

POST /api/admin/broadcasts

curl -X POST https://app.tease.link/api/admin/broadcasts \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "June drop",
        "mode": "drip",
        "audience": { "tier": ["medium", "large", "whale"] },
        "message": {
          "steps": [
            { "text": "new set is live", "ppv_cents": 0 },
            { "text": "still time to grab it", "ppv_cents": 2500 }
          ]
        },
        "schedule": {}
      }'

const res = await fetch('https://app.tease.link/api/admin/broadcasts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'June drop',
    mode: 'drip',
    audience: { tier: ['medium', 'large', 'whale'] },
    message: {
      steps: [
        { text: 'new set is live', ppv_cents: 0 },
        { text: 'still time to grab it', ppv_cents: 2500 },
      ],
    },
    schedule: {},
  }),
});
const { id } = await res.json();

import os, requests

res = requests.post(
    "https://app.tease.link/api/admin/broadcasts",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    json={
        "title": "June drop",
        "mode": "drip",
        "audience": {"tier": ["medium", "large", "whale"]},
        "message": {"steps": [
            {"text": "new set is live", "ppv_cents": 0},
            {"text": "still time to grab it", "ppv_cents": 2500},
        ]},
        "schedule": {},
    },
)
campaign_id = res.json()["id"]

Параметры тела

Ответ — это id новой кампании:

{ "id": 42 }

Перечислите кампании с GET /api/admin/broadcasts, а прочитайте одну с GET /api/admin/broadcasts/{campaign_id} (см. ROI & drip-воронка). Отредактируйте черновик с PATCH /api/admin/broadcasts/{campaign_id}.

Просмотреть аудиторию

POST /api/admin/broadcasts/preview

Перед планированием просмотрите охват. Предпросмотр разрешает только счётчики и гистограмму тиров — он ничего не записывает и не возвращает никаких PII: ни id фанатов, ни имён, только сколько фанатов подходит.

curl -X POST https://app.tease.link/api/admin/broadcasts/preview \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "audience": { "tier": ["medium", "large", "whale"] } }'

Ответ

{
  "matched": 1840,
  "selected": 1720,
  "histogram": {
    "medium": 1100,
    "large": 480,
    "whale": 140
  }
}

Запланировать кампанию (Beta)

POST /api/admin/broadcasts/{campaign_id}/schedule

Планирование разворачивает кампанию в конкретный, спланированный список отправок 1-на-1 и переводит кампанию в scheduled. Оно возвращает, сколько получателей и спланированных отправок было произведено.

curl -X POST https://app.tease.link/api/admin/broadcasts/42/schedule \
  -H "Authorization: Bearer $TEASE_API_KEY"

Ответ

{
  "campaign_id": 42,
  "recipients": 1720,
  "planned_sends": 3440,
  "histogram": { "medium": 1100, "large": 480, "whale": 140 },
  "start_ts": 1751299200
}

Вызов schedule возвращает 409, если кампания не может быть запланирована из её текущего статуса, или если у платного сообщения отсутствует его медиа.

Пауза, возобновление, отмена

После запланирования кампания управляема:

curl -X POST https://app.tease.link/api/admin/broadcasts/42/pause \
  -H "Authorization: Bearer $TEASE_API_KEY"

Каждый возвращает { "ok": true }, или 404, если кампания не существует в вашем аккаунте.

ROI и drip-воронка

GET /api/admin/broadcasts/{campaign_id}

Чтение кампании возвращает полную запись плюс два свода: подсчёт send_status и пошаговую воронку by_step — ровно то, что нужно, чтобы увидеть, как drip отваливается шаг за шагом.

{
  "id": 42,
  "title": "June drop",
  "mode": "drip",
  "status": "running",
  "recipients": 1720,
  "sent": 1610,
  "failed": 12,
  "skipped": 98,
  "purchases": 143,
  "revenue_cents": 357500,
  "send_status": {
    "sent": 1610,
    "pending": 0,
    "failed": 12,
    "skipped": 98
  },
  "by_step": [
    { "step": 0, "total": 1720, "sent": 1700, "failed": 8, "skipped": 12 },
    { "step": 1, "total": 1720, "sent": 1100, "failed": 4, "skipped": 616 }
  ]
}

Что значит «безопасно для бана» здесь

Каждый исходящий путь в этом руководстве построен вокруг одной гарантии: вы не можете случайно получить флаг на свой аккаунт через TEASE. Качественно это значит, что отправки скринятся на контент перед движением, доставляются в человекоподобном темпе с естественными интервалами, придерживаются во время тихих часов и маршрутизируются через gate, который выключен по умолчанию. Точные правила темпа, тайминга и скрининга являются частью слоя безопасности и намеренно не публикуются — контракт, под который вы строите, — это вердикт (blocked / shadow / sent) и статус кампании, а не механизм за ними.

Дальнейшие шаги

• Смарт-ссылки — отслеживаемые ссылки воронки и поссылочная выручка.
• Атрибуция — выручка по источнику, стране и фанату.
• Аутентификация — выпустите scoped-ключ al_live_*.
• Справочник API — каждый endpoint входящих и рассылок.