API URLs to be used

Copy the following within Truecaller for Business console's webhook setup page.

1. Webhook Endpoint URL:

Pre-requisites for using Verified Campaigns :

• An active subscription of Truecaller Customer Experience Solution for your business

Integration Steps :

1. Log into your Truecaller for Business account.

2. Configure a webhook token for your organization.

3. Copy the relevant details from your account - Webhook Endpoint URL, Organization ID and Token.

4. Set up "Truecaller" as a new channel of communication on your Customer Engagement Platform, in-house audience definition tool or CRM platform.

If you suspect your webhook token has been compromised, you can easily regenerate a new token within the business console.

1. Navigate to webhook setup:

To help you stay informed about events related to the features in your enterprise plan, you can easily configure Webhooks (also known as HTTP callbacks) directly on our Self-serve platform. This ensures your systems are automatically notified, keeping you seamlessly updated.

Generate API Keys

• Truecaller for Business uses API keys for authenticating API requests.

• You can view and manage your API keys from the True caller for Business console.

• Click on “API Setup” from the left-hand rail in the account under "Connectors"

• Click on the “Create API Key” button.

• Enter the Key Name and Description (optional). You can see the access level underneath the description box for all available features.

• Click on “Generate”. This will take you to the screen which has the option to copy/save the Key ID and Secret API Key. This file should be downloaded and kept securely.

Core Features :

• Integtates with existing customer engagement platforms and internal CRMs

Yes, we can help you with that. Please reach out to us at [email protected] and our team will reach out to you.

You can view all the campaigns you have run on Truecaller by following these steps:

1. Log into the Truecaller Business Console: Access your account by logging into the Truecaller Business Console using your organizational credentials.

2. Navigate to Verified Campaigns: On the left-hand side panel, click on the “Verified Campaigns” tab to access the campaign management section.

3. View Campaign Listings: Under the “Campaigns” section, you will see a comprehensive list of all your executed campaigns. This list includes details such as:

   • Campaign Name

   • Campaign ID

   • Campaign Type

   • Stats (impressions, clicks, etc mapped to each Campaign)

Yes, businesses can track the performance of their Verified Campaigns through a Looker dashboard integrated into the Truecaller for Business console. Metrics such as impressions, clicks, unique users reached, and CTR can be viewed, helping businesses evaluate the effectiveness of their campaigns.

Navigate to "Analytics" tab to view unified campaign analytics :

Navigate to the "Verified Campaigns" section within your business console and click on "Template Generator" option

Step 1: Campaign identifiers and use case

• Campaign Name: Enter the name of your campaign.

Verified Campaigns seamlessly integrates with several CX features of Verified Business to enhance your communication strategy. Here’s what you can expect:

Compatible Features:

When Verified Campaigns is active, the following features will be supported with conditions :

• Verified Business Caller ID

• Business Call Reason:

• CleverTap :

Yes, businesses can access detailed payload exchange metrics via the Truecaller for Business console. We provide a breakdown of successfully processed records along with granular reasons for any rejections.

These are shared asynchronously to ensure clarity and traceability mapped to each unique Campaign ID.

Here are some common rejection reasons:

• Receiver’s app version is not supported → Truecaller user is on an unsupported app version

• Receiver’s OS is not supported → Truecaller user is using an iOS device

The phone number must be provided as a 12-digit string, which includes the 2-digit country code followed by the 10-digit mobile number (e.g., 91XXXXXXXXXX for India).

This phone number value can also be then be SHA-256 hashed (in lowercase hex format) before being shared in the payload.

Example:

• Raw phone number: 911234567891

Verified Campaigns includes several templates designed to enhance customer engagement through dynamic and contextually relevant interactions within the Truecaller app.

Here are the templates for Verified Campaigns :

• Plain text with CTA.

• Image banner with CTA.

• Personalized text with CTA (Image on left).

Verified Campaigns is designed to be fully platform-agnostic, ensuring seamless integration with your existing marketing and customer engagement stack.

Whether you use a Customer Engagement Platform (CEP), Customer Data Platform (CDP), CRM, Marketing Automation Tool, or even an in-house solution, Verified Campaigns can effortlessly sync with your workflows.

We achieve this by supporting a simple webhook-based integration, allowing any system that can push event-driven data to communicate with our platform in real time. This means you can trigger Verified Campaigns based on specific customer actions, behavioral signals, or lifecycle events, ensuring hyper-personalized and timely campaign messaging.

Some key benefits for marketing teams: ✔ Omnichannel Activation – Extend the reach of your marketing stack by engaging users via Verified Calls & Messages in addition to existing channels. ✔ Real-time Personalization – Leverage first-party data from your CDP/CRM to deliver contextually relevant campaigns. ✔ No Platform Lock-in – Works with any tool of your choice, eliminating dependency on a single vendor. ✔ Scalability and Compliance – Enterprise-grade scalability with built-in data privacy and security measures.

This flexibility makes Verified Campaigns an essential component of any modern B2B marketing and customer engagement strategy, enabling brands to drive higher reach, conversions, and ROI.

To sign up and utilize Verified Campaigns, you must have an active Truecaller Customer Experience Solution subscription.

This is essential because all Verified Campaigns will be shown to your customer in the Verified Business interfaces only. Verified Campaigns gets triggered on the basis of your calling or messaging events that happen on the Truecaller app.

POST {{BaseURL}/organisations/{organisationid}/campaigns/bulk-upload

Headers

Body

File in below format -for multiple user records

Response

Display your campaign on a sticky pop-up that shows up for Truecaller users after a call ends on the user's device. Leverage this touchpoint to reinforce your messaging with a highly engaging visual that appears immediately after the conversation, capturing user attention right when it matters.

Below are the required payload parameters for each Template Style on the Universal ACS screen :

profile section parameters are Mandatory for all webhook payloads :

• campaign_id : External campaign reference ID

• receiver_number : Phone numbers of the end user to whom the communication should be delivered.

content section parameters can vary based on display_unit and template_style as follows : * means mandatory

Display your campaign when users receive calls from your verified number, ensuring high visibility and engagement. This touchpoint allows you to present important messages directly during incoming calls, enhancing user awareness of your brand

Below are the required payload parameters for each Template Style on the Caller ID screen :

profile section parameters are Mandatory for all webhook payloads :

• campaign_id : External campaign reference ID

• receiver_number : Phone numbers of the end user to whom the communication should be delivered.

content section parameters can vary based on display_unit and template_style selected as follows : * means mandatory

Message ID is a sticky notification that comes up for Truecaller users, capturing their attention for every transactional notification they receive. This touchpoint not only ensures timely and relevant messaging but also delivers business outcomes by enhancing user engagement and interaction with your brand.

Below are the required payload parameters for each Template Style on the Message ID screen :

profile section parameters are Mandatory for all webhook payloads :

• campaign_id : External campaign reference ID

• receiver_number : Phone numbers of the end user to whom the communication should be delivered.

content section parameters can vary based on display_unit and template_style as follows : * means mandatory

Verified Campaigns can be configured on the below touchpoints on the Truecaller app :

Verified Caller ID : Display your campaign when users receive calls from your verified number, ensuring high visibility and engagement. This touchpoint allows you to present important messages directly during incoming calls, enhancing user awareness of your brand.

Post-Call Screen : Drive post call contextualized targeting with a sticky pop-up that shows up for Truecaller users after a call ends. Leverage this touchpoint to reinforce your messaging with a highly engaging visual that appears immediately after the conversation, capturing user attention right when it matters. Leverage this touchpoint to engage with your customers with a custom campaign even when they reject or miss your call.

Verified Message ID : Message ID is a sticky notification that comes up for Truecaller users, capturing their attention for every transactional notification they receive. This touchpoint not only ensures timely and relevant messaging but also delivers business outcomes by enhancing user engagement and interaction with your brand.

Business Profile: Along with letting customers know your business and brand better through your Business Profile, you can now target them with personalized engagement. Engage whenever your customers visit your Business Profile on Truecaller and drive growth on this untapped touchpoint.

Display your campaign on a sticky pop-up that shows up for Truecaller users when the user misses or rejects your call. Leverage this touchpoint to communicate with your customers with a custom campaign when they fail to receive your call.

Below are the required payload parameters for each Template Style on the Missed Call screen :

profile section parameters are Mandatory for all webhook payloads :

• campaign_id : External campaign reference ID

• receiver_number : Phone numbers of the end user to whom the communication should be delivered.

content section parameters can vary based on display_unit and template_style as follows : * means mandatory

Clickstream Webhook Event Structure

Yes, Truecaller supports the use of SHA-256 hashed values for PII fields such as phone numbers. This allows businesses to maintain data privacy and security while still leveraging Truecaller’s Verified Campaigns capabilities

When using hashed inputs:

• The phone number must be in 12-digit format (e.g., 91XXXXXXXXXX), without the plus sign.

• Apply SHA-256 hashing to the 12-digit number.

To configure your webhooks, simply follow these steps:

1. Access Webhook : Click on Manage Webhooks under Verified Campaigns

To understand more about the pricing of Verified Campaigns, please reach out to your Truecaller for Business account manager or write to us at [email protected].

Verified Campaigns can be easily set up through your Customer Engagement Platform (CEP) or Customer Relationship Management (CRM) platform. Here’s how it works:

• Build: Build your campaign blocks by generating templates, personalizing displays and customizing parameters as required. All necessary authentication details and setup options are available in your Truecaller for Business console, allowing you to manage everything independently.

• Operate: Add Truecaller as a channel to your existing or new customer journeys on your customer engagement platform, in order to hyper personalize your business calls and SMS.

• Engage: Engage at scale across use cases like onboarding, activation, nurturing, advocacy and churn. Easily measure and optimize your campaigns on the Truecaller for Business console.

Display your campaigns directly on your Business Page to engage users with targeted content whenever they view your verified identity. Reinforce your messaging through branded visuals, CTAs, and offers—right where users come to learn more about your business.

Below are the required payload parameters for each Template Style on the Universal ACS screen :

profile section parameters are Mandatory for all webhook payloads :

• campaign_id : External campaign reference ID

• receiver_number : Phone numbers of the end user to whom the communication should be delivered.

content section parameters can vary based on display_unit and template_style as follows : * means mandatory

POST {{BaseURL}/organisations/{organisationid}/campaigns/token

Headers

Body

Request

Verified Campaigns operates independently of your Customer Engagement Platform (CEP) and does not alter its billing structure.

Since our platform integrates via webhooks, your CEP will continue to charge you based on its existing pricing model—whether that’s based on API calls, events triggered, messages sent, or MAUs (Monthly Active Users).

Here’s what you need to consider:

✔ No Double Charging – Verified Campaigns does not duplicate billing for the same user engagement. If you’re already paying your CEP for event-based triggers, our pricing remains separate and purely based on the unique Truecaller users reached within a calendar month

✔ Webhook-Based Triggers – Since Verified Campaigns relies on webhook integrations, any event-triggered campaign may count toward your CEP’s event-based pricing. However, we only process the data you choose to send, ensuring flexibility in managing costs.

✔ Optimized Spend – Since Verified Campaigns helps reach customers on existing high-engagement channel (Caller ID, Post Call Screen, Message ID), it can complement your existing CEP strategies by reducing dependency on costlier channels like SMS, push, or email—potentially optimizing your overall marketing spend.

Note: For specific billing implications related to your CEP contract, please consult your CEP Account Manager or Customer Success teams for appropriate details.

Please reach out to [email protected] for questions on Verified Campaigns pricing.

The Image Banner template allows you to leverage your own marketing assets for Verified Campaigns.

Below are the guidelines for using your own banners on Verified Campaigns:

Similar to Template 3, this design places the personalized text alongside an image, but with the image on the right side. This layout maintains visual appeal while ensuring the text remains the focal point. Customization options, including background color and text color, enable you to tailor this template to fit your brand identity perfectly.

Below are the guidelines for creating a banner that has personalized text with CTA and brand Image on the right side:

This template offers a unique combination of personalized text and a brand image positioned on the left, providing a balanced layout. Personalization helps create a stronger connection with the audience, while the brand image adds visual interest. Customizable aspects like background color and text color allow for further alignment with your brand.

Below are the guidelines for creating a banner that has personalized text with CTA and brand Image on the left side:

This template features a straightforward design that effectively communicates your message with a clear call-to-action (CTA). It allows for customization of specific aspects, such as background color and text color, to match your branding. This option is perfect for businesses looking to deliver concise information without distractions.

Below are the guidelines for a text banner on Verified Campaigns:

Yes, you can host your marketing assets directly on the Truecaller Business console.

We store these assets in a CDN-backed storage bucket on Google Cloud Platform (GCP), enabling near real-time delivery of marketing campaigns even on low-latency or high-traffic networks.

This ensures your campaign assets are hosted securely and load quickly and reliably for end users across regions.