> ## Documentation Index
> Fetch the complete documentation index at: https://docs.naturalead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Inbound

> Receives inbound messages from Telegram. This endpoint is registered
as the Telegram bot webhook URL. Non-text messages are acknowledged
but ignored. The account is resolved by matching the bot token stored
in the integration collection.




## OpenAPI

````yaml POST /api/webhooks/telegram
openapi: 3.1.0
info:
  title: Naturalead Inbound Webhooks API
  version: 1.0.0
  description: >
    Inbound webhook endpoints for receiving messages and leads from external

    services. These endpoints do not use standard API key authentication.

    Each channel uses its own verification mechanism (token-based,
    signature-based,

    or challenge-response).
servers:
  - url: '{baseUrl}'
    description: API server
    variables:
      baseUrl:
        default: http://localhost:3001
security: []
tags:
  - name: Lead Webhooks
    description: Inbound lead creation via webhook token
  - name: Telegram Webhooks
    description: Inbound Telegram messages
  - name: Email Webhooks
    description: Inbound email messages via Resend
  - name: WhatsApp Webhooks
    description: Inbound WhatsApp messages via Meta Cloud API
paths:
  /api/webhooks/telegram:
    post:
      tags:
        - Telegram Webhooks
      summary: Telegram inbound webhook
      description: |
        Receives inbound messages from Telegram. This endpoint is registered
        as the Telegram bot webhook URL. Non-text messages are acknowledged
        but ignored. The account is resolved by matching the bot token stored
        in the integration collection.
      operationId: telegramInbound
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Telegram Update object
              properties:
                message:
                  type: object
                  properties:
                    text:
                      type: string
                    chat:
                      type: object
                      properties:
                        id:
                          type: integer
      responses:
        '200':
          description: Webhook acknowledged
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
      security: []

````