Skip to main content

Adding phone numbers from CRM systems

The following Calls API methods are simplified methods for adding a single phone number to the call campaign:

  • GET https://ds.tovie.ai/api/crmCalls/campaign/{token}/addPhone
  • POST https://ds.tovie.ai/api/crmCalls/campaign/{token}/addPhone
  • GET https://ds.tovie.ai/api/crmCalls/campaign/{token}/test/addPhone

In contrast to the main method for adding phone numbers to the campaign, POST /addPhones, they accept parameters in the URL string rather than in the request body, and the number of supported parameters is limited.

tip
These methods are primarily intended for integrating Tovie DialogStudio calls with CRM systems.

Request parameters

You can pass the following call job settings as request URL parameters:

  • phone — the phone number to be called, required parameter.
  • gmtZone — the customer time zone, optional parameter.
tip
The same restrictions as in POST /addPhones apply to the time zone format.

Redundant numbers in call campaigns

Repeated calls to the same number are ignored if you use the following methods:

  • GET https://ds.tovie.ai/api/crmCalls/campaign/{token}/addPhone
  • POST https://ds.tovie.ai/api/crmCalls/campaign/{token}/addPhone

You can find more information about these restrictions in the main article.

If you need to make a call again (for example, to test a call campaign), use the GET https://ds.tovie.ai/api/crmCalls/campaign/{token}/test/addPhone method.

Example request

curl --request POST 'https://ds.tovie.ai/api/crmCalls/campaign/8231.7056.1b131df1/addPhone?phone=16123456789&gmtZone=+03:30&name=Alex' \
--header 'Content-Type: application/x-www-form-urlencoded'

The response to this request will be a string containing the created call job ID.