| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
The Add Campaign Bulk Data (V4) API facilitates the bulk addition of data to Outbound Campaigns (Dialers). This data comprising numbers/leads is structured with mapped headers, including PhoneNumber, Name, Priority, Skill, etc, for integration into the dialer.
When you call this API multiple times, the data is stored in a queue and subsequently added to the outbound campaign in a queued manner.
The data must be entered manually following the example format below.
{"map":["PhoneNumber","Name","Priority","ExpiryDate","AgentId","skill"],"data":[["81XXXXXXX8","Ironman",6,"YYYY-MM-DD","Bobby","Skillname"],["86XXXXXXXX0","KommuramBheem",7,"YYYY-MM-DD","Bobby","GeneralSkill"],["81XXXXXX8","CaptainAmerica",8,"YYYY-MM-DD","Bobby","Skillname"]]}
Note
- The maximum count of data to be added is 500 per request.
- Maximum of 5 Requests allowed per minute.
- Parameters with ‘*’ are mandatory parameters.
- Total characters length per row including all headers is 2000.
Name field validation
- All letters and numbers are allowed (a-z, A-Z, 0-9, _)
- Only these special characters are allowed: space ( ) . + $ % - :
APIs Domain NameFor domestic ccaas - enter the domain: in1-ccaas-api.ozonetel.com
For international ccaas - enter the domain: api.ccaas.ozonetel.com
For Partners - enter the respective URL
To access this API the following parameters MUST be passed.
If you add both the checkduplicte and isdelete parameters in the payload, then only isdelete considered
| Parameter | Description |
|---|---|
| apiKey* | Your CloudAgent account API key. Available in your account admin login. |
| campaignName* | Name of the campaign to which the data is to be added. |
| bulkData* | Data to be inserted |
| userName* | Your CloudAgent account username |
| action |
|
| checkDuplicate | "true" - checks for duplicate leads in payload & campaign data in all lead statuses. If duplicate presents are found in the payload, then only the first lead in the payload will get added. "false" - API doesn't check for duplicate numbers if passed false. |
| callBackUrl | Add the call-back URL if needed. It should be publicly accessible. |
| isDelete | "true": When set to true, the API verifies the status of existing leads in the campaign. If the number already exists in the campaign data, it will not be added again. "false": When set to false, the API ignores the status of existing leads in the campaign and directly adds the data. |
Possible Responses
| Success response | API Response: Callback response: |
| Passing Invalid apiKey Value | {"status": "error","message": "Invalid userName or apiKey"} |
| Missing apiKey Value / Passing Invalid apiKey Key / Missing apiKey key | {"status": "error","message": "apiKey should not be empty"} |
| Passing Invalid userName Value | {"status": "error","message": "Invalid userName or apiKey"} |
| Missing userName Value / Passing Invalid userName Key / Missing userName key | {"status": "error","message": "userName should not be empty"} |
| Passing Invalid CampaignName Key | {"status": "error","message": "campaignName should not be empty"} |
| Passing Invalid CampaignName Value | {"status": "error","message": "Invalid Campaign Name"} |
| Missing Campaign Name Key / Missing Campaign Name Value | {"status": "error","message": "campaignName should not be empty"} |
| Passing Invalid bulkData Key | "{ ""status"": ""failure"", ""message"": ""Please provide valid data"" }" |
| Passing Invalid bulkData Value | "{ ""status"": ""failure"", ""message"": ""Please provide valid data"" }" |
| Missing bulkData Key | "{ ""status"": ""failure"", ""message"": ""Please provide valid data"" }" |
| Missing bulkData Value | "{ ""status"": ""failure"", ""message"": ""Please provide valid data"" }" |
| word PhoneNumber missing in bulk data map field value | "API Response : {""transactionId"": ""1292017169670681719733108"", CallBack response : |
| If data is not as per map fields | "API Response : {""transactionId"": ""129861716888265726411532"", CallBack response : |
| Adding data to inbound campaign | {"status": "error","message": "Invalid Campaign Name"} |
| If the campaign-mapped file and API-mapped file not matching | "API Response : {""transactionId"": ""129861716888265726411532"", CallBack response : |
| More than 5 hits per minute. | {"status": "error","message": "too many Requests and failed to add Data to queue"} |
| Callback Url response for successful case of leads upload. | { "data": { "totalNoUploaded": "xxxx", "numbersProcessed": "xxxx", "numbersNotProcessed": "xx", "failedFilePath": " xxxx " , "transactionId": "1292017169670681719733108", "status": "Success", "message": "File Successfully uploaded.", "startDateTime": "2024-05-29 12:47:56", "endDateTime": "2024-05-29 12:48:19" } } |
| Callback Url response for a failed case of leads upload. | CallBack response : { "data": { "totalNoUploaded": "xxxx", "numbersProcessed": "xxxx", "numbersNotProcessed": "xx", "failedFilePath": " xxxx " , "transactionId": "1292017169670681719733108", "status": "Fail", "message": "File Failed to Upload.", "startDateTime": "2024-05-29 12:47:56", "endDateTime": "2024-05-29 12:48:19" } } |
Sample response with failed file path:
Please note that the failed file path is a pre-signed URL, valid for 24 hours.
{"data":"{"totalNoUploaded":"6","numbersProcessed":"2","numbersNotProcessed":"4","failedFilePath":"https://etl-dataprocessing.s3.ap-south-1.amazonaws.com/172067852912917131638630_error.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA5D7NL2UC6QCNZQO6%2F20240711%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20240711T061551Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEI3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiSDBGAiEAvIU05scvsOlZASqNNnL1R1yhAIhZKwFKFZaySjh%2B9j4CIQDPeB5XSyr0vnJt4dYGfNqyD45mAUP%2FoxjF7ZQWU1UwMyrABQhXEAAaDDkwMTkwNDA2MTcwMSIMHyMJW2sFBz4dEZ56Kp0FvoIeQLtbzPqvYcd2yvukoYF5aJIYDM5d0Kdr17Sib3VIbr%2BKH87cWLps%2FgasNtk6FV3stCoCjaF3RUu6AIQtlYLxKCSkh%2FpUMOu1NmSSa4gYojkbpkA5jN4%2BP1JphR5OkABd%2F1G2ZVlRxKgTmMUVLZhDoAGQqhlLPHGmPM0sNe5etHiElf92bM1xYKpGkDcbrGipV1qdvT8F%2BvV3etmHe7NJ8sooAp%2Fxv72kcemgXZrOfSdKEjgbFvrd8S4xGqF49DQLIVOnBfKmtr6GfN%2FY2%2FimzCA5S1Ayta%2BXood2iVwduFqRheHb1zlEm8XBKR4TIUdnB54%2F9NHcQI3%2FtOEdEH2LtShUr5nwXc1HRW9qb3b3DMn6kgvwjvwJCGKWnud0QwdOBQNKi4aveibzGL89oJGwLaa%2FplMMTDqMHF0MHnPUO%2FIc8hHy3tmSzt1LGD8M6lVUeSj9OKI1MgIDFdFrS3HCoK7nyoY8a8mCEO2037Le6jP20Sbwtkjsac8l6ivr4GmREYDVs0ig%2BomHCYgtoLHUN2AQRs7MpOi1rEF4mh8TIYD5qbwP15CovxPaxQeR4QjpmHBRyMXUVtBbH2hhLlE5ohrLMBHs6MboDTJ9ynRxrvQ%2FHcSEmF%2Bf8aitRbM%2BjQZ8%2FbHk11qgLs62LJNcferpUZjarsvdFG435ZQutWeRuyIAxb37Y67Yv2fEfLE5E5bSLW7DfXPkNzo7YTZPDsmT4LHDAES3FQbJsVzZsjGXzOo%2F97tzn6V5Z5x2lowzdIYIEwRa4YQUGStjIyPpY%2BkNFi93Z4NiHtPz%2ByHF0le54Jy06F7LY%2BFm5Bc0ZzRqSb1GQlqo5ndy3o1qqpT2bMW2ngK%2BRWR2p9TBnKN7Msk7Vw%2FmVGjEJyo4hXZqMKTZvbQGOrAB1yoQCAlEPtwrPDXHVb6ZzEE0sWYXmyTjzvUMnmFZmBAcdL03wSA0hladm0jbDD2CE%2Fd%2FncNlq3BPir6QTBQiIJiuuY1MjdQrzAyN9lsRmdpeMxLiM2N5n1swVBBrCZZPPoOHF0oUstzjPt5TwIj3jdNO%2BzcbaYzR%2Blmohyfin74YmVZSxQBSR0gfS2dISXXO7Prb%2BIayHDu5cpZytMUNMM5C6M%2F4u7h8O9coWr0%2B63U%3D&X-Amz-Signature=dad6909867eb45be476dde2c751776975659fdb2841d89d9b3dcf018b28baf34", "transactionId":"172067852912917131638630","status":"Success","message":"File Successfully uploaded.","startDateTime":"2024-07-11 11:45:29","endDateTime":"2024-07-11 11:45:54"}"}