Utwórz kampanię wychodzącą

POST

/v1/convai/outbound-campaigns/campaigns/submit

POST

/v1/convai/outbound-campaigns/campaigns/submit

curl -X POST https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit \
     -H "Content-Type: application/json" \
     -d '{
  "call_name": "call_name",
  "agent_id": "agent_id",
  "recipients": [
    {}
  ],
  "channel_config": {
    "channel": "phone",
    "agent_phone_number_id": "agent_phone_number_id"
  }
}'

{
  "campaign": {
    "campaign_id": "campaign_id",
    "call_name": "call_name",
    "agent_id": "agent_id",
    "channel_config": {
      "channel": "phone",
      "agent_phone_number_id": "agent_phone_number_id"
    },
    "status": "active",
    "policy": {
      "timezone": "timezone",
      "retry": {},
      "calling_periods": [
        {
          "weekdays": [
            1
          ],
          "intervals": [
            {
              "start": "start",
              "end": "end"
            }
          ]
        }
      ],
      "data_collection": {},
      "followup_context": {}
    },
    "variant": "simple",
    "created_at_unix": 1,
    "updated_at_unix": 1,
    "channel": "phone",
    "mode": "voice",
    "counts": {
      "leads": 1,
      "terminal_leads": 1,
      "open_attention": 1
    },
    "agent_name": "agent_name",
    "source": "ui",
    "outcome": {
      "type": "data_collection",
      "data_collection_id": "data_collection_id",
      "equals": [
        "equals"
      ]
    },
    "scheduled_time_unix": 1,
    "branch_id": "branch_id",
    "environment": "environment",
    "target_concurrency_limit": 1
  },
  "created": true,
  "within_calling_window": true
}

Utwórz kampanię wychodzącą, która dzwoni lub wysyła wiadomości do każdego odbiorcy z użyciem agenta, w oknach połączeń określonych przez zasady, ponawiając próby i wykonując follow-upy, jeśli zasady na to pozwalają. Dla nowej kampanii zwraca 201. Powtórzone żądanie, dopasowane przez idempotency_key lub treść, zwraca istniejącą kampanię z created ustawionym na false.

Żądanie

This endpoint expects an object.

call_namestringWymagany1-256 characters

Nazwa kampanii.

agent_idstringWymagany1-256 characters

Agent wykonujący połączenia.

recipientslist of objectsWymagany

Do kogo dzwonić. Każdy odbiorca staje się leadem kampanii.

channel_configobjectWymagany

scheduled_time_unixintegerOpcjonalny>=0

Kiedy rozpocząć dzwonienie; pomiń, aby rozpocząć teraz. Połączenia i tak czekają na kolejne okno połączeń.

timezonestringOpcjonalny

Strefa czasowa IANA, w której należy odczytywać okna połączeń, zastępująca tę z zasad.

branch_idstringOpcjonalny<=256 characters

Gałąź agenta, z którą należy wykonać połączenie.

environmentstringOpcjonalny<=256 characters

Środowisko, w którym należy rozwiązać zmienne środowiskowe agenta.

target_concurrency_limitintegerOpcjonalny>=1

Maksymalna liczba połączeń do wykonania jednocześnie.

idempotency_keystringOpcjonalny1-256 characters

Umożliwia bezpieczne ponowienie żądania: powtórzenie z tym samym kluczem zwraca utworzoną kampanię.

outcomeobjectOpcjonalny

Wynik uznawany za sukces połączeń kampanii.

policyobjectOpcjonalny

Zasady do zapisania w migawce kampanii. Jeśli są ustawione, mają pierwszeństwo przed domyślnymi zasadami workspace’u i nadpisaniami agenta; jeśli ich nie podano, musi istnieć konfiguracja workspace’u, która dostarczy zasady.

variantenumOpcjonalny

simple wykonuje jedną próbę dla każdego odbiorcy, z zawsze aktywnymi oknami połączeń i bez zbierania danych; nie można go łączyć z policy. advanced używa policy lub konfiguracji workspace’u i jest domyślny dla kampanii telefonicznych.

Dozwolone wartości:

Odpowiedź

Pomyślna odpowiedź

campaignobject

createdboolean

False, gdy żądanie powtarza wcześniejsze i zwraca utworzoną przez nie kampanię.

within_calling_windowboolean

Czy dzwonienie zaczyna się od razu, a nie w następnym oknie połączeń.

Błędy

422

Outbound Campaigns Create Request Unprocessable Entity Error

Nagłówki

Żądanie

Odpowiedź

Błędy