Customisation

Truecaller SDK provides you with capabilities to configure the following:

Refer to the section below for details on all the customization capabilities and the possible values you may set:

TcSdkOptions.Builder(this, tcOAuthCallback)
       .consentMode(TcSdkOptions.CONSENT_MODE_BOTTOMSHEET) 
       .buttonShapeOptions(TcSdkOptions.BUTTON_SHAPE_ROUNDED)
       .footerType(TcSdkOptions.FOOTER_TYPE_ANOTHER_MOBILE_NO)
       .sdkOptions(TcSdkOptions.OPTION_VERIFY_ONLY_TC_USERS)
       .ctaText(TcSdkOptions.CTA_TEXT_ACCEPT)
       .heading(TcSdkOptions.LOGIN_TEXT_PREFIX_TO_GET_STARTED)
       .buttonColor(1111)
       .buttonTextColor(1111)
       .build()

Consent Mode Style [ .consentMode() ]

To align the consent screen with your UX, which could either be centrally or bottom aligned, choose either of the consent screens, making the SDK integration more homogeneous with your app UX.

Consent Mode	Value
Consent Mode - Center PopUp	TcSdkOptions.CONSENT_MODE_POPUP
Consent Mode - Bottomsheet	TcSdkOptions.CONSENT_MODE_BOTTOMSHEET

Contextual header [ .heading() ]

To provide the appropriate context of verification to the Truecaller user, use one of the below mentioned TruecallerSdkScope values to show the corresponding message to the user

Log in to	TcSdkOptions.SDK_CONSENT_HEADING_LOG_IN_TO
Sign up with	TcSdkOptions.SDK_CONSENT_HEADING_SIGNUP_WITH
Sign in to	TcSdkOptions.SDK_CONSENT_HEADING_SIGN_IN_TO
Verify number with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_NUMBER_WITH
Register with	TcSdkOptions.SDK_CONSENT_HEADING_REGISTER_WITH
Get started with	TcSdkOptions.SDK_CONSENT_HEADING_GET_STARTED_WITH
Proceed with	TcSdkOptions.SDK_CONSENT_HEADING_PROCEED_WITH
Verify with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_WITH
Verify profile with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_PROFILE_WITH
Verify your profile with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_YOUR_PROFILE_WITH
Verify your phone number with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_PHONE_NO_WITH
Verify your number with	TcSdkOptions.SDK_CONSENT_HEADING_VERIFY_YOUR_NO_WITH
Continue with	TcSdkOptions.SDK_CONSENT_HEADING_CONTINUE_WITH
Complete order with	TcSdkOptions.SDK_CONSENT_HEADING_COMPLETE_ORDER_WITH
Place order with	TcSdkOptions.SDK_CONSENT_HEADING_PLACE_ORDER_WITH
Complete booking with	TcSdkOptions.SDK_CONSENT_HEADING_COMPLETE_BOOKING_WITH
Checkout with	TcSdkOptions.SDK_CONSENT_HEADING_CHECKOUT_WITH
Manage Details with	TcSdkOptions.SDK_CONSENT_HEADING_MANAGE_DETAILS_WITH
Manage your details with	TcSdkOptions.SDK_CONSENT_HEADING_MANAGE_YOUR_DETAILS_WITH
Login to <<APP_NAME>> with one tap	TcSdkOptions.SDK_CONSENT_HEADING_LOGIN_TO_WITH_ONE_TAP
Subscribe to	TcSdkOptions.SDK_CONSENT_HEADING_SUBSCRIBE_TO
Get updates from	TcSdkOptions.SDK_CONSENT_HEADING_GET_UPDATES_FROM
Continue reading on	TcSdkOptions.SDK_CONSENT_HEADING_CONTINUE_READING_ON
Get new updates from	TcSdkOptions.SDK_CONSENT_HEADING_GET_NEW_UPDATES_FROM
Log in/ Signup with	TcSdkOptions.SDK_CONSENT_HEADING_LOGIN_SIGNUP_WITH

Button text options [ .ctaTextPrefix() ]

To set the prefix on the CTA button

Continue	TcSdkOptions.CTA_TEXT_CONTINUE
Proceed	TcSdkOptions.CTA_TEXT_PROCEED
Accept	TcSdkOptions.CTA_TEXT_ACCEPT
Confirm	TcSdkOptions.CTA_TEXT_COFIRM

Button shape [ .buttonShapeOptions() ]

To chose the shape of the CTA button

Round	TcSdkOptions.BUTTON_SHAPE_ROUNDED
Rectangle	TcSdkOptions.BUTTON_SHAPE_RECTANGLE

Footer CTA text [ .footerType() ]

To configure the text of the additional footer CTA present at the bottom

Use another number	TcSdkOptions.FOOTER_TYPE_CONTINUE
Use another method	TcSdkOptions.FOOTER_TYPE_ANOTHER_METHOD
Enter details manually	TcSdkOptions.FOOTER_TYPE_MANUALLY
Later	TcSdkOptions.FOOTER_TYPE_LATER

Dark Theme

To set the consent screen in dark mode, you can call TcSdk.getInstance().setTheme(OAuthThemeOptions.DARK)

just before calling the TcSdk.getInstance().getAuthorizationCode(this, launcher) By default, the SDK is configured with the light theme.

Privacy policy :

To add your privacy policy link on the verification screen, you can configure the respective hyperlink from your developer account

Terms of service: To add your terms of service link on the verification screen, you can configure the respective hyperlink from your developer account

Language: You can optionally customize the consent screen in any of the supported languages. To do so, add the following line :

Copy

val locale = Locale("hi") // change language to Hindi
TcSdk.getInstance().setLocale(locale)

Currently supported languages:

english	en
hindi	hi
marathi	mr
telugu	te
malayalam	ml
urdu	ur
punjabi	pa
tamil	ta
bengali	bn
kannada	kn
swahili	sw
arabic	ar