Автодозвон

Выполняет по списку номеров звонок с объявлением, IVR или опросом; возвращает результат и нажатия клавиш. Ключ интеграции (bt_…, область autocall).

Метод: https://api.buluthat.com/api/autocall.php?action=<işlem>

Типичный сценарий:

1. media          -> anons id'sini al (ya da tts_template kullan)
2. trunks         -> çıkış hattının slug'ını al
3. create_campaign -> status "draft", digit_labels ile anket seçenekleri
4. add_leads      -> numaraları partiler hâlinde gönder
5. start          -> kampanyayı kuyruğa al
6. webhook        -> sonuçlar size gelsin (ya da results ile çekin)
7. summary        -> tuş dağılımı

GETping · media · trunks · caller_ids

GET https://api.buluthat.com/api/autocall.php?action=ping
GET https://api.buluthat.com/api/autocall.php?action=media       → [{ "id": 12, "name": "Hatırlatma anonsu" }]
GET https://api.buluthat.com/api/autocall.php?action=trunks      → çıkış hatları (slug)
GET https://api.buluthat.com/api/autocall.php?action=caller_ids  → kullanılabilir arayan numaralar

POSTcreate_campaign

curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \
  -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \
  -d '{
    "name": "Randevu hatırlatma",
    "campaign_type": "survey",
    "trunk_slug": "hat-1",
    "caller_id": "02124119610",
    "tts_enabled": true,
    "tts_template": "Merhaba {sayin}, {randevu} randevunuzu hatırlatmak için aradık. Geliyorsanız 1, iptal için 2.",
    "digit_labels": { "1": "Geliyorum", "2": "İptal" },
    "digit_destinations": { "9": "queue:4" },
    "start_time": "09:00", "end_time": "18:00",
    "weekdays": ["mon","tue","wed","thu","fri"],
    "max_channels": 3, "ring_timeout_seconds": 30,
    "retry_count": 1, "retry_delay_minutes": 30,
    "amd_enabled": true, "amd_action": "hangup",
    "webhook_url": "https://ornek.com/buluthat/sonuc",
    "webhook_secret": "gizli",
    "webhook_events": "call_finished,dtmf",
    "status": "draft",
    "leads": [ { "phone": "05551112233", "name": "Ahmet Yılmaz", "external_id": "CRM-1", "fields": { "randevu": "12 Eylül 14:00" } } ]
  }'

Обязательно: name, trunk_slug и media_file_id или tts_template. Если указаны оба, сначала воспроизводится персональное аудио, затем готовое объявление.

Ответ: { "ok": true, "data": { "id": 7, "status": "draft", … } }

POSTupdate_campaign

Частичное обновление; изменяются только переданные поля. status не отправляйте (это остановит работающую кампанию); для статуса start/pause/cancel используйте.

{ "campaign_id": 7, "max_channels": 5, "retry_count": 2 }

POSTadd_leads

Не более 5.000 записей в одном запросе. В одной кампании один и тот же номер второй раз не добавляется (duplicate).

{ "campaign_id": 7, "leads": [ { "phone": "05551112233", "name": "Ahmet Yılmaz", "external_id": "CRM-1", "fields": { "borc": "1.240 TL" } } ] }

Краткая форма: { "campaign_id": 7, "phones": ["05551112233", "05551112234"] }

Ответ: { "inserted": 2, "duplicate": 0, "invalid": 0 }

POSTrequeue_leads

Возвращает в очередь ранее набранные номера (calls сбрасывается, нажатия клавиш очищаются). Номер, который уже ожидает, не затрагивается (skipped). При напоминании о платеже используйте его, чтобы перезванивать по вашим собственным данным, а не полагаться на нажатие «оплатил».

{ "campaign_id": 7, "phones": ["05551112233"] }

POSTstart · pause · cancel

{ "campaign_id": 7 }

start ставит кампанию в очередь; звонки начинаются в пределах дневного/часового окна. Если добавить номер в завершённую кампанию, она автоматически откроется заново.

GETresults

Результат по номерам. limit (по умолчанию 200, максимум 1000), offset; фильтры status, dtmf, phone.

GET https://api.buluthat.com/api/autocall.php?action=results&campaign_id=7&dtmf=1

{
  "ok": true, "total": 512, "limit": 200, "offset": 0,
  "data": [ {
    "campaign_id": 7, "lead_id": 91, "external_id": "CRM-1",
    "phone": "05551112233", "name": "Ahmet Yılmaz",
    "status": "answered", "attempts": 1,
    "dtmf": "1", "dtmf_label": "Geliyorum", "dtmf_all": ["1"],
    "amd_result": "HUMAN", "duration_seconds": 34, "talk_seconds": 22,
    "hangup_cause": "ANSWERED",
    "started_at": "2026-09-04 10:12:03", "answered_at": "2026-09-04 10:12:11", "ended_at": "2026-09-04 10:12:33",
    "custom_fields": { "randevu": "12 Eylül 14:00" }
  } ]
}

Статусы: pending, calling, answered, machine, no_answer, busy, failed, cancelled.

GETsummary

{ "ok": true, "data": {
  "total": 512, "answered": 388, "pressed": 301, "machine": 44,
  "answer_rate": 75.8, "press_rate": 77.6, "talk_seconds": 8624, "avg_talk_seconds": 22,
  "digits": [ { "digit": "1", "label": "Geliyorum", "total": 214, "percent": 55.2 }, { "digit": "2", "label": "İptal", "total": 87, "percent": 22.4 } ]
} }

GETevents

Журнал событий кампании (originate, answered, amd, dtmf, cdr, error) — для диагностики.

Webhook

webhook_url если задан, Buluthat отправляет результат вам методом POST. События: call_finished (один раз на номер), dtmf (в момент нажатия клавиши), campaign_finished. Заголовки X-Buluthat-Event, X-Buluthat-Delivery, X-Buluthat-Signature: sha256=… (webhook_secret если задан). Тело results содержит те же поля, что и. О проверке подписи и политике повторов см. Webhook.

Персональное объявление и стоимость

Шаблон делится на постоянные и переменные части; постоянная фраза в списке из тысячи человек озвучивается один раз, одно и то же {tutar} значение второй раз не создаётся (измеренная экономия 97,9%). Передавайте значения переменных в стандартном формате ("1.000 TL" всегда писалось одинаково). Разделение «Бей/Ханым» определяется по имени автоматически; для унисекс-имён обращение остаётся пустым.

PHP-клиент

Скачанный на вкладке «Панель > Автодозвон > API» buluthat-autocall-client.php:

require_once 'buluthat-autocall-client.php';
$bt = new BuluthatAutoCall('https://api.buluthat.com', 'bt_xxx');
$k = $bt->createCampaign(['name' => 'Ödeme hatırlatma', 'campaign_type' => 'survey', 'trunk_slug' => 'hat-1',
    'tts_enabled' => true, 'tts_template' => 'Merhaba {sayin}, {tutar} tutarındaki ödemenizi hatırlatmak için aradık. Ödediyseniz 1, ödemediyseniz 2.',
    'digit_labels' => ['1' => 'Ödedim', '2' => 'Ödemedim'], 'webhook_url' => 'https://crm.example.com/buluthat-sonuc.php']);
$bt->addLeads($k['id'], [['phone' => '05551112233', 'name' => 'Burak Yılmaz', 'external_id' => 'CARI-451', 'fields' => ['tutar' => '1.000 TL']]]);
$bt->start($k['id']);

// webhook tarafı
$olay = BuluthatAutoCall::readWebhook($secret);   // imzayı doğrular
if ($olay['event'] === 'call_finished' && $olay['data']['dtmf'] === '1') { /* ödedim dedi */ }