Ringostat
Zaloguj

Uruchamianie obdzwaniania z kodu (API)

~6 min · Pełny przykład: utwórz → dodaj numery → uruchom → wyniki.

Pełny przykład przez MCP. Wywołania idą w kopercie tools/call po initialize (zob. „Autoryzacja”).

1. Utwórz kampanię — voiceagent_create_campaign z "pause": true. Nowa kampania jest od razu aktywna: bez pause zacznie dzwonić, gdy tylko dodasz numery. Odpowiedź to obiekt kampanii; jego id to campaignID do kolejnych wywołań. type to typ kampanii, jak w interfejsie: simple („Połączenie informacyjne”), aisdr („Agent głosowy”) albo multi_question_dtmf („Ankieta interaktywna”).

{"name":"voiceagent_create_campaign","arguments":{
  "projectID":217, "name":"Potwierdzanie zamówień", "type":"simple",
  "language":"pl-PL", "text":"Dzień dobry! Dzwonię, aby potwierdzić Twoje zamówienie. Czy wszystko się zgadza?",
  "voiceName":"<VoiceID z voiceagent_get_voices>", "endpoint":"<twój_SIP>",
  "maxAttempts":3, "simultaneousCalls":3,
  "webhookURL":"https://your-app.example/webhooks/ringostat", "pause":true }}

2. Dodaj numery — voiceagent_add_numbers.

{"name":"voiceagent_add_numbers","arguments":{
  "projectID":217, "campaignID":799,
  "numbers":[ { "phone":"+48512345678", "customFields":{"name":"Jan"} } ] }}

3. Uruchom — voiceagent_update_campaign_field (field=paused, value="false").

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

4. Wyniki — voiceagent_get_campaign_stats (liczniki) i voiceagent_list_campaign_numbers (status i ID każdego numeru); transkrypcja i raport jednego połączenia — voiceagent_get_call_detail z numberID = tym ID; albo od razu przez webhooki.