Passer au contenu principal
POST
Connect a Telegram bot

Autorisations

Authorization
string
header
requis

Company API key, sent as Authorization: Bearer <key>. Create it in the dashboard (Developer > API Keys) with the permissions the integration needs.

Corps

application/json
bot_token
string

Token given by @BotFather (/newbot). Required on creation; on update only to replace a regenerated token of the same bot. Never returned.

Exemple:

"123456789:AAH..."

name
string

Internal name, the name of the bot by default

Maximum string length: 255
agent_id
string | null

Agent answering on the bot; null detaches it

Exemple:

"AGI-XXXXX"

enabled
boolean
défaut:true

Disabled, the bot no longer receives messages

Réponse

200 - application/json

Always HTTP 200: the outcome is in success and code (absolute value of the response code).

success
boolean
Exemple:

true

code
integer
Exemple:

1000

message
string
Exemple:

"Request success."

body
object

Endpoint payload, null when there is none

token
string | null

Present only on authentication routes

trace_id
string | null

Present only when success is false