بذار با مثال نشون بدم!

یعنی چی؟

حالت ساده: تو، ربات پورتال، یه چت دلتا چت. تا وصل نشی هیچی رد و بدل نمی‌شه.

این همون تلگرام همیشگیته. چت‌های الکی، شلوغ مثل همیشه. پورتال تو لیست نشسته — هنوز بازش نکردی.

هنوز وصل نیستی. گوشی راست هم دلتا چته، فقط یه لیست. تا پورتال رو نزنی چت اضافه‌ای نیست.

پورتال رو باز می‌کنی. چت خالی، خصوصی. /start اینجاست — نه تو گروه.

کد وصل شدن یه رازه. تو گروه هرکی می‌تونه بدزدتش. برای همین فقط تو چت دونفره.

بنویس /start (یا /pair). یعنی از ربات می‌خوای وصلت کنه.

دلتا چت هنوز خالیه. ربات هنوز کد نداده.

ربات دعوت دلتا چت (QR + لینک) و کدی مثل K7H2MQNP می‌فرستد.

دعوت یعنی آشنا شدن با حساب دلتا چت ربات. کد حدود نیم ساعت تو دیتابیس همون کامپیوتری که برنامه روشه می‌مونه. یعنی «هرکی این کد رو تو دلتا چت بفرسته» وصل می‌شه به تلگرام تو. کسی که برنامه رو اجرا می‌کنه اینو می‌بینه — برای همین بهتره خودت راهش بندازی.

دعوت را در Delta Chat / ArcaneChat باز کنید و بپذیرید. گوشی راست روشن می‌شود: دارید با پورتال حرف می‌زنید.

تا نپذیرید چتی نیست که جفت به آن وصل شود. هنوز جفت نشده‌اید — فقط در را باز کرده‌اید. دعوتِ مشترک چت می‌سازد ولی بدون کد جفت شما را نمی‌دزدد.

در همان دلتا چت فقط کد را بفرستید. حروف بزرگ/کوچک مهم نیست. کلمهٔ اضافه نگذارید.

ربات کد رو تو دیتابیس پیدا می‌کنه. اگر هنوز تازه باشه، تلگرام تو به همون چت دلتا چت وصل می‌شه. بعد از اون اگه دوباره یه چیزی شبیه کد بفرستی، فقط یه متنه — وصلی‌ت رو نمی‌دزده.

در تلگرام استیکر بفرستید. با نام خنثی و بدون زیرنویس «از تلگرام» در همان دلتا چت می‌نشیند.

برنامه فایل رو از تلگرام می‌گیره و می‌فرسته تو دلتا چت. تا وقتی فایل رو داره دانلود می‌کنه، همون کامپیوتر می‌تونه ببینتش. اسم فایل رو عوض می‌کنه تا اطلاعات اضافهٔ تلگرام لو نره.

از دلتا چت جواب دهید. همان متن یا استیکر به چت خصوصی تلگرام با ربات پورتال برمی‌گردد.

حالت شخصی یک چت واحد است: همه چیز در همین دونفره با پورتال است. دوستان اینجا چهرهٔ خود را ندارند. آن کار پرسوناست (دو داستان بعد).

یعنی چی؟

پرسونا یه چیز دیگه‌ست. جفت پورتال سر جاش، بعد ربات BotFather خودت رو وصل می‌کنی. روی ماشینی که خودت روشی.

همون تلگرام همیشگی. پورتال تو لیسته — داستان اول وصلش کردی. BotFather هم نشسته. هنوز هیچ‌کدوم رو باز نکردی.

پرسونا از یه وصلی آماده شروع می‌شه. گوشی راست هنوز دلتا چت معمولیه. هنوز چت روحی نیست.

اول داستان ۱ رو تمام کن. روح باید بدونه چطور به تو بنویسه. این از همون وصل شدن با /pair می‌اد.

دعوت دوم لازم نیست. وقتی /pair زدی، هویت دلتا چتت ذخیره شد. روح جدید با همون بهت پیام می‌ده. بدون /pair، دستور /pair-bot کار نمی‌کنه.

با @BotFather — سازندهٔ رسمی ربات تلگرام — ربات تازه بسازید و توکن را کپی کنید.

توکن رمز آن ربات است. هرکس آن را دارد همهٔ آپدیت را می‌خواند و به‌جای ربات حرف می‌زند. در issue گیت‌هاب، گروه، یا پورتال عمومی کس دیگر نگذارید.

در ربات پورتال، چت خصوصی، /pair-bot و توکن را بفرستید. لینک t.me اختیاری است.

/pair خودت رو وصل می‌کنه. /pair-bot ربات خودت رو ثبت می‌کنه. دو تا دستور جدا. گروه رد می‌شه که توکن لو نره. توکن می‌ره تو دیتابیس همون کامپیوتر و برنامه شروع می‌کنه پیام‌های رباتت رو گوش بده.

پورتال می‌گه رباتت روشنه. هرکی به @YourBot پیام خصوصی بده می‌تونه روح بگیره.

یعنی برنامه هی از تلگرام می‌پرسه «پیام تازه اومد؟» و ردش می‌کنه. دوستات @tgdeltabridgebot رو نمی‌بینن. فقط @YourBot رو می‌شناسن.

روی ماشینی که portal را اجرا می‌کند PERSONA_ACCOUNT_QR و mode: persona یا both را بگذارید.

روح یه حساب واقعی دلتا چته. برای ساختنش باید تو تنظیمات بگی از کدوم سرویس دلتا چت بسازه (PERSONA_ACCOUNT_QR). سقف تعداد رو هم می‌تونی بذاری. لیست: /bots. توقف: /unpair-bot.

بعد از /pair-bot هر کی به رباتت DM بده تو دلتا چت یه روح می‌شه — اسمش، عکسش، دفعهٔ بعد همون حساب.

این تلگرام آلیسه — شلوغی خودش، نه مال تو. @YourBot فقط یه ردیف تو لیسته. دلتا چت تو هنوز آلیس نداره.

آلیس دلتا چت نصب نکرده. پورتال رو نمی‌بینه. سمت تو همون لیست بعد از /pair-bot ه: پورتال، دوستا، هنوز روحی نیست.

آلیس دلتا چت نصب نمی‌کند. فقط @YourBot را باز می‌کند و DM می‌نویسد.

از دید آلیس این یک ربات معمولی تلگرام است. پورتال، کد جفت، و chatmail شما را نمی‌بیند.

برنامه تو دیتابیس می‌گرده: این ربات + آلیس رو قبلاً دیده؟

ندیده؟ یه حساب دلتا چت تازه می‌سازه با اسم و عکس تلگرام آلیس و تو دیتابیس نگه می‌داره. دیده؟ همون حساب قبلی. این جدا از وصل شدن خودته به پورتال.

در دلتا چت شما یک دونفره تازه باز می‌شود. مخاطب Alice است با عکسش. پیام پیشوند «از تلگرام» ندارد.

روح یه آدم واقعیه تو دلتا چت. برای تو انگار خود آلیس اومده نوشته. هدف پرسونا همینه: آدم‌ها، نه یه سطل با برچسب.

در دلتا چت مثل هر مخاطب دیگری جواب می‌دهید.

برنامه این چت رو می‌بینه و جوابتو از ربات @YourBot می‌فرسته. تلگرام نمی‌ذاره به‌جای آلیس حرف بزنی — فقط به‌جای ربات.

آلیس استیکر را از @YourBot می‌بیند. اگر بعداً Bob پیام بدهد، چت دوم می‌آید: Bob، نه Alice.

یک روح برای هر شناسهٔ تلگرام، برای همیشه. گروه اختیاری است (persona.allow_groups) و گروه دلتا چت TG: … می‌شود — جواب شما آنجا باز هم ربات است، نه هر گوینده.

برگرد به لیست. تلگرام آلیس هنوز یه چت رباته. سمت تو یه ردیف واقعی اومده: آلیس، صورتش، آخرین خطش.

اون ردیف جدیده همون روحه. دفعهٔ بعد که بنویسه همون چته. اگه باب به @YourBot پیام بده، ردیف دوم می‌آد — باب، قاطی آلیس نمی‌شه.