Here are a few things to consider when pushing the records through the API :-

• Caller and receiver should be phone numbers without the “+” character.

• ends_at should not be before the current timestamp.

• starts_at and ends_at cannot be more than 24 hrs apart

• label_id should be that of a dynamic label belonging to this client.

• Label name and call reason are optional fields.

• Max length for label name is 40 chars

• Min length for call reason is 10 chars

• Max length for call reason is 100 chars

• starts_at and ends_at should be in milliseconds.

Rate limits

Truecaller for Business restricts API requests when you exceed the limits entitled to your business.

• Each token can handle 100 requests per second

• Maximum of 10 tokens can be created in every 30 minutes

Here are some use cases for Call Personalisation APIs:

• Calling operations done through non-company owned numbers where a permanent identity cannot be listed.

• Scheduled calling operations that are run daily, where your business wants to add a clean identity and personalized call context for optimal performance.

• Calls often made from one business number to multiple users.

• Refreshing your identity on Truecaller easily, if your business has limited calling numbers.

Pre-requisites for using Call Personalisation APIs:

• Dynamic Label ID: Only “Dynamic Label IDs” can be used in the API request for placing calls. These dynamic label IDs need to be created in the Truecaller for Business console, after which the dynamic label ID can be copied from the Caller ID page in the console

• A subscription to a package that includes Call Personalisation APIs.

Integration steps:

• Create an API Key.

• Generate Access Token.

• Create a dynamic label on Truecaller for Business console:

  • Log in to the Truecaller for Business console.

  • Navigate to Business Identity in the left hand side panel.

  • Click on "Identity" and then go to the Caller ID Details section.

  • Click on "Create a Label".

  • Select the caller ID type as Dynamic Caller ID.

  • Add a logo for your dynamic caller ID. The logo should be a PNG file, with dimensions 200x200 and file size less than 2 MB.

  • Add a label name of less than 40 characters for your Dynamic Caller ID.

  • Choose the category for your business from the dropdown after creating a label name.

  • Click on "Create Caller ID' to finish creating your dynamic caller ID.

• Check the status of pushed records.

• Hit the dialer and place the call.

Here are a few things to consider when pushing the records through the API :-

• Caller and receiver should be phone numbers without the “+” character.

• ends_at should not be before the current timestamp.

• starts_at and ends_at cannot be more than 24 hrs apart

• label_id should be that of a dynamic label belonging to this client.

• Label name and call reason are optional fields.

• Max length for label name is 40 chars

• Min length for call reason is 10 chars

• Max length for call reason is 100 chars

• starts_at and ends_at should be in milliseconds.

Rate limits

Truecaller for Business restricts API requests when you exceed the limits entitled to your business.

• Thus, if your business is using a batch based approach to push records to our systems, 10*60*500 = 300000 records can be processed every minute.

Adapting to rate-limits

• Exponential Backoff: If you receive a "429" status code, consider implementing exponential backoff for retrying requests.

• Prioritize Important Requests: If your application performs various tasks, prioritize critical requests over less essential ones to stay within limits.