Connecter Claude à Telegram Business — réponses IA supervisées

1. Créez un bot via @BotFather (/newbot).
2. Dans Telegram, Settings → Telegram Business → Chatbots. Collez le @username de votre bot. Accordez Read incoming messages + Reply on your behalf.
3. Dans le code de votre bot, écoutez les updates business_connection pour savoir quand vous avez été connecté, et stockez le business_connection_id résultant — vous en aurez besoin sur chaque réponse sortante.

// pseudo-code; pickez votre framework préféré
bot.on("business_connection", async (update) => {
  await db.businessConnection.upsert({
    where: { userId: update.user.id },
    update: { id: update.id, can_reply: update.can_reply },
    create: { id: update.id, userId: update.user.id, can_reply: update.can_reply },
  });
});

Telegram envoie un update business_message quand quelqu’un DM votre compte. La shape est identique à un message régulier, avec un business_connection_id extra.

bot.on("business_message", async (update) => {
  const msg = update.business_message;
  await db.message.create({
    data: {
      direction: "in",
      chatId: msg.chat.id,
      fromUserId: msg.from.id,
      text: msg.text,
      receivedAt: new Date(msg.date * 1000),
      businessConnectionId: update.business_connection_id,
    },
  });
  await draftReply(msg);
});

Le chat.id est l’id user du client. Stocker le thread de conversation key sur ça est le modèle le plus simple.

Claude a besoin de trois choses pour bien drafter : qui vous êtes, ce que vous avez déjà dit, et ce qui vient d’arriver.

async function draftReply(incomingMsg) {
  const history = await db.message.findMany({
    where: { chatId: incomingMsg.chat.id },
    orderBy: { receivedAt: "desc" },
    take: 20,
  });

  const conversation = history.reverse().map((m) => ({
    role: m.direction === "in" ? "user" : "assistant",
    content: m.text,
  }));

  const draft = await anthropic.messages.create({
    model: "claude-sonnet-4-6",
    max_tokens: 600,
    system: SYSTEM_PROMPT,
    messages: [
      ...conversation,
      { role: "user", content: incomingMsg.text },
    ],
  });

  return draft.content[0].text;
}

Le system prompt est où la majeure partie du travail se passe. Gardez-le court, spécifique, et fermement dans votre voix :

Vous draftez les réponses DM Telegram pour le compte de {your_name}, un {your_role}.
Voix : chaleureuse, concise, jamais gushing. "i" minuscule pour "I" seulement
quand l'humain à qui vous répondez le fait d'abord.

Règles :
- Répondre dans la même langue que le message entrant.
- Si le message demande un prix, liez vers /pricing plutôt que de quoter
  (l'humain ajustera).
- Ne jamais promettre des heures de calendrier. Suggérer "plus tard cette semaine"
  et laisser l'humain s'engager.
- Si le message est unclear, posez une question clarifiante.
- Si le message est hostile ou spam, draftez un one-liner poli
  fermant le thread.
- Maximum 4 phrases sauf si l'utilisateur demande du détail.

Itérez sur ce prompt deux semaines. C’est la différence entre des drafts que vous shippez 90% du temps vs 30%.

Créez un channel privé dans votre compte (“Drafts”). Ajoutez votre bot comme admin. Chaque draft poste là comme un message avec deux boutons inline : Send et Edit.

async function postDraftForApproval(incomingMsg, draftText) {
  await bot.api.sendMessage(DRAFTS_CHANNEL_ID, formatPreview(incomingMsg, draftText), {
    reply_markup: {
      inline_keyboard: [[
        { text: "✓ Send", callback_data: `send:${incomingMsg.chat.id}:${draftId}` },
        { text: "✎ Edit", callback_data: `edit:${incomingMsg.chat.id}:${draftId}` },
      ]],
    },
  });
}

function formatPreview(incomingMsg, draftText) {
  return `*De* ${incomingMsg.from.first_name} (@${incomingMsg.from.username || "—"})

> ${incomingMsg.text}

---
*Draft :*

${draftText}`;
}

Le channel Drafts devient votre file matinale. Skim, tap Send sur ce qui est juste, Edit sur ce qui ne l’est pas.

Sur callback, votre bot utilise le business_connection_id stocké pour envoyer la réponse en votre nom :

bot.on("callback_query", async (cq) => {
  const [action, chatId, draftId] = cq.data.split(":");
  const draft = await db.draft.findUnique({ where: { id: draftId } });
  const conn = await db.businessConnection.findFirst();

  if (action === "send") {
    await bot.api.sendMessage(Number(chatId), draft.text, {
      business_connection_id: conn.id,
    });
    await db.message.create({
      data: { direction: "out", chatId: Number(chatId), text: draft.text, sentAt: new Date() },
    });
    await bot.api.editMessageText(DRAFTS_CHANNEL_ID, cq.message.message_id, "✓ Sent: " + draft.text);
  }

  await bot.api.answerCallbackQuery(cq.id);
});

business_connection_id est ce qui dit à Telegram “ce message vient du compte de l’utilisateur, pas du bot”. Sans ça, le client voit la réponse de votre bot, pas de vous — relation entièrement différente.

Tap Edit → bot envoie le draft text back dans le channel Drafts comme un message normal avec un force_reply pour que vous puissiez éditer et répondre. Votre réponse devient le nouveau draft. Tap Send sur la version éditée.

Un flow deux-taps pour le cas commun (c’est bien), trois taps pour le cas edit (c’est pas parfait, à fixer).