Skapa en utgående kampanj

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
}

Skapa en utgående kampanj som ringer upp eller skickar meddelanden till varje mottagare med agenten, inom policyns samtalsfönster, med nya försök och uppföljningar enligt vad som tillåts. Returnerar 201 för en ny kampanj. En upprepad begäran, som matchas via idempotency_key eller annars via sin brödtext, returnerar den befintliga kampanjen med created satt till false.

Förfrågan

This endpoint expects an object.

call_namestringObligatorisk1-256 characters

Kampanjens namn.

agent_idstringObligatorisk1-256 characters

Agenten som genomför samtalen.

recipientslist of objectsObligatorisk

Vem som ska ringas. Varje mottagare blir ett lead i kampanjen.

channel_configobjectObligatorisk

scheduled_time_unixintegerValfri>=0

När uppringningen ska börja; utelämna för att börja nu. Samtal väntar fortfarande på nästa tidsfönster för uppringning.

timezonestringValfri

IANA-tidszon att läsa samtalsfönstren i, som åsidosätter policyns.

branch_idstringValfri<=256 characters

Agentgrenen att ringa med.

environmentstringValfri<=256 characters

Miljön där agentens miljövariabler ska lösas.

target_concurrency_limitintegerValfri>=1

Det högsta antalet samtal att genomföra samtidigt.

idempotency_keystringValfri1-256 characters

Gör begäran säker att försöka igen: en upprepning med samma nyckel returnerar kampanjen den skapade.

outcomeobjectValfri

Resultatet som räknas som lyckat för kampanjens samtal.

policyobjectValfri

Policy att spara som en ögonblicksbild för kampanjen. När den anges har den företräde framför arbetsytans standard och eventuella åsidosättningar per agent; när den utelämnas måste arbetsytans konfiguration finnas och tillhandahåller policyn.

variantenumValfri

simple gör ett försök per mottagare med alltid öppna samtalsfönster och utan att samla in något, och kan inte kombineras med policy. advanced använder policy eller arbetsytans konfiguration och är standard för telefonkampanjer.

Tillåtna värden:

Svar

Lyckat svar

campaignobject

createdboolean

False när begäran upprepade en tidigare begäran och returnerade dess kampanj.

within_calling_windowboolean

Om uppringningen börjar direkt i stället för vid nästa tidsfönster för uppringning.

Fel

422

Outbound Campaigns Create Request Unprocessable Entity Error

Headers

Förfrågan

Svar

Fel