Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ni554n/truecallerjs_bot

A Telegram bot to lookup phone number info via Truecaller API
https://github.com/ni554n/truecallerjs_bot

caller-id deno deno-kv phone-number-lookup telegram-bot truecaller truecallerjs

Last synced: 3 months ago
JSON representation

A Telegram bot to lookup phone number info via Truecaller API

Host: GitHub
URL: https://github.com/ni554n/truecallerjs_bot
Owner: ni554n
Created: 2023-08-09T20:41:21.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-04-05T06:29:15.000Z (10 months ago)
Last Synced: 2024-04-05T07:33:00.172Z (10 months ago)
Topics: caller-id, deno, deno-kv, phone-number-lookup, telegram-bot, truecaller, truecallerjs
Language: TypeScript
Homepage: https://t.me/truecallerjs_bot
Size: 103 KB
Stars: 29
Watchers: 2
Forks: 31
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 📞Truecaller Search Bot

A Telegram bot that uses an unofficial Truecaller API to look up phone number information instantly. It's an alternative for occasional use of Truecaller than running their app in background all the time.

This bot is based on the sumithemmadi/truecallerjs library and is live at @truecallerjs_bot

## Self-host

This is a Deno project currently deployed on Deno Deploy. It uses Deno KV which requires you to [join the waitlist](https://dash.deno.com/kv) first before you get access to it.

### Setup Telegram Bot

1. Create a new bot using [@BotFather](https://t.me/BotFather).
2. Set the bot commands:

```plaintext
login - Login to Truecaller
installation_id - Login via existing token
logout - Logout from Truecaller
info - Information about the bot
```

3. [Set the webhook URL](https://core.telegram.org/bots/api#setwebhook) after deploying the bot using the following procedure.

### Deno Deploy

1. [Fork](/../../fork) this repo on GitHub.
2. Create a [new Deno Deploy](https://dash.deno.com/new) project from the forked repo.
3. Go to the project's `Settings` tab and add the Environment Variables from [.env.example](.env.example) file. You can skip adding the optional envs as they aren't critical to the service.
4. Grab the deployment URL from the `Overview` tab and set the webhook mentioned in previous section.

## Information

**Author:** [Nissan Ahmed](https://anissan.com) ([@ni554n](https://twitter.com/ni554n))

**Donate:** [PayPal](https://paypal.me/ni554n)