Update Telegram Bot

Endpoint to update a Telegram bot in the ToolzzAI agent.

Request Example

curl --request PUT \
  --url https://chat.api.toolzz.com.br/api/v1/telegram/integration/{integrationId} \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '
  {
      "botId": "uuid",
      "unitId": "uuid",
      "title": "string",
      "scope": "string"
  }
'

Response Example

{
    "id": "uuid",
    "botId": "uuid",
    "unitId": "uuid",
    "title": "<string>",
    "isActive": true,
    "botToken": "telegram_bot_token",
    "isTokenMasked": true,
    "scope": "<string>",
    "welcomeMessage": "<string>",
    "createdAt": "2026-04-23 17:16:28.699018",
    "updatedAt": "2026-04-23 17:19:46.607",
    "deletedAt": null
}

Request description

Access Token

Parameter	Type	Description	Required
Authorization	String	Access token (“Bearer” must be before the token)	Yes

URL Parameters (Path)

Parameter	Type	Description	Required
integrationId	UUID	Unique integration identifier in the database.	Yes

Body Parameters

Key	Type	Description	Required
botId	UUID	Unique bot identifier in the Toolzz AI system.	Yes
unitId	UUID	Unique identifier of the owning organizational unit.	Yes
title	String	Custom identifier name for the integration.	Yes
scope	String	Defines the new scope of action for the bot (e.g., groups, private, or both).	Yes

Response description

Key	Type	Description
id	UUID	Unique identifier of the integration configuration in the database.
botId	UUID	Identifier of the bot associated within the Toolzz AI platform.
unitId	UUID	Unique identifier of the owning organizational unit.
title	String	Integration identifier name (e.g., “Telegram Bea”).
isActive	Boolean	Defines if the integration is active and enabled to process messages.
botToken	String	Telegram authentication token (API Key), returned in a masked form.
isTokenMasked	Boolean	Signals if the botToken in the response is hidden for security.
scope	String	Updated scope of action (e.g., groups, private, both).
welcomeMessage	String	Automatic greeting text sent when starting an interaction.
createdAt	String	Original record creation date and time (ISO 8601).
updatedAt	String	Date and time of the last modification (reflects the moment of update).
deletedAt	String/Null	Logical deletion date (Soft Delete), if the record was removed.

---

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request. Additionally, the API is protected by other security measures to safeguard user data.

To access your access token, follow these steps:

1. Log in to the ToolzzAI platform
2. Click on “Settings”
3. Click on “Access Token”
4. Copy the access token