Note: Regenerating a webhook token invalidates the previous token immediately. This means any systems or applications using the old token will no longer be able to authenticate with Truecaller's webhook service. Ensure you promptly update all relevant configurations with the new token to avoid service interruptions.
If you suspect your webhook token has been compromised, you can easily regenerate a new token within the business console.
Navigate to webhook setup:
Return to the "Webhook Setup" page within the Verified Campaign section of the business console.
Regenerate token:
Look for a button labeled "Regenerate Webhook Token" on the page below your webhook token section. Click on it to initiate the regeneration process.
Copy and update:
A new webhook token will be generated and displayed on the screen.
Securely copy this new token and update the configuration of any applications or systems that were using the previous token.
Discover how to leverage our powerful webhook integrations to enhance your campaign visibility and engagement right from your CEP platform.
Our user-friendly documentation equips you with all the necessary information to seamlessly set up and utilise Truecaller as an additional channel via webhook based connectors from your CEP platform, ensuring you maximize the impact of your Verified Campaigns.
Pre-requisites for using Verified Campaign :
An active Truecaller for Business Verified Business subscription for your business
Integration Steps :
Log into your Truecaller for Business account.
Configure a webhook token for your organisation.
Copy the relevant details from your account - Webhook Endpoint URL, Organisation ID and Token.
Set up "Truecaller" as a new channel of communication on your Customer Engagement Platform, in-house audience definition tool or CRM platform.
Define specific template parameters to personalise the message to be shown to your target users (Refer to Template Styles for Parameter definitions).
That's it! You have now set up a webhook connector to send the audience data to Truecaller for Business backend service.
Verified Campaign will start showing up on Truecaller user device's based on specified parameters and when a Verified Business call or message lands on their device.
Truecaller for Business uses webhook tokens to authenticate your webhook connectors. You can easily manage your webhook tokens within the Truecaller for Business console.
By utilizing webhook tokens, you can ensure that your integrations remain secure while connecting your Customer Engagement Platform (CEP) with Truecaller for Business. To set up your webhook token, follow these steps:
Access webhook setup: Navigate to the “Webhook Setup” section within the Verified Campaign tab of the Truecaller for Business console.
Generate token: Click on the “Generate Webhook Token” button to create your token.
Secure your token: Once generated, ensure to copy and store your webhook token securely, as this token will be essential for authenticating your webhook requests. Carefully copy the entire webhook token. This is a sensitive piece of information, so treat it like a password.
Note: Your external system's configuration will vary depending on the platform. Refer to your system's documentation for specific instructions on how to set up webhook integration.
Copy the following within the Truecaller for Business Console's webhook setup page.
Webhook Endpoint URL:
This is the address (URL) where you will push your segment and template parameters to.
Action: Copy this URL and paste it into the webhook configuration section of your external CX system.
Organization ID:
This is a unique identifier assigned to your organization within the Truecaller for Business system. It's a 16 digit UUID.
Action: Copy this ID. You'll need to include it in the authentication headers of your webhook requests to verify that you're authorized to receive the notifications.
Key-Value Pair Format : X-Org-ID: [Your Organization ID]
Webhook Token:
This token is used for authenticating your webhook requests to ensure secure communication between your system and Truecaller's backend service.
Action: Copy the webhook token and include it in the headers of your requests as an additional security measure.
Key-Value Pair Format: X-Org-Token: [Your Webhook Token]
