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:

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.

• 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

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

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.

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