curl --request POST \
--url https://api.notifique.dev/v1/telegram/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Support",
"mode": "BOT",
"botToken": "123456:ABC-DEF"
}
'{
"success": true,
"data": {
"id": "clxx_inst_bot",
"name": "Atendimento",
"status": "ACTIVE",
"mode": "BOT",
"botUsername": "@meubot",
"webhookUrl": "https://api.notifique.dev/webhooks/telegram/clxx_inst_bot"
}
}Instâncias
Create Telegram instance
Connect a Telegram account to your workspace — the channel that sends and receives messages. Pick an example: - Bot with token — automated bot (@BotFather).
- User account: QR on your screen — you show the code and log in right there.
- User account: link for the customer — send a link; they finish login on their Telegram. Scope: telegram:instances:create.
POST
/
v1
/
telegram
/
instances
curl --request POST \
--url https://api.notifique.dev/v1/telegram/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Support",
"mode": "BOT",
"botToken": "123456:ABC-DEF"
}
'{
"success": true,
"data": {
"id": "clxx_inst_bot",
"name": "Atendimento",
"status": "ACTIVE",
"mode": "BOT",
"botUsername": "@meubot",
"webhookUrl": "https://api.notifique.dev/webhooks/telegram/clxx_inst_bot"
}
}Authorizations
ntfTgBearerAuthntfTgApiKeyHeader
Authorization: Bearer sk_live_xxxxx
Body
application/json
Friendly name for this connection in the dashboard.
Minimum string length:
2BOT: bot with token. USER: personal/pro account with QR login.
Available options:
BOT, USER Bot token (required when mode is BOT).
Required true for USER mode — confirms you understand automation rules.
Optional. Rótulo da versão dos termos aceitos no modo USER (ex.: 2026-04 ou v2), usado só para registro e auditoria. Se omitido, o servidor grava um valor padrão (v1). No altera o funcionamento da API.
Maximum string length:
32Returns a link for someone else to finish login. Omit to get the QR in the response.
Was this page helpful?