Ringostat
Вхід

Запуск обдзвону кодом (API)

~6 хв · Наскрізний приклад: створити → додати номери → запустити → результати.

Наскрізний приклад через MCP. Виклики — конвертом tools/call після initialize (див. «Авторизація»).

1. Створіть кампанію — voiceagent_create_campaign з "pause": true. Нова кампанія одразу активна: без pause вона почне дзвонити, щойно ви додасте номери. У відповіді — об'єкт кампанії, його id — це campaignID для наступних викликів. type — тип кампанії, як в інтерфейсі: simple («Інформаційний дзвінок»), aisdr («Голосовий агент») або multi_question_dtmf («Інтерактивне опитування»).

{"name":"voiceagent_create_campaign","arguments":{
  "projectID":217, "name":"Підтвердження замовлень", "type":"simple",
  "language":"uk-UA", "text":"Вітаю! Підтверджую ваше замовлення. Все вірно?",
  "voiceName":"<VoiceID з voiceagent_get_voices>", "endpoint":"<ваш_SIP>",
  "maxAttempts":3, "simultaneousCalls":3,
  "webhookURL":"https://your-app.example/webhooks/ringostat", "pause":true }}

2. Додайте номери — voiceagent_add_numbers.

{"name":"voiceagent_add_numbers","arguments":{
  "projectID":217, "campaignID":799,
  "numbers":[ { "phone":"+380671234567", "customFields":{"name":"Іван"} } ] }}

3. Запустіть — voiceagent_update_campaign_field (field=paused, value="false").

{"name":"voiceagent_update_campaign_field","arguments":{
  "projectID":217, "campaignID":799, "field":"paused", "value":"false" }}

4. Результати — voiceagent_get_campaign_stats (лічильники) і voiceagent_list_campaign_numbers (статус і ID кожного номера); стенограма й звіт одного дзвінка — voiceagent_get_call_detail з numberID = цей ID; або одразу через вебхуки.