Crear instância Telegram

curl --request POST \ --url https://api.notifique.dev/v1/telegram/instances \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Atención", "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" } }

Autorizaciones

Authorization

string

header

requerido

Authorization: Bearer sk_live_xxxxx

Cuerpo

application/json

name

string

requerido

Nombre para identificar esta conexión en el panel.

Minimum string length: 2

mode

enum<string>

requerido

BOT: bot con token. USER: cuenta personal/pro con login por QR.

Opciones disponibles:

BOT,

USER

botToken

string

Token del bot (obligatorio cuando mode es BOT).

acceptUserTerms

boolean

Obligatorio true en modo USER — confirma que entiende las reglas de automatización.

termsVersion

string

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). No altera o funcionamento da API.

Maximum string length: 32

generateShareableLink

boolean

predeterminado:false

Devuelve un enlace para que otra persona termine el login. Omita para recibir el QR en la respuesta.

Respuesta

Cuenta registrada. El bot queda ACTIVE con webhookUrl. La cuenta de usuario suele quedar PENDING hasta completar el login (QR o enlace).

success

boolean

data

object

Show child attributes