curl --request POST \
--url https://api.notifique.dev/v1/telegram/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Atendimento",
"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
Criar instância Telegram
Conecta uma conta Telegram ao seu workspace — o canal por onde entram e saem mensagens. Escolha o exemplo: - Bot com token — robô que responde sozinho (@BotFather).
- Conta de usuário: QR na sua tela — você exibe o código e faz login na hora.
- Conta de usuário: link para o cliente — envia um link; a pessoa conclui o login no Telegram dela. Escopo: 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": "Atendimento",
"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"
}
}
Autorizações
ntfTgBearerAuthntfTgApiKeyHeader
Authorization: Bearer sk_live_xxxxx
Corpo
application/json
Nome para identificar esta conexão no painel.
Minimum string length:
2BOT: robô com token. USER: conta pessoal/profissional com login por QR.
Opções disponíveis:
BOT, USER Token do bot (obrigatório quando mode é BOT).
Obrigatório true no modo USER — confirma que você entende as regras de automação.
Opcional. 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). Não altera o funcionamento da API.
Maximum string length:
32Gera um link para outra pessoa concluir o login. Omita para receber o QR na resposta.
Esta página foi útil?