Applies To
Customers would like to apply marketing data attribution(Signals or Marketing Data) to multiple call reports in one request.
Answer
The Signal API facilitates the application of Signals and/or Custom Data Fields to specific calls (transactions) that have already occurred. This is accomplished by utilizing the POST method, which sends a request containing the following parameters in the request body:
- Call Reference: This can be the Call Record ID, Translation ID, or Call Start Time, which serves as a unique identifier for the specific call.
- Signals or Marketing Data: The data that needs to be applied to the call in the form of Signals or Marketing-related information.
- OAuth Token: An OAuth token is required for authentication purposes to authorize the API access.
Keep in mind that it is essential to be aware of certain limitations and considerations when using the Signal API:
- Multiple Requests: Since applying data to multiple calls in a single API request is not supported, you will need to make separate requests for each call to apply the desired data.
- Rate Limit: Up to 100 requests can be sent per minute, which means you can apply data to a maximum of 100 calls within a minute.
- Backlog Processing: However, it's crucial to note that sending the maximum number of requests within a short time could lead to a backlog in processing. This may cause delays in applying the data to the calls and impact overall system performance.
To efficiently utilize the Signal API and avoid processing backlogs, consider implementing a strategy that distributes the requests over time or batching them into manageable chunks to ensure smooth and timely data application without overwhelming the system.
