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

1. Webhook Endpoint URL:

   • This is the address (URL) where you will push your segment and template parameters to.

     • https://enterprise-webhooks-noneu.truecaller.com/campaigns

   • Action: Copy this URL and paste it into the webhook configuration section of your external CX system.

2. 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]

3. 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]

Pre-requisites for using Verified Campaign :

• An active Truecaller for Business Verified Business subscription for your business

Integration Steps :

1. Log into your Truecaller for Business account.

2. Configure a webhook token for your organisation.

3. Copy the relevant details from your account - Webhook Endpoint URL, Organisation 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.

5. Define specific template parameters to personalise the message to be shown to your target users (Refer to Template Styles for Parameter definitions).

6. That's it! You have now set up a webhook connector to send the audience data to Truecaller for Business backend service.

7. 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.

Navigate to the "Verified Campaign" 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 Verified Campaign.

• Campaign ID: Enter your campaign's unique identifier, this could be the same external campaign reference or campaign ID that you use in your external system

• Campaign Type: Select the relevant type (Lifecycle or Offer).

Step 2: Choose your Display Unit

• Select the display unit(s) where your campaign will run:

  • Caller ID: The message shown when a call is received.

  • ACS (Answered): The message displayed after a call is answered.

  • ACS (Missed): The message shown after a missed call.

  • Message ID: The message shown for transactional message notifications

• Each display unit may have different template style options available.

Step 3: Configure PDU template

• For each selected Display Unit the parameters of customization are different.

  • Custom Fields: Enter your message content (title, subtitle, CTA, deeplink, etc.) based on the chosen display unit.

  • Brand Assets:

    • Text Colors: Choose a text color that works best with your brand image (Black or White).

    • Template Theme: Select a brand color for the template theme.

    • Brand Image: Past the image URL for your marketing (Note : Adhere to recommended dimensions and image storage requirements).

• Visual Preview: Review the real-time preview of your message as you make changes.

• Error Feedback: Address any error messages that appear regarding missing or incorrect fields.

• Save and Generate JSON: Click this button when you're satisfied with your template.

Step 4: JSON Generator

• JSON Payload: A formatted JSON payload, based on your template and selections, will be displayed. This payload adheres to the required format for Truecaller's Verified Campaign Webhook endpoint.

• Copy: Click the "Copy" button to copy the JSON payload to your clipboard.

Important Notes:

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_name : External campaign name reference

• campaign_id : External campaign reference ID

• campaign_type : Use-case of the campaign, could be either lifecycle or offer

• 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

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_name : External campaign name reference

• campaign_id : External campaign reference ID

• campaign_type : Use-case of the campaign, could be either lifecycle or offer

• 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 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_name : External campaign name reference

• campaign_id : External campaign reference ID

• campaign_type : Use-case of the campaign, could be either lifecycle or offer

• 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

• CleverTap :

  • Setup Webhooks

  • Create Message

  • Personalize Message

• MoEngage :

  • Authorization Configuration with OAuth 2.0 – User Guide

  • Create a Connector Campaign – User Guide

• WebEngage :

  • https://docs.webengage.com/docs/webhooks

• Netcore :

  • https://cedocs.netcorecloud.com/docs/webhook

• Segment by Twilio :

  • Setup Webhooks

Setting up Verified Campaign requires you to configure it within your own Customer Engagement Platform (CEP). Here’s how to get started:

1. Webhook Connector Setup: Use the webhook connector framework to seamlessly connect your CEP tool with Truecaller for Business. This integration will enable you to push campaign details and relevant parameters to Truecaller, ensuring that your campaigns are executed smoothly and securely.

2. Customise Campaign Parameters: As part of the campaign setup, customize the parameters such as campaign name, campaign ID, and campaign type based on your specific marketing goals.

3. Verified Business Interaction: Your campaign will render when a call or message is received from a listed verified business number. This ensures that your audience receives relevant and timely information directly related to their interactions with your business.

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_name : External campaign name reference

• campaign_id : External campaign reference ID

• campaign_type : Use-case of the campaign, could be either lifecycle or offer

• 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

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:

   • Return to the "Webhook Setup" page within the Verified Campaign section of the business console.

2. 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.

3. 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.

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 :

Core Features :

• Supports a vast number of use cases including lifecycle communications and promotional offers.

• Get multiple engaging template styles: Text Only, Image Only, Image supported Banner.

• GIF, .jpeg and .png support for images.

• Local language support on the PDUs.

To sign up and utilize Verified Campaign, you must have an active Verified Business subscription.

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

Yes, we can help you with that. Please reach out to us at business@truecaller.com and our team will reach out to you.

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

• Seamless Integration: Push webhooks to Truecaller via connectors based on your chosen template parameters.

• Webhook Authentication: Secure your setup with authentication using your Organization ID and Token.

• Self-Serve Access: All necessary authentication details and setup options are available in your Truecaller for Business console, allowing you to manage everything independently.

This streamlined process ensures that your messaging reaches users effectively across various touchpoints while maintaining security and control over your campaigns.

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:

1. Access webhook setup: Navigate to the “Webhook Setup” section within the Verified Campaign tab of the Truecaller for Business console.

2. Generate token: Click on the “Generate Webhook Token” button to create your token.

3. 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.

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 plain text banner on Verified Campaigns:

1. Verified Caller ID

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA : Not available

• Redirection: Not available

• Local Language Support: Yes

2. After Call Screen: Universal and Missed Call

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA: 15 characters MAX; supports 1 line

• Redirection: Landing page on mobile web browser or app deeplink supported

• Local Language Support: Yes

The Verified Campaign feature 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).

• Personalized text with CTA (Image on right).

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:

1. Verified Caller ID:

• PDU Aspect Ratio: 320x140

• Image Dimensions: 320x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• File Storage: Needs to be hosted on business's CDN bucket

• Redirection : Not Available

• Local Language Support: Yes

2. After Call Screen: Universal and Missed Call

• PDU Aspect Ratio: 320x140

• Image Dimensions: 320x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• Redirection: Landing page on mobile web browser or app deeplink supported

• Image File Hosting: Needs to be hosted on business's CDN bucket

• Local Language Support: Yes

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:

1. Verified Caller ID:

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA: Not available

• Redirection: Not available

• Image Dimensions: 100x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• Image File Hosting: Needs to be hosted on business's CDN bucket

• Local Language Support: Yes

2. After Call Screen: Universal and Missed Call

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA: 15 characters MAX; supports 1 line

• Redirection: Landing page on mobile web browser or app deeplink supported

• Image Dimensions: 100x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• Redirection: Landing page on mobile web browser or app deeplink supported

• Image File Hosting: Needs to be hosted on business's CDN bucket

• Local Language Support: Yes

Verified Campaign 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 : Display your campaign on a sticky pop-up that shows up for Truecaller users after a call ends on the users 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.

• Missed Call Screen : Display your campaigns 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.

• 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.

To understand more about the pricing of Verified Campaigns, please reach out to your Truecaller for Business account manager or write to us at business@truecaller.com.

Write to us at business@truecaller.com and we will help you out!

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:

1. Verified Caller ID:

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA: Not available

• Redirection: Not available

• Image Dimensions: 100x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• Image File Hosting: Needs to be hosted on business's CDN bucket

• Local Language Support: Yes

2. After Call Screen: Universal and Missed Call

• PDU Aspect Ratio: 320x140

• Title: 25 characters MAX; supports 2 lines

• Subtitle: 45 characters MAX; supports 2 lines

• CTA: 15 characters MAX; supports 1 line

• Redirection: Landing page on mobile web browser or app deeplink supported

• Image Dimensions: 100x140

• Image File Format: .jpeg, .png, .gif

• Image File Size: >2 MB

• Redirection: Landing page on mobile web browser or app deeplink supported

• Image File Hosting: Needs to be hosted on business's CDN bucket

• Local Language Support: Yes

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 Campaign: On the left-hand side panel, click on the “Verified Campaign” 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)

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

Compatible Features:

• Verified Caller ID Badge: Boost trust with your brand by displaying a verified badge.

• Call Reason: Provide context for your calls with clear call reasons.

• Video Caller ID: Engage users visually with video content during calls.

Overridden Features: When an active Verified Campaign is in place, the following features will be temporarily overridden:

• Call Me Back: User requests to return calls may be affected.

• User Feedback: Feedback prompts will be disabled during the campaign period.

This integration ensures that your campaigns are prominently featured while maintaining essential communication functionalities.