Link a Chat

Updated 10 September 2026

POST `?action=start_chat_link`

Begin linking a Telegram or Discord chat to a login: the same one-time code the member area hands out. Show the code (and, for Telegram, the link or its QR); the customer sends it to the bot. It works once and lives 15 minutes; starting again retires the earlier code. Refresh the account (get_customer) afterwards — chats..linked turns true once the bot has taken it. Refused when the store does not offer that chat or it is already linked.

Request Parameters

Field	Type	Required	Description
`customer_id`	integer	Requiredone of these two	The customer
`customer_email`	string	Requiredone of these two	Their address
`platform`	string	Required	telegram or discord

Response Fields

Field	Type	Description
`code`	string	The 8-character code
`expires_in`	integer	Seconds the code lives (900)
`telegram_url`	string	A tap-to-link https://t.me/… link (Telegram only; empty until the bot has a username)
`telegram_scheme`	string	The same link in tg:// form, for a QR code
`discord_invite_url`	string	The server invite, when one is set (Discord only). In the server the customer types /link and pastes the code

Example request

$ch = curl_init('PANELR_API_URL?action=start_chat_link');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => '{"customer_id":12,"platform":"telegram"}',
    CURLOPT_HTTPHEADER => [
        'X-Panelr-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST "PANELR_API_URL?action=start_chat_link" \
  -H "X-Panelr-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":12,"platform":"telegram"}'

const res = await fetch('PANELR_API_URL?action=start_chat_link', {
  method: 'POST',
  headers: {
    'X-Panelr-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"customer_id":12,"platform":"telegram"}),
});
const { data } = await res.json();

import requests
r = requests.post('PANELR_API_URL',
    params={'action': 'start_chat_link'},
    headers={'X-Panelr-API-Key': 'YOUR_API_KEY'},
    json={"customer_id":12,"platform":"telegram"})
data = r.json()['data']

POST ?action=start_chat_link

Request Parameters

Response Fields

POST `?action=start_chat_link`