WhatsApp Web

დაუკავშირეთ PRX WhatsApp-ს ნატიური Rust Web კლიენტით (wa-rs) ბოლოდან ბოლომდე დაშიფვრით, QR კოდით ან წყვილ კოდით მიბმით და სრული მედია მხარდაჭერით.

წინაპირობები

• WhatsApp ანგარიში აქტიური ტელეფონის ნომრით
• PRX აშენებული whatsapp-web ფუნქციის ფლაგით
• Meta Business API ანგარიში არ არის საჭირო

სწრაფი დაყენება

1. ფუნქციის ფლაგის ჩართვა

ააშენეთ PRX WhatsApp Web მხარდაჭერით:

cargo build --release --features whatsapp-web

2. კონფიგურაცია

[channels_config.whatsapp]
session_path = "~/.config/openprx/whatsapp-session.db"
allowed_numbers = ["+1234567890", "*"]

წყვილ კოდით მიბმისთვის (QR კოდის ნაცვლად):

[channels_config.whatsapp]
session_path = "~/.config/openprx/whatsapp-session.db"
pair_phone = "15551234567"
allowed_numbers = ["*"]

3. ანგარიშის მიბმა

გაუშვით PRX. პირველ გაშვებაზე გამოჩნდება:

• QR კოდი ტერმინალში, რომელიც WhatsApp მობილური აპლიკაციით უნდა დაასკანეროთ, ან
• წყვილ კოდი თუ pair_phone მითითებულია (შეიყვანეთ კოდი WhatsApp > Linked Devices-ში)

4. შემოწმება

prx channel doctor whatsapp

კონფიგურაციის მითითება

ველი	ტიპი	ნაგულისხმევი	აღწერა
session_path	String	სავალდებულო	სესიის SQLite მონაცემთა ბაზის ბილიკი. ამ ველის არსებობა ირჩევს Web რეჟიმს
pair_phone	String	null	ტელეფონის ნომერი წყვილ კოდით მიბმისთვის (ფორმატი: ქვეყნის კოდი + ნომერი, მაგ., "15551234567"). მიუთითებლობისას QR კოდით დაწყვილება გამოიყენება
pair_code	String	null	მორგებული წყვილ კოდი მიბმისთვის. დატოვეთ ცარიელი, რომ WhatsApp-მა თავად შექმნას
allowed_numbers	[String]	[]	ნებადართული ტელეფონის ნომრები E.164 ფორმატში (მაგ., "+1234567890"). "*" = ყველას დაშვება

ფუნქციები

• Meta Business API არ არის საჭირო -- პირდაპირ უკავშირდება როგორც მიბმული მოწყობილობა WhatsApp Web პროტოკოლით
• ბოლოდან ბოლომდე დაშიფვრა -- შეტყობინებები Signal პროტოკოლით არის დაშიფრული, ოფიციალური WhatsApp კლიენტების მსგავსად
• QR კოდით და წყვილ კოდით მიბმა -- WhatsApp ანგარიშის მიბმის ორი გზა
• მუდმივი სესიები -- სესიის მდგომარეობა ლოკალურ SQLite მონაცემთა ბაზაში ინახება, გადატვირთვებს გადარჩება
• ჯგუფები და პირადი შეტყობინებები -- პირადი ჩატებისა და ჯგუფური საუბრების მხარდაჭერა
• მედია შეტყობინებები -- სურათების, დოკუმენტებისა და სხვა მედია ტიპების დამუშავება
• ხმოვანი ჩანიშვნების მხარდაჭერა -- შემომავალი ხმოვანი ჩანიშვნების ტრანსკრიბირება (STT-ის კონფიგურაციისას) და არასავალდებულოდ ხმოვანი ჩანიშვნებით პასუხობა (TTS-ის კონფიგურაციისას)
• ყოფნა და რეაქციები -- აკრეფის ინდიკატორებისა და შეტყობინების რეაქციების მხარდაჭერა

შეზღუდვები

• საჭიროებს whatsapp-web ფუნქციის ფლაგს კომპილაციის დროს
• თითო ტელეფონის ნომერზე მხოლოდ ერთი მიბმული მოწყობილობის სესიაა მხარდაჭერილი (WhatsApp-ის შეზღუდვა)
• სესიას შეიძლება ვადა გაუვიდეს ხანგრძლივი გამოუყენებლობისას; ხელახალი მიბმა საჭიროა
• მხოლოდ macOS, Linux და Windows WSL2 (იგივე რაც თავად PRX)
• WhatsApp-მა შეიძლება ზოგჯერ ხელახალი ავთენტიფიკაცია მოითხოვოს

პრობლემების მოგვარება

QR კოდი არ ჩანს

• დარწმუნდით, რომ session_path მითითებულია და დირექტორიაში ჩაწერა შეიძლება
• შეამოწმეთ, რომ PRX --features whatsapp-web-ით არის აშენებული
• წაშალეთ სესიის მონაცემთა ბაზა და გადატვირთეთ ახალი დაწყვილების იძულებისთვის

სესიის ვადა ამოიწურა ან გათიშულია

• წაშალეთ სესიის მონაცემთა ბაზა კონფიგურირებულ session_path-ზე
• გადატვირთეთ PRX ახალი QR კოდის ან წყვილ კოდის ნაკადის გასააქტიურებლად

ხმოვანი ჩანიშვნები არ ტრანსკრიბირდება

• კონფიგურირეთ [transcription] სექცია თქვენს PRX კონფიგურაციაში STT-ის ჩასართავად
• მხარდაჭერილი STT ბექენდები: OpenAI Whisper, Deepgram, AssemblyAI, Google STT

Cloud API რეჟიმი

თუ Meta Business ანგარიში გაქვთ და webhook-ზე დაფუძნებულ შეტყობინებებს ანიჭებთ უპირატესობას, იხილეთ WhatsApp (Cloud API).