სიგნალის სახლის სახელმძღვანელო: აშენება AI SMS და ხმოვანი API-ის მქონე აგენტები

სიგნალის სახლი არის SMS და ხმოვანი API დეველოპერებისთვის მშენებლობისთვის AI აგენტები, რომლებიც ჩატის ფანჯრის მიღმა ურთიერთობენ. ეს არის SDK, შემომავალი ვებჰუკები, მიწოდების ჟურნალები და პროგრამირებადი ზარების მხარდაჭერის, დანიშვნის ასისტენტები, მომხმარებელთა მომსახურების აგენტები და ანგარიშის განახლებები.

სასარგებლო აგენტმა დამაჯერებელი პასუხის დაწერაზე მეტი უნდა გააკეთოს. თქვენს პროგრამულ უზრუნველყოფას ეს პასუხი უნდა გაუგზავნოს, მიიღოს პასუხი, ამოიცნოს მიწოდების ხარვეზები და იცოდეს, როდის უნდა გადაიბაროს სხვა პირმა.

Signal House უზრუნველყოფს შეტყობინებებისა და ზარების ინფრასტრუქტურას, ხოლო თქვენი აპლიკაცია აკონტროლებს მოდელის შერჩევას, მეხსიერებას და ბიზნეს წესებს. მისი ინტეგრაციის გზა შეესაბამება AI კოდირების ხელსაწყოები, რათა ტელეკომუნიკაციების დაყენება ცალკე საინჟინრო პროექტად არ განიხილოთ, საუბრებზე დაყრდნობით შეძლოთ.

AI Native იწყება თქვენი კოდირების სამუშაო პროცესის შიგნით

მანამდე კომუნიკაციების API სამუშაო პროცესები როგორც წესი, იწყება საცნობარო გვერდებით, ბოლო წერტილის ხელით გაყვანილობით და უკუკავშირის კონფიგურაციით. Signal House ინტეგრაციას უახლოვდება AI დამხმარე განვითარება, მათ შორის Cursor-ისა და Lovable-ის დაყენების გზა. დეველოპერებს შეუძლიათ სთხოვონ კოდირების ასისტენტს, შეამოწმოს მისი SDK და დანერგოს შეტყობინებების ფუნქცია რეალური მეთოდის ხელმოწერებთან შედარებით.

განსხვავება იმაში არ მდგომარეობს, რომ დამკვიდრებულ საკომუნიკაციო პლატფორმებს არ შეუძლიათ აგენტების მხარდაჭერა. უკეთესი კითხვაა, თუ რამდენად ინტეგრაციის კონტექსტს იღებს თქვენი კოდირების ინსტრუმენტი კოდის შექმნამდე.

Signal House-ის SDK პაკეტი მოიცავს agents.skills-ის ჩანაწერს და კომპლექტურ ინსტრუქციებს, რომლებიც მოიცავს დაყენებას, SMS-ს, webhook-ებს, ნომრებს და 10DLC-ს. ეს არის კონკრეტული საშენი ბლოკები. AI მშობლიური საკომუნიკაციო ინფრასტრუქტურა, არა მხოლოდ სლოგანი.

დეველოპერის დავალება	სიგნალის სახლის კომპონენტი	თქვენი განაცხადის პასუხისმგებლობა
გაუგზავნეთ კლიენტებს შეტყობინებები	შეტყობინებების SDK	მიმღებების და კონტენტის დამტკიცება
პასუხებზე რეაგირება	შემომავალი ვებჰუკები	საუბრის კონტექსტის მოძიება
ცალკეული მომხმარებლის პროექტები	ქვეჯგუფები	მოიჯარეების ნებართვების აღსრულება
დაამატეთ სატელეფონო კომუნიკაციები	ხმის API	აირჩიეთ საუბარი და გადაცემის ლოგიკა

ქვეჯგუფები აწყობენ რიცხვებს, ბრენდებსა და კამპანიებს მომხმარებლის ან გამოყენების შემთხვევის მიხედვით. არ განიხილოთ ორგანიზაციული ჯგუფი, როგორც აპლიკაციის ავტორიზაციის შემცვლელი. საკუთრების შემოწმება შეინახეთ ყველა შეტყობინების ინსტრუმენტის გვერდით, რომლის გამოძახებაც თქვენს მოდელს შეუძლია.

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

Signal House მხარს უჭერს უკუსვლით ინიცირებულ ზარებს, ბრაუზერის ზარებს და SHML ზარების კონტროლს. SHML იყენებს XML პასუხებს ზარისთვის ტექსტის წარმოთქმის, აუდიოს დაკვრის, კლავიატურის შეყვანის შეგროვების, აუდიოს ჩაწერის ან სხვა ნომრის დასაკავშირებლად მითითების მისაცემად.

ბექენდ ზარისთვის, დააინსტალირეთ ზემოთ მოცემული SDK და გამოიყენეთ ES მოდული. დააყენეთ ქვემოთ მითითებული ოთხი გარემოს ცვლადი. გამგზავნი უნდა იყოს თქვენი ხმოვანი სიგნალით აღჭურვილი ნომერი; ANSWER_URL უნდა იყოს HTTPS საბოლოო წერტილი , რომელიც აბრუნებს თქვენს ზარის ინსტრუქციებს.

import { SignalHouseSDK } from "@signalhousellc/sdk";
const required = ["SH_API_KEY", "CALL_FROM", "CALL_TO", "ANSWER_URL"];
for (const name of required) {
  if (!process.env[name]) throw new Error(`Missing ${name}`);
}
const client = new SignalHouseSDK({
  apiKey: process.env.SH_API_KEY,
  baseUrl: "https://v2.signalhouse.io",
});
try {
  const { data } = await client.voice.calls.create({
    callData: {
      from: process.env.CALL_FROM,
      to: process.env.CALL_TO,
      answer_url: process.env.ANSWER_URL,
    },
  });
  console.log({ callId: data.call_id, status: data.status });
} catch (error) {
  console.error("Call request failed", {
    status: error?.response?.status ?? "unknown",
  });
  process.exitCode = 1;
}

ეს მაგალითი იწყებს ზარს; ის არ ახორციელებს პირდაპირი მეტყველების აგენტს. დაამატეთ დანიშნულების ადგილის ავტორიზაცია, სანამ მას აპლიკაციის საბოლოო წერტილის მეშვეობით გამოავლენთ.

შემომავალი ზარებისთვის საჭიროა პროგრამირებადი ხმოვანი პროფილი . დააყენეთ routeAction CALL_CONTROL-ზე, მიმართეთ webhookUrl თქვენს დამმუშავებელზე და მიანიჭეთ ნომერი. უკუზარები მოიცავს CallSid-ს, From-ს, To-ს და CallStatus-ს. შეინახეთ ზარის იდენტიფიკატორი თქვენი საუბრის ჩანაწერის გვერდით, რათა შემდგომი SMS დადასტურება იმავე მომხმარებლის დავალებას ეკუთვნოდეს.

ბრაუზერის გამოძახებისთვის, დააინსტალირეთ jssip SDK-თან ერთად. თქვენი სერვერი გასცემს დროებით ხმოვან ტოკენს და ბრაუზერი იყენებს @signalhousellc/sdk/voice-browser-დან მოწყობილობას რეგისტრაციისა და დასაკავშირებლად. დაადასტურეთ თქვენი ტოკენის საბოლოო წერტილი და შეინახეთ მუდმივი ავტორიზაციის მონაცემები სერვერზე.

პირდაპირი საუბრისთვის ზარის დაწყებაზე მეტია საჭირო. ხმოვანი მოდელის დასტის არჩევამდე დარწმუნდით, რომ არსებობს თავსებადი აუდიო კავშირი, მეტყველების ამოცნობა , საპასუხო აუდიო და შეფერხებების დამუშავება. SHML კლავიატურის კოლექცია არ წარმოადგენს ორმხრივი მოდელის აუდიო ნაკადის დასტურს. ამ გადაწყვეტილების გადაჭრა უნდა მოხდეს დოკუმენტურად დადასტურებული მედია ინტეგრაციით.

დაიწყეთ შეზღუდული შეხსენებით ან ადამიანის მიერ გადაცემით. დაამატეთ პირდაპირი სასაუბრო მეტყველება მხოლოდ ამ კავშირის დადასტურების შემდეგ.

მიწოდების ქვითრები თქვენი აგენტის შემდეგი ნაბიჯის მამოძრავებელი ძალა უნდა იყოს

Signal House-ის შეტყობინებების ჟურნალები ავლენს შეტყობინებების იდენტიფიკატორებს, სეგმენტების რაოდენობას, ღირებულებას, ოპერატორის პასუხებს და მიწოდების პროგრესს. გამოიყენეთ ეს ჩანაწერები API-ის მიღებისა და ტელეფონის მიწოდების განცალკევებისთვის.

შეტყობინების მდგომარეობა	რაც იმას ნიშნავს,	შემოთავაზებული აპლიკაციის მოქმედება
შექმნილია	სიგნალის სახლში მიიღეს	შეინახეთ შეტყობინების იდენტიფიკატორი
რიგში დგომა	ელოდება გაგზავნას	მიწოდების მოლოდინის რეჟიმში დატოვება
რიგიდან ამოღებული	ამოღებულია რიგიდან	განაგრძეთ ოპერატორის პროგრესის მოლოდინი
Sent	მიწოდებისთვის გადაეცა	არ მონიშნოთ, როგორც მიწოდებული
მიწოდება	მიწოდების ქვითარი მიღებულია	ტრანსპორტირების შედეგის განახლება
შეცდომა	შეცდომა დაფიქსირდა	ხელახლა ცდამდე კლასიფიცირება

მიწოდებული შეტყობინება არ წარმოადგენს იმის დასტურს, რომ მომხმარებელმა წაიკითხა ან გაიგო მისი შინაარსი. საქმიანი შედეგები, როგორიცაა „შეხვედრა მიღებულია“, ტრანსპორტირების მდგომარეობებისგან განცალკევებულად შეინახეთ.

ქვითრის არარსებობამ ავტომატურად არ უნდა გამოიწვიოს მეორე SMS-ის ან სატელეფონო ზარის გაგზავნის გამოწვევა. თქვენს აპლიკაციაში დააყენეთ მკაფიო ლოდინის პოლიტიკა და ესკალაციის გზა.

ფასების აგენტების საუბრები სეგმენტების მიხედვით, პასუხების გარეშე

Signal House-ის 2026 წლის ადგილობრივი 10DLC SMS-ის ტარიფი გამავალი სეგმენტისთვის 0.0065 აშშ დოლარია, ოპერატორის გადასახადის გარეშე. AT&T დამატებით 0.0035 აშშ დოლარს იხდის; Verizon-ი და T-Mobile კი 0.0045 აშშ დოლარს. უფრო მაღალი მოცულობის დონეები პლატფორმის ტარიფებს ამცირებს.

ღირებულების კომპონენტი	შესვლის საფასური
ადგილობრივი გამავალი SMS შეტყობინებები	0.0065 აშშ დოლარი თითო სეგმენტზე
უფასო გამავალი SMS შეტყობინებები	0.0079 აშშ დოლარი თითო სეგმენტზე
ბრენდის ვერიფიკაცია	4.50 აშშ დოლარი დადასტურების თითოეული მცდელობისთვის
კამპანიის რეგისტრაცია	15 დოლარი ერთხელ
დაბალი მოცულობის კამპანია	$ 1.50 თვეში
სტანდარტული კამპანია	$ 10 თვეში

ოპერატორის საკომისიოები, ნომრის გადასახადი და ნებისმიერი დამატებითი სერვისი ამ შეტყობინებების საბაზისო ტარიფებს სცილდება. წარმოების ტრაფიკის დაფინანსებამდე დაადასტურეთ ანგარიშის სპეციფიკური MMS, ნომრის განახლების და ხმოვანი ზარების საფასური.

განვიხილოთ 10,000 გამავალი ერთსეგმენტიანი ლოკალური შეტყობინება, რომელთაგან ყველას ეკისრება ოპერატორის 0.0045 აშშ დოლარის საკომისიო. პლატფორმის საკომისიო შეადგენს 65 აშშ დოლარს, ხოლო ოპერატორის საკომისიო - 45 აშშ დოლარს, რაც გამოიმუშავებს 110 აშშ დოლარს ნომრების, რეგისტრაციის, შემომავალი ტრაფიკის , ხმოვანი და მოდელის ხარჯების გარეშე. ეს არის გაანგარიშების მაგალითი და არა სრული ციტატა.

ახლა დაამატეთ მოდელის დეტალიზაცია. GSM 7 შეტყობინებები ერთ სეგმენტში 160 კოდირების ერთეულს ეტევა, ან 153 კოდირების ერთეულს თითოეულ ნაწილზე გაერთიანების შემდეგ. UCS 2 შეტყობინებები ერთ სეგმენტში 70 კოდირების ერთეულს და გაერთიანებულ ნაწილზე 67-ს იძლევა. ამიტომ, Unicode-ის კონტენტს შეუძლია მკვეთრად შეცვალოს ხარჯები.

გაგზავნამდე გაზომეთ SMS სეგმენტზე დაფუძნებული ფასები კოდირების მრიცხველის გამოყენებით. მიაწოდეთ თქვენს აგენტს სიგრძის ბიუჯეტი და საჭიროების შემთხვევაში გაუგზავნეთ დეტალური მასალა დამტკიცებული ბმულის საშუალებით.

უფრო მოკლე პასუხი უბრალოდ უფრო სუფთა ტექსტი არ არის. მასშტაბურად, მას შეუძლია შეამციროს როგორც დარიცხული სეგმენტები, ასევე ზეწოლა გაგზავნის ლიმიტებზე.

გამტარუნარიანობისა და ადამიანური გადაცემის კონტროლის ქვეშ შენარჩუნება

კამპანიის არჩევანი გავლენას ახდენს გამტარუნარიანობაზე. Signal House-ის დაბალი მოცულობის შერეული ვარიანტი საშუალებას იძლევა დღეში სულ 6,000-მდე სეგმენტის განთავსებისა, მათ შორის T-Mobile-ის დღიური 2,000 სეგმენტის ლიმიტის ჩათვლით. დაბალი მოცულობის კამპანია უბრალოდ სტანდარტულ კამპანიად ვერ გადაიქცევა; საჭიროა ახალი რეგისტრაცია.

რიგები შექმენით დამტკიცებული ოპერატორის, ბრენდისა და კამპანიის ლიმიტებზე და არა წამში უნივერსალური მოთხოვნების სავარაუდო ლიმიტის მიხედვით. მოდელის პასუხების ტალღამ უნდა შექმნას რიგში ჩამდგარი სამუშაო და არა უკონტროლო გაგზავნის მცდელობები.

უფრო ფართოდ გამოქვეყნებამდე, საჭიროა სამი დაკვირვებადი შემოწმება:

გადაცემა ისევე ფრთხილად დაგეგმეთ, როგორც დაჯავშნა. გადაცემის დაწყებამდე საუბრის საკუთრება დააყენეთ ადამიანურზე, გააუქმეთ რიგში მდგომი ავტომატური შეტყობინებები და ოპერატორის ინტერფეისში გამოაჩინეთ წინა SMS კონტექსტი. საკუთრების გაუქმება მხოლოდ აშკარა ქმედების მეშვეობით.

შეინახეთ გაზიარებული საუბრის ჩანაწერი SMS-ითა და ხმოვანი შეტყობინებებით. ჩართეთ მომლოდინე შეხვედრები, წინა დაკავშირების მცდელობები და მიმდინარე მფლობელები, მაგრამ შეზღუდეთ მგრძნობიარე კონტენტი იმ როლებით, რომლებსაც წვდომა სჭირდებათ.

შესრულებული მომხმარებლის დავალებების გაზომვა საუბრის ღირებულებასთან ერთად. გაგზავნის რაოდენობა მხოლოდ ჯილდოს აქტივობაზეა დამოკიდებული და არა სასარგებლო შედეგებზე.

შექმენით კომუნიკაციის ფენა, რომლის გამოყენებაც თქვენს აგენტს რეალურად შეუძლია

მომხმარებლებთან დასაკავშირებლად შექმნილ აგენტს მხოლოდ ქმედითი მოდელი არ სჭირდება. Signal House დეველოპერებს პრაქტიკულ გზას სთავაზობს გენერირებული ტექსტური შეტყობინებების გაცვლიდან SMS-ებისა და პროგრამირებადი ზარების გაცვლამდე, რომელსაც მხარს უჭერს SDK კონტექსტი, ვებჰუკები და მიწოდების ხილვადობა.

დაიწყეთ ერთი დამტკიცებული სამუშაო პროცესით. დააკავშირეთ რიცხვი, დაამტკიცეთ პასუხები, შეზღუდეთ მოდელის მოქმედებები და შეამოწმეთ ხარჯები სირთულის დამატებამდე. მასშტაბირების დრო სამუშაო შედეგებმა გადაწყვიტოს და არა შთამბეჭდავმა დაპირებებმა.

თუ თქვენ აშენებთ AI აგენტს, რომელსაც SMS ან ხმა სჭირდება, ააშენოს თავისი საკომუნიკაციო ფენა Signal House-ზე. შეინარჩუნეთ ინტელექტი თქვენს აპლიკაციაში და ანგარიშვალდებული გახადეთ მომხმარებელთან ყველა ურთიერთქმედება.