integrate TrueCaller API

Author: adamff-dev

app/build.gradle.kts

@@ -12,8 +12,8 @@ android {
         minSdk = 29
         //noinspection OldTargetApi
         targetSdk = 34
-        versionCode = 15
-        versionName = "2.2.4"
+        versionCode = 16
+        versionName = "2.3.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }

app/src/main/java/com/addev/listaspam/MainActivity.kt

@@ -36,6 +36,8 @@ import com.addev.listaspam.util.setListaSpamApiLang
 import com.addev.listaspam.util.setTellowsApiCountry
 import java.util.Locale
 import androidx.core.net.toUri
+import com.addev.listaspam.util.getTruecallerApiCountry
+import com.addev.listaspam.util.setTruecallerApiCountry
 
 class MainActivity : AppCompatActivity(), CallLogAdapter.OnItemChangedListener {
 
@@ -65,7 +67,8 @@ class MainActivity : AppCompatActivity(), CallLogAdapter.OnItemChangedListener {
         recyclerView?.layoutManager = LinearLayoutManager(this)
 
         setLanguage()
-        setCountry()
+        setTellowsCountry()
+        setTruecallerCountry()
         checkUpdates()
     }
 
@@ -124,7 +127,7 @@ class MainActivity : AppCompatActivity(), CallLogAdapter.OnItemChangedListener {
         setListaSpamApiLang(this, finalLang.uppercase())
     }
 
-    private fun setCountry() {
+    private fun setTellowsCountry() {
         if (getTellowsApiCountry(this) != null) return
 
         val systemCountry = Locale.getDefault().country.lowercase()
@@ -135,6 +138,17 @@ class MainActivity : AppCompatActivity(), CallLogAdapter.OnItemChangedListener {
         setTellowsApiCountry(this, finalCountry)
     }
 
+    private fun setTruecallerCountry() {
+        if (getTruecallerApiCountry(this) != null) return
+
+        val systemCountry = Locale.getDefault().country.uppercase()
+        val supportedCountries =
+            resources.getStringArray(R.array.truecaller_region_code).toSet()
+
+        val finalCountry = if (supportedCountries.contains(systemCountry)) systemCountry else "US"
+        setTruecallerApiCountry(this, finalCountry)
+    }
+
 
     private fun showNumberInputDialog() {
         val builder = AlertDialog.Builder(this)

app/src/main/java/com/addev/listaspam/service/UpdateCheckerService.kt

@@ -10,6 +10,7 @@ import com.addev.listaspam.R
 import okhttp3.OkHttpClient
 import okhttp3.Request
 import org.json.JSONObject
+import androidx.core.net.toUri
 
 /**
  * Class responsible for checking if a newer version of the app is available on a GitHub repository.
@@ -81,7 +82,7 @@ class UpdateChecker(
 
     companion object {
         fun redirectToGitHubReleasePage(context: Context, url: String) {
-            val intent = Intent(Intent.ACTION_VIEW, Uri.parse(url))
+            val intent = Intent(Intent.ACTION_VIEW, url.toUri())
             intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
             context.startActivity(intent)
         }

app/src/main/java/com/addev/listaspam/util/ApiUtils.kt

@@ -17,6 +17,16 @@ object ApiUtils {
     private const val TELLOWS_API_URL = "www.tellows.de"
     private const val TELLOWS_API_KEY = "koE5hjkOwbHnmcADqZuqqq2"
 
+    private const val TRUECALLER_API_URL_EU = "search5-eu.truecaller.com"
+    private const val TRUECALLER_API_URL_NONEU = "search5-noneu.truecaller.com"
+    private const val TRUECALLER_API_KEY = "a1i1V--ua298eldF0hb0rL520GjDz7bzVAdt63J2nzZBnWlEKNCJUeln_7kWj4Ir"
+
+    private val EU_COUNTRIES = setOf(
+        "AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR",
+        "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL",
+        "PL", "PT", "RO", "SK", "SI", "ES", "SE"
+    )
+
     private val client = OkHttpClient()
 
     /**
@@ -111,6 +121,55 @@ object ApiUtils {
         }
     }
 
+    fun checkTruecallerSpamApi(number: String, countryCode: String): Boolean {
+        val host = if (EU_COUNTRIES.contains(countryCode.uppercase())) {
+            TRUECALLER_API_URL_EU
+        } else {
+            TRUECALLER_API_URL_NONEU
+        }
+
+        val url = HttpUrl.Builder()
+            .scheme("https")
+            .host(host)
+            .addPathSegments("v2/search")
+            .addQueryParameter("q", number)
+            .addQueryParameter("countryCode", countryCode)
+            .addQueryParameter("type", "4")
+            .addQueryParameter("locAddr", "")
+            .addQueryParameter("placement", "SEARCHRESULTS,HISTORY,DETAILS")
+            .addQueryParameter("adId", "")
+            .addQueryParameter("encoding", "json")
+            .build()
+
+        val request = Request.Builder()
+            .url(url)
+            .get()
+            .header("Connection", "Keep-Alive")
+            .header("User-Agent", "Truecaller/9.00.3 (Android;10)")
+            .header("Authorization", "Bearer $TRUECALLER_API_KEY")
+            .header("Host", "search5-eu.truecaller.com")
+            .build()
+
+        return try {
+            val response = client.newCall(request).execute()
+            if (!response.isSuccessful) return false
+
+            val bodyString = response.body?.string() ?: return false
+            val json = JSONObject(bodyString)
+            val dataArray = json.optJSONArray("data") ?: return false
+            if (dataArray.length() == 0) return false
+
+            val firstEntry = dataArray.getJSONObject(0)
+            val spamInfo = firstEntry.optJSONObject("spamInfo")
+            val spamType = spamInfo?.optString("spamType")
+            val spamScore = spamInfo?.optInt("spamScore", 0) ?: 0 // Reports quantity
+
+            !spamType.isNullOrBlank() && spamScore > 1
+        } catch (e: Exception) {
+            false
+        }
+    }
+
     fun checkTellowsSpamApi(number: String, country: String): Boolean {
         val url = HttpUrl.Builder()
             .scheme("https")
@@ -159,8 +218,7 @@ object ApiUtils {
      *
      * @param phone The phone number to report (without country code prefix, if already localized).
      * @param comment A description of the issue or behavior associated with the number.
-     * @param complainTypeId Type of complaint, e.g. 5 = "estafa" (scam).
-     * @param userScore The danger score (1 = safe, 9 = dangerous).
+     * @param isSpam
      * @param lang Language and country code, e.g. "es".
      * @return `true` if the report was accepted; `false` otherwise.
      */
@@ -169,9 +227,9 @@ object ApiUtils {
         comment: String,
         isSpam: Boolean,
         lang: String = "es",
-        complainTypeId: Int = 5
     ): Boolean {
         val userScore = if (isSpam) 9 else 1
+        val complainTypeId = if (isSpam) 5 else 2 // 5 is aggressive advertising and 2 is reliable number
 
         val url = HttpUrl.Builder()
             .scheme("https")

app/src/main/java/com/addev/listaspam/util/SharedPreferencesUtils.kt

@@ -41,12 +41,21 @@ fun setListaSpamApiLang(context: Context, languageCode: String) =
 fun shouldFilterWithTellowsApi(context: Context): Boolean =
     getBooleanPref(context, "pref_filter_tellows_api", true)
 
+fun shouldFilterWithTruecallerApi(context: Context): Boolean =
+    getBooleanPref(context, "pref_truecaller_api", true)
+
 fun getTellowsApiCountry(context: Context): String? =
-    getStringPref(context, "pref_tellows_country")?.lowercase()
+    getStringPref(context, "pref_tellows_country")?.uppercase()
 
 fun setTellowsApiCountry(context: Context, countryCode: String) =
     setStringPref(context, "pref_tellows_country", countryCode.lowercase())
 
+fun getTruecallerApiCountry(context: Context): String? =
+    getStringPref(context, "pref_truecaller_country")?.uppercase()
+
+fun setTruecallerApiCountry(context: Context, countryCode: String) =
+    setStringPref(context, "pref_truecaller_country", countryCode.uppercase())
+
 fun shouldFilterWithListaSpamScraper(context: Context): Boolean =
     getBooleanPref(context, "pref_filter_lista_spam_scraper", false)
 

app/src/main/java/com/addev/listaspam/util/SpamUtils.kt

@@ -248,13 +248,22 @@ class SpamUtils {
             }
         }
 
+        // Tellows
         val tellowsApi = shouldFilterWithTellowsApi(context)
         if (tellowsApi) {
             spamCheckers.add { number ->
                 ApiUtils.checkTellowsSpamApi(number, getTellowsApiCountry(context) ?: "us")
             }
         }
 
+        // Truecaller
+        val truecallerApi = shouldFilterWithTruecallerApi(context)
+        if (truecallerApi) {
+            spamCheckers.add { number ->
+                ApiUtils.checkTruecallerSpamApi(number, getTruecallerApiCountry(context) ?: "US")
+            }
+        }
+
         if (shouldFilterWithListaSpamScraper(context) && !listaSpamApi) spamCheckers.add(::checkListaSpam)
 
         if (shouldFilterWithResponderONo(context)) spamCheckers.add(::checkResponderono)

app/src/main/res/layout/dialog_report.xml

@@ -78,6 +78,13 @@
             android:checked="true"
             android:text="Tellows" />
 
+<!--        <CheckBox-->
+<!--            android:id="@+id/checkboxTruecaller"-->
+<!--            android:layout_width="wrap_content"-->
+<!--            android:layout_height="wrap_content"-->
+<!--            android:checked="true"-->
+<!--            android:text="Truecaller" />-->
+
         <View
             android:layout_width="match_parent"
             android:layout_height="20dp" />

app/src/main/res/values-es/strings.xml

@@ -36,7 +36,8 @@
     <!-- Preferences Sections -->
     <string name="pref_category_general_blocking">General</string>
     <string name="pref_category_unknown_phone_api">API Unknownphone</string>
-    <string name="pref_category_tellows_api">API Tellows</string>
+    <string name="pref_category_tellows_api">API Tellows 🌐</string>
+    <string name="pref_category_truecaller_api">API Truecaller 🌐</string>
     <string name="pref_category_scrapers_es">Scrapers 🇪🇸</string>
     <string name="pref_category_spam_filters">Filtros de números de spam</string>
     <string name="pref_category_other_options">Otras opciones de bloqueo</string>
@@ -48,27 +49,34 @@
 
     <!-- API Unknownphone -->
     <string name="pref_filter_lista_spam_title">API Unknownphone</string>
-    <string name="pref_filter_lista_spam_summary">[🌐] (Recomendado) Bloquea llamadas de números spam incluidos en la API unknownphone.com</string>
+    <string name="pref_filter_lista_spam_summary">(Recomendado) Bloquea llamadas de números spam incluidos en la API unknownphone.com</string>
 
     <string name="pref_filter_lista_spam_api_language_title">Idioma API unknownphone.com</string>
     <string name="pref_filter_lista_spam_api_language_summary">Seleccione el idioma para realizar las búsquedas en la API de unknownphone.com (afecta a los resultados)</string>
 
     <!-- API Tellows -->
     <string name="pref_filter_tellows_title">API Tellows</string>
-    <string name="pref_filter_tellows_summary">[🌐] (Recomendado) Bloquea llamadas de números spam listados en la API de Tellows</string>
+    <string name="pref_filter_tellows_summary">(Recomendado) Bloquea llamadas de números spam listados en la API de Tellows</string>
 
     <string name="pref_filter_tellows_api_country_title">País API Tellows</string>
     <string name="pref_filter_tellows_api_country_summary">Seleccione el país para las búsquedas en la API de Tellows (afecta a los resultados)</string>
 
+    <!-- API Truecaller -->
+    <string name="pref_filter_truecaller_title">API Truecaller</string>
+    <string name="pref_filter_truecaller_summary">(Recomendado) Bloquea llamadas de números spam identificados por la API de Truecaller</string>
+
+    <string name="pref_filter_truecaller_api_country_title">País API Truecaller</string>
+    <string name="pref_filter_truecaller_api_country_summary">Seleccione el país para las búsquedas en la API de Truecaller (afecta a los resultados)</string>
+
     <!-- Spam Number Filters -->
-    <string name="pref_filter_lista_spam_scraper_title">Scraper listaspam.com</string>
-    <string name="pref_filter_lista_spam_scraper_summary">[🇪🇸] (Obsoleto) Bloquea llamadas de números spam incluidos en la web listaspam.es</string>
+    <string name="pref_filter_lista_spam_scraper_title">Scraper listaspam.com 🇪🇸</string>
+    <string name="pref_filter_lista_spam_scraper_summary">(Obsoleto) Bloquea llamadas de números spam incluidos en la web listaspam.es</string>
 
     <string name="pref_filter_responder_o_no_title">Scraper responderono.es</string>
-    <string name="pref_filter_responder_o_no_summary">[🇪🇸] Bloquea llamadas de números spam incluidos en la web responderono.es</string>
+    <string name="pref_filter_responder_o_no_summary">Bloquea llamadas de números spam incluidos en la web responderono.es</string>
 
     <string name="pref_filter_cleverdialer_title">Scraper cleverdialer.es</string>
-    <string name="pref_filter_cleverdialer_summary">[🇪🇸] Bloquea llamadas de números spam incluidos en la web cleverdialer.es</string>
+    <string name="pref_filter_cleverdialer_summary">Bloquea llamadas de números spam incluidos en la web cleverdialer.es</string>
 
     <!-- Other Blocking Options -->
     <string name="pref_block_non_contacts_title">Bloquear llamadas de desconocidos</string>
@@ -80,7 +88,7 @@
     <string name="pref_block_international_numbers_title">Bloquear llamadas internacionales</string>
     <string name="pref_block_international_numbers_summary">Bloquear llamadas de otros países</string>
 
-    <string name="pref_block_stir_shaken_risk_title">Bloquear llamadas STIR/SHAKEN</string>
+    <string name="pref_block_stir_shaken_risk_title">Verificar con STIR/SHAKEN</string>
     <string name="pref_block_stir_shaken_risk_summary">Bloquear llamadas marcadas como potencialmente fraudulentas por el sistema STIR/SHAKEN (solo Android 11+, disponible en algunos países y operadoras)</string>
 
     <string name="pref_mute_instead_of_block_title">Silenciar en lugar de bloquear</string>