LINQ

დაუკავშირეთ PRX iMessage, RCS და SMS შეტყობინებებს Linq Partner V3 API-ის მეშვეობით მრავალპროტოკოლიანი მობილური შეტყობინებებისთვის.

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

• Linq Partner ანგარიში API წვდომით
• Linq API ტოკენი
• Linq-ის მეშვეობით გამოყოფილი ტელეფონის ნომერი შეტყობინებების გასაგზავნად

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

1. API სანდოობის მონაცემების მიღება

1. დარეგისტრირდით Linq Partner ანგარიშისთვის linqapp.com-ზე
2. მიიღეთ თქვენი API ტოკენი პარტნიორის დაფიდან
3. ჩაინიშნეთ თქვენს ანგარიშზე გაგზავნისთვის მინიჭებული ტელეფონის ნომერი

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

[channels_config.linq]
api_token = "your-linq-api-token"
from_phone = "+15551234567"
allowed_senders = ["+1987654321"]

3. Webhook-ების გამართვა

კონფიგურირეთ Linq webhook მოვლენების PRX გეითვეის ენდფოინთზე გასაგზავნად:

POST https://your-prx-domain.com/linq

4. შემოწმება

prx channel doctor linq

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

ველი	ტიპი	ნაგულისხმევი	აღწერა
api_token	String	სავალდებულო	Linq Partner API ტოკენი (Bearer ავთენტიფიკაციად გამოიყენება)
from_phone	String	სავალდებულო	გაგზავნის ტელეფონის ნომერი (E.164 ფორმატი, მაგ., "+15551234567")
signing_secret	String	null	Webhook-ის ხელმოწერის საიდუმლო HMAC ხელმოწერის ვერიფიკაციისთვის
allowed_senders	[String]	[]	ნებადართული გამგზავნის ტელეფონის ნომრები E.164 ფორმატში. "*" = ყველას დაშვება

ფუნქციები

• მრავალპროტოკოლიანი შეტყობინებები -- iMessage, RCS და SMS-ით გაგზავნა და მიღება ერთი ინტეგრაციის მეშვეობით
• Webhook-ზე დაფუძნებული მიტანა -- შეტყობინებების მიღება HTTP webhook push-ით Linq-იდან
• სურათის მხარდაჭერა -- შემომავალი სურათის დანართების დამუშავება და სურათის მარკერებად რენდერი
• გამავალი/შემომავალი გამოვლენა -- საკუთარი გამავალი შეტყობინებების ავტომატური ფილტრაცია
• ხელმოწერის ვერიფიკაცია -- არასავალდებულო HMAC webhook ხელმოწერის ვალიდაცია signing_secret-ით
• E.164 ტელეფონის ნომრის ფილტრაცია -- წვდომის შეზღუდვა კონკრეტულ გამგზავნის ტელეფონის ნომრებზე

შეზღუდვები

• საჭიროა საჯაროდ ხელმისაწვდომი HTTPS ენდფოინთი webhook-ების მიტანისთვის
• Linq Partner API წვდომა პარტნიორის ანგარიშს მოითხოვს (არა სამომხმარებლო ანგარიშს)
• შეტყობინების მიტანა მიმღების შეტყობინების პროტოკოლზეა დამოკიდებული (iMessage, RCS ან SMS სარეზერვო)
• მხოლოდ სურათის MIME ტიპები მუშავდება ჩაშვებული დანართებისთვის; სხვა მედია ტიპები გამოტოვდება
• API რეიტ ლიმიტები თქვენი Linq Partner დონეზეა დამოკიდებული

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

Webhook მოვლენები არ მიიღება

• შეამოწმეთ webhook URL საჯაროდ ხელმისაწვდომია და https://your-domain/linq-ზე მიუთითებს
• შეამოწმეთ Linq პარტნიორის დაფა webhook მიტანის ლოგებისა და შეცდომებისთვის
• დარწმუნდით, რომ PRX გეითვეი გაშვებულია და სწორ პორტზე ისმენს

შეტყობინებები იგზავნება, მაგრამ პასუხები ვერ ხერხდება

• შეამოწმეთ api_token სწორია და ვადა არ გაუვიდა
• შეამოწმეთ from_phone სწორი, გამოყოფილი ტელეფონის ნომერია თქვენს Linq ანგარიშზე
• გადახედეთ Linq API-ის პასუხს შეცდომის დეტალებისთვის

ბოტი საკუთარ შეტყობინებებს პასუხობს

• ეს არ უნდა მოხდეს; PRX ავტომატურად ფილტრავს გამავალ შეტყობინებებს is_from_me და direction ველების გამოყენებით
• თუ მოხდა, შეამოწმეთ webhook payload-ის ფორმატი ემთხვევა მოსალოდნელ Linq V3 სტრუქტურას