Перейти к основному содержимому

Создать кампанию рассылки

Цель: дать агенту выйти на контакт со всеми лидами на этапе и следить за прогрессом.

Предусловия: агент в продукте, подключённый канал и лиды на целевом этапе.

# 1) Создать кампанию (стартует в статусе "draft")
curl -s https://api.ru.sance.ai/v1/outreach-campaigns/ \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{ "product_id": 42, "agent_id": 3, "name": "Q3 reactivation", "outreach_to_stage_id": 7 }'

# 2) Активировать
curl -s -X POST "https://api.ru.sance.ai/v1/outreach-campaigns/9/status/active" \
-H "Authorization: Bearer $TOKEN"

# 3) Следить за рассылкой — по одному прогону на каждого нацеленного лида
curl -s "https://api.ru.sance.ai/v1/outreach-campaigns/9/dispatch-runs" \
-H "Authorization: Bearer $TOKEN"

# 4) Заглянуть в отдельные попытки прогона
curl -s "https://api.ru.sance.ai/v1/outreach-campaigns/dispatch-runs/123/attempts" \
-H "Authorization: Bearer $TOKEN"

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

См.: POST /v1/outreach-campaigns/, POST /v1/outreach-campaigns/{id}/status/{new_status}, GET /v1/outreach-campaigns/{id}/dispatch-runs, GET /v1/outreach-campaigns/dispatch-runs/{run_id}/attempts.