# Instantly when receiving a contact — Telegram Bot

Botize method — `telegrambot.webhook_contact` (trigger).

It is triggered every time a user sends a contact from their address book to the bot.

- To send contacts to a bot, use the attach button in your Telegram application.

This is a trigger: it starts the task. A task has exactly one.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `chat_source` *(string, one of: "any" = Task runs when receiving contacts from anyone; "target" = Task runs when receiving contacts from a specific user, group or channel, default: "any")*
- `chat_id` *(string)*

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{from_id}}` *(int)* — From User Id
- `{{message_id}}` *(int)* — Message Id
- `{{from_name}}` *(text)* — From Username
- `{{from_username}}` *(text)* — From Username. Username of the user who sent the message. By default, Telegram users don't have a username, so only people who have their phone number can send them messages. If a user has a username, anyone can send them messages through the link https://t.me/username, and they will appear in Telegram search with their username.
- `{{chat_id}}` *(text)* — From Chat Id
- `{{reply_to_message_username}}` *(text)* — Reply to message Username
- `{{reply_to_message_text}}` *(text)* — Reply to message Text
- `{{contact_user_id}}` *(int)* — Contact User Id
- `{{contact_phone_number}}` *(text)* — Contact Phone Number
- `{{contact_first_name}}` *(text)* — Contact First Name
- `{{contact_last_name}}` *(text)* — Contact Last Name

## Account

Needs a connected Telegram Bot account in Botize: https://botize.com/en/app/telegrambot/authenticate

## This app

Every trigger and action for Telegram Bot: https://botize.com/en/app/telegrambot.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/telegrambot/webhook_contact