{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/en/telephony/calls_api/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"79caed8a-9296-55be-b528-b91199e36edc","excerpt":"Calls API The JAICP platform provides the Calls API to work with telephony. The API provides the following capabilities: Adding phone numbers with parameters to…","html":"

Calls API

\n
\n

The JAICP platform provides the Calls API to work with telephony.

\n

The API provides the following capabilities:

\n\n

Before starting your work with the Calls API, you need to:

\n
    \n
  1. Configure telephony.
    2. \n
  2. Connect a telephone channel.
    3. \n
  3. Create a voice broadcast.
    4. \n
\n
\n

API methods

\n

A detailed description of the Calls API: methods, request parameters, response formats, examples, returned errors >

\n

Access control is checked by the broadcast token only.

\n

The API provides the following methods:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
MethodDescription
POST https://<host_name>/api/calls/campaign/{token}/addPhonesAdding phone numbers with parameters to the broadcast.
POST https://<host_name>/api/calls/campaign/{token}/getReportObtaining a JSON report via a call task ID or via a phone number.
POST https://<host_name>/api/calls/campaign/{token}/callJob/cancelCanceling new calls to a phone number or call task ID.

Please note that you can only cancel calls to numbers that are added using the Calls API.
POST https://<host_name>/api/calls/campaign/{token}/control/startStarting a new voice broadcast.
POST https://<host_name>/api/calls/campaign/{token}/control/pausePausing a voice broadcast.
POST https://<host_name>/api/calls/campaign/{token}/control/resumeResuming a paused voice broadcast.
POST https://<host_name>/api/calls/campaign/{token}/control/stopStopping a voice broadcast.
\n
\n\n

For example, for https://zb04.just-ai.com/ the method for phone number addition will have the following form:

\n
https://zb04.just-ai.com/api/calls/campaign/123456.789.mBoMyfZLZqKHIPKjFjWYfRw9hgfIV9InFC4bHGVw5ND/addPhones
\n
\n\n
\n

When adding a phone number to a specific broadcast queue, a call task with a unique ID is created. Here, if this phone number is added to this broadcast again, a new call task with another ID will be created.

\n
\n

Note that the report about the calls completed will contain information about call date, duration and result as well as all data written to the script by the method $dialer.reportData($header, $value, $order).

\n
\n

Defining a call policy via the Calls API

\n

You can configure custom calling parameters when you use API to add a number to a calling campaign.

\n

To do so, pass the CallJobParameters parameters in the query body when you invoke the addPhones method.

\n

If no parameters are passed, the number is added to the queue and calls are made as usual. If you add a custom policy number, it gets higher priority than other numbers according to the calling policy.

\n

Learn more about calling policies

\n
\n

Call statuses

\n

In the API response, the field jobStatus describes the status of the number for each call at the time of report generation.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Значение поляОписание
longСallWithResultA result has been set after the call completion.
longCallWithNoResultNo result has been set after the call completion.
noAnswerNo subscriber response has been detected for all call attempts.
plannedThe call is currently queued, for example, because all the lines are busy now.
notDoneThis status will be set if the broadcast has been completed but no calls were made. For example, the broadcast was completed manually.
inProcessCall attempt or conversation with a subscriber is in progress.
onRetryA retry.
canceledThe status will be set if the calls were canceled via Calls API.
nonexistentNumberThe status will be set if the call is made to a non-existent phone number.
","frontmatter":{"title":"","description":null},"headings":[{"value":"Calls API"}]}},"pageContext":{"slug":"/docs/en/telephony/calls_api/","previous":{"fields":{"slug":"/docs/en/telephony/lists_of_numbers/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/en/telephony/call_tasks/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}