İçeriğe geç
Geliştiriciler

Endpoint'ler

Calls

AI phone calls placed by the Coordinator: history, summaries, transcripts and new calls.

Yollar temel URL'ye göredir. Her kart, çağrının gerektirdiği izni ve her parametreyi türü ve sınırlarıyla listeler.

GET
/calls

List calls, newest first. Summaries and transcripts are left out of the list.

İzin: call_agent
Sayfalı

Sorgu parametreleri

  • directionisteğe bağlıenum

    Call direction.

    İzin verilen değerler:inboundoutbound

  • outcomeisteğe bağlıstring

    Call outcome, up to 50 characters.

  • contact_idisteğe bağlıinteger

    Calls with this contact.

  • fromisteğe bağlıstring (ISO 8601 date-time with offset)

    Calls created at or after this time.

  • toisteğe bağlıstring (ISO 8601 date-time with offset)

    Calls created at or before this time.

GET
/calls/:id

Retrieve a call with its outcome, summary and transcript.

İzin: call_agent

Yol parametreleri

  • idzorunlustring

    Call ID (a UUID).

POST
/calls

Have the AI call one person. Send exactly one of contact_id or phone.

İzin: call_agent

JSON gövdesi

  • contact_idisteğe bağlıinteger

    The contact to call.

  • phoneisteğe bağlıstring (E.164)

    Number to call, e.g. +14155550123. A contact is found or created for it.

  • template_idisteğe bağlıstring

    A call template of this workspace. Send template_id or instructions.

  • instructionsisteğe bağlıstring

    What the AI should achieve on the call, 1–8,000 characters. Used when no template is given.

  • purposeisteğe bağlıstring

    Alias of instructions.

  • channel_idisteğe bağlıinteger

    The phone or WhatsApp channel to call from (see GET /channels). It must be able to place outbound calls.

  • scheduled_atisteğe bağlıstring (ISO 8601 date-time with offset)

    Call later instead of now.

  • Answers 201 with the queued call (status "pending").
  • 403 coordinator_disabled until the Coordinator is enabled for the workspace; 422 number_blocked for a number on the call blocklist; 422 do_not_call for a Do-Not-Call contact; 422 channel_not_connected when no channel can place the call.
POST
/calls/queue

Queue AI calls to several contacts.

İzin: call_agent

JSON gövdesi

  • contact_idszorunluarray of integers

    1–500 contact IDs.

  • template_idisteğe bağlıstring

    A call template of this workspace. Send template_id or instructions.

  • instructionsisteğe bağlıstring

    What the AI should achieve on the call, 1–8,000 characters. Used when no template is given.

  • purposeisteğe bağlıstring

    Alias of instructions.

  • channel_idisteğe bağlıinteger

    The phone or WhatsApp channel to call from (see GET /channels). It must be able to place outbound calls.

  • scheduled_atisteğe bağlıstring (ISO 8601 date-time with offset)

    Call later instead of now.

  • Answers 201 with the queued calls plus queued, skipped_do_not_call and skipped_not_found counts.
DELETE
/calls/queue/:id

Cancel a queued call that has not started yet.

İzin: call_agent

Yol parametreleri

  • idzorunlustring

    Queued call ID.