Initialize File Call Campaign
Upload CSV file to initiate bulk call campaigns
Init File Call
Details
| Description | The "Init" endpoint initializes a file call. |
|---|---|
| HTTP Method | POST |
| Endpoint URL | https://platform.innocalls.com/v1/api-gateway/call-campaign/:id/file-call/init |
| Authorization | To access the API endpoints, you need to authenticate using API keys and API secrets. The API supports Basic Authentication for authorization. You need to include your API ID as the username and your API secret as the password in the HTTP header when making requests. Replace API_ID with your API ID and API_SECRET with your API secret, separated by a colon (:). The value after Basic is the Base64 encoding of your API key and API secret concatenated with a colon. |
| Rate Limit | 3 requests per second |
Request Parameters
| Parameter | Description | Location | Constrains |
|---|---|---|---|
| id | The ID of the call campaign that the call belongs to | Path | Required |
| file | The file to be used in the process | Body | Required |
| useDefaultFlowOptions | Determines whether to use default flow options or custom options | Body | Required |
| minutesToWaitBeforeFirstTrial | The number of minutes to wait before the first trial | Body | Required if Min: 0 |
| delayMinutesBetweenTrials | The delay in minutes between each trial. | Body | Required if Min: 5 |
| trialsCount | The number of trials to be conducted. | Body | Required if Min: 1 Max: 10 |
Request Example
Example 1
curl 'https://platform.innocalls.com/api/v1/api-gateway/call-campaign/:id/file-call/init' \
--header 'Authorization: Basic <base64-encoded string apiId:apiSecret>' \
--form 'file=@"/path/to/file"' \
--form 'useDefaultFlowOptions="true"'Description
When you want to use the same call campaign flow options.
Example 2
curl 'https://platform.innocalls.com/api/v1/api-gateway/call-campaign/:id/file-call/init' \
--header 'Authorization: Basic <base64-encoded string apiId:apiSecret>' \
--form 'file=@"/path/to/file"' \
--form 'useDefaultFlowOptions="false"' \
--form 'trialsCount="2"' \
--form 'minutesToWaitBeforeFirstTrial="0"' \
--form 'delayMinutesBetweenTrials="5"'Description
When you want to customize options for trialsCount, minutesToWaitBeforeFirstTrial, and delayMinutesBetweenTrials, instead of using the same call campaign flow options.
Success Response Example
A successful response is indicated by the HTTP status code 204.
Possible Errors
| Error Code | Description |
|---|---|
| 401 Unauthorized | Invalid Credential |
| 403 Forbidden | Not Enough Permissions to access the resource |
| 429 Too Many Requests | This occurs when requests exceed the rate limit |
| 404 Not Found | This occurs when the requested call campaign is not found |
| 400 BadRequest | This error occurs due to malformed or invalid request parameters |
