Мақаланы аты-жөнін жасырғысы келген пайдаланушымыз бірінші жақтан жазды. Бұл мақалада біз оның атын Әлібек деп өзгерттік. Ол қосымшалар әзірлейді. Стилі мен сөз саптауы сақталды. Біз тек кейбір грамматикалық қателерді түзетіп, жеке деректерді жасырдық. Мақала үшін Әлібекке үлкен алғыс ❤️
Қысқасы, мен бейтаныс нөмірлерден келген қоңырауды көтермеймін. Мүлдем. Оның үстіне, шынымды айтсам, телефонмен тікелей сөйлескенде өзімді ыңғайсыз сезінемін. Мессенджерде жазысқанды жөн көремін. Ал мессенджердегі дауыстық хабарламаларды жек көремін!
Мәселе мынада: бейтаныс нөмірлерден келген жауапсыз қоңыраулардан кейін отырып алып ойлаймын: мүмкін бұл тапсырыс беруші болған шығар? Мүмкін оған портфолиом ұнап, шынымен әзірлеуге тапсырыс бергісі келген шығар? Өзім қайта қоңырау шалып сөйлесуге көп күш кетеді (менде), ал әңгімені кез келген мессенджерге көшірсем, керемет болар еді.
Тіпті телефонмен сөйлесуге көңіл-күйімді дайындап, өзімді жинап алсам да, көбіне кезекті "тиімді ұсыныстарға" және басқа да алаяқ қоңырауларға тап боламын, сонда жай ғана тұтқаны қоя саламын.
Сондықтан өзіме қоңыраулармен айналысатын жеке хатшы жасадым. Оның аты Айсулу. Оған Telegram арқылы нөмір жіберсем болды: өзі кері қоңырау шалып, кімнің не үшін хабарласқанын анықтайды. Маған қорытынды мен сөйлесу мәтінін жібереді, жазбаны дауыстық хабарлама ретінде жолдайды. Үш рет қатарынан жауап болмаса, спам деп белгілейді. Ал әңгіме қосымша әзірлеуге тапсырыс беру туралы болса, қоңырау шалған адамға маған Telegram не WhatsApp арқылы жазуды ұсынады.
Нөмірге қоңырау шалып, сөйлесетін AutoCall.kz дауыстық ЖИ-агенті, ал боттың өзі Python тілінде бірнеше жол ғана. Төменде қалай жасағанымды айтып, бүкіл кодты беремін.
Қалай жұмыс істейді?
- Бейтаныс нөмір қоңырау шалады. Көтермеймін, нөмірді «Кім қоңырау шалды?» ботына жіберемін.
- Бот AutoCall.kz API арқылы бір сұраныспен осы нөмірге менің агентіммен қоңырау науқанын қояды.
- Айсулу қоңырау шалып, өзін хатшы ретінде таныстырады да, кім екенін және не үшін хабарласқанын анықтайды. Жауаптарды өзі өрістерге бөледі: кім, қайдан, не үшін, мәліметтер.
- Әңгіме аяқталғанда AutoCall.kz ботқа вебхук жібереді.
- Бот маған қорытындыны, сөйлесу мәтінін және жазбаны дауыстық хабарлама ретінде жібереді.
Промпттарды лезде жазатын немесе әңгімені қайта баяндайтын бөлек нейрожелі жасамадым. Агентті жеке кабинетте бір рет баптадым, әңгіменің қорытындысын ол өзі жазады. Бот тек Telegram мен API арасындағы курьер.
Мысал: екі қоңырау, екі түрлі нәтиже
Біріншісі. Нөмір екі рет қоңырау шалған. Айсулу оны 15 минут үзіліспен үш рет терді, бірақ ешкім жауап бермеді. Telegram ішіне есеп келді: телефонды көтермейді, үш әрекет, сірә, спам. Мейлі.
Екіншісі. Сырым деген біреу маған Kaspi арқылы қателесіп ақша аударып жіберген сияқты және мен оны қайтармай қояды деп уайымдады. Айсулу соманы, күнді, атын жазып алып, бәрін маған жеткізетінін, ал аударым шынымен болса, міндетті түрде қайтаратынымды түсіндірді. Қоңыраудан бірер минут өткенде Telegram ішінде бәрі мәтін түрінде тұрды.
Аудиожазба тіркелген.
Айтпақшы, қызық жайт: ЖИ-агент қате аударым схемасы туралы білетін сияқты, сондықтан "Әлібек ақшаны банк қосымшасында қайтарады" деді. Классикалық тәсіл: ақшаны сол аударыммен кері емес, «басқа картаға» немесе «анамның нөміріне» қайтаруды сұрайды. Мен жай ғана банк қосымшасында жіберушіге қайтарамын, болды.
1-қадам. Хатшыны жасаймын
AutoCall.kz жеке кабинетінде «ЖИ-агенттер» бөлімі бар. Онда промптты қолмен жазудың қажеті жоқ: керегін өз сөзіңізбен сипаттайсыз, ал ЖИ өзі сұрақтар қойып, сценарий құрастырады. Әйел дауысын таңдап, атын Айсулу қойдым:
сәлем) өзіме хатшы жасағым келеді. сен Айсулу боласың, менің ЖИ-хатшым. менің атым Әлібек. бейтаныс нөмір қоңырау шалғанда, мен тұтқаны көтермеймін, себебі сөйлескенді ұнатпаймын, нөмірді телеграмдағы ботқа жіберемін, ал сен қайта қоңырау шаласың. кім қоңырау шалғанын, қайдан, не үшін екенін және жалпы барынша көп мәлімет білуің керек. бәрін жазып аласың, мен кейін телеграмнан оқимын
Сәлеметсіз бе, Әлібек! Тамаша міндет, сіздің жеке хатшыңыз болуға қуаныштымын.
Сценарийдің алғашқы нұсқасы мен қоңырау логикасын дайындап қойдым.
Әңгімені қалай бастаймын (3 қадаммен):
1. Сәлемдесу: «Алло, сәлеметсіз бе!» (үзіліс, жауап күтемін)
2. Әңгімеге тарту: «Көп алаңдатпаймын ба? Сөйлесуге ыңғайлы ма?» (үзіліс)
3. Таныстыру және мәні: «Менің атым Айсулу, мен Әлібектің хатшысымын. Мен Әлібектің жеке көмекшісімін. Сіз оған жаңа ғана қоңырау шалдыңыз, ол қазір жауап бере алмайды. Атыңыз кім және қандай мәселе бойынша хабарласқаныңызды айтып жібересіз бе?»
Сіз үшін есепке не жинаймын:
| Нөмір | Күйі | Ұзақт. | Кім қоңырау шалды | Компания / Қайдан | Мәселенің мәні | Мәліметтер мен тілектер |
|---|---|---|---|---|---|---|
| +7701XXXXXXX | Жауап берді | 65 | Ерлан | «СтройМаркет» ЖШС | Цемент партиясын төлеуге шот | Бүгін сағат 18:00 болғанша қайта қоңырау шалуды сұрайды |
Есептің мұндай құрамы мен әңгіменің басталуы сізге ұнай ма?
Және бірер нәрсені нақтылап беріңізші:
1. Немен айналысасыз немесе бизнесіңіз қандай? (Кәсіби терминдерді айта бастаса, әңгіменің мәнмәтінін түсінуім үшін).
2. Анық спам немесе суық сату (несие, сауалнама, курстар) болса не істеймін? Жай ғана сыпайы түрде қоңырауды аяқтаймын ба?
есеп жақсы 👍 мен фрилансермін, қосымшалар мен тг-боттар жасаймын, кейде клиенттер қоңырау шалады. спам мен сату болса, сыпайы қоштас, бірақ кім болса да бәрібір жазып ал. және тағы маңыздысы: Әлібек ауырып қалды, дауысы шықпай тұр, қазір телефонмен сөйлесе алмайды, сондықтан мен қоңырау шалып тұрмын де. тек менің атымнан ештеңе уәде берме, ал қайта қоңырау шалуды сұраса немесе не қалағанын айтқысы келмесе, маған Telegram немесе WhatsApp арқылы жазсын де
Барлық түзетулерді қабылдадым, Әлібек!
Сценарийді жаңарттым:
Қайта қоңырау себебі: Енді бірден сенің ауырып қалғаныңды, дауысың шықпай тұрғанын және әзірге телефонмен сөйлесе алмайтыныңды, сондықтан қоңырауды мен шалып тұрғанымды түсіндіремін.
Спам және сату: Егер бұл жарнама немесе сату болса, сыпайы қоштасамын, бірақ кім және не үшін қоңырау шалғанын есепке міндетті түрде жазамын.
Жасырса немесе қайта қоңырау шалуды сұраса: Сенің атыңнан ештеңе уәде бере алмайтынымды айтып, саған Telegram немесе WhatsApp арқылы тікелей жазуды ұсынамын.
Айтпақшы, қарапайым нұсқам дайын: «Тексеру» батырмасын басып, менімен тікелей сөйлесе аласыз. Ал біз әзірге мені жетілдіре береміз.
Адам қайта қоңырау шалуды сұраса немесе шұғыл сұрағы болса, оған сенің Telegram/WhatsApp сілтемең бар SMS жіберу керек пе? Әлде әзірге тек әңгімемен шектелеміз бе?
жоқ, смс керек емес. рақмет. ең бастысы бәрін біліп алуға тырыс өтінем
Келістік, SMS жібермейміз!
Тапсырма, мерзім және жоба бойынша барынша көп мәлімет жинау үшін нақтылау сұрақтарын мұқият әрі сыпайы қоямын, бірақ артық ештеңе уәде бермеймін. Барлық деректерді бірден есепке жазамын.
Бәрін баптадық. Қазір қоңырауды тексеріп көресің бе, әлде тағы бірдеңе қосамыз ба?
Бірнеше хабарлама, және хатшы дайын. Міне, не шықты:
Айсулудың толық сценарийі
## Сен кімсің Айсулу — Әлібектің жеке ЖИ-хатшысы (Әлібек қосымшалар мен Telegram-боттар әзірлейтін фрилансер). Сен Әлібекке жаңа ғана қоңырау шалған адамдарға қоңырау шалып, қоңыраудың мақсатын білесің және оған толық ақпарат жеткізесің. Мінезі: сыпайы, мұқият, жинақы, іскер. ## Қоңырау мақсаты Кім қоңырау шалып тұрғанын, қай компаниядан, қандай мәселе бойынша (қосымша/бот әзірлеу, серіктестік, спам/сату) екенін анықта және барынша көп мәлімет жина. ## Әңгіме барысы 1. Бірінші фраза ДӘЛ осындай: «Алло?! Сәлеметсіз бе!» және БОЛДЫ. Одан кейін үндемей, жауап күт. 2. Жауап берсе, әңгімеге тарту фразасы: «Көп алаңдатпаймын ба? Сөйлесуге ыңғайлы ма?» Тағы күт. 3. Жауап берсе, таныстыру мен мақсат ДӘЛ осындай: «Мен Әлібектің жеке көмекшісімін. Сіз оған жаңа ғана қоңырау шалдыңыз, бірақ ол ауырып қалды, дауысы шықпай тұр, сондықтан әзірге телефонмен сөйлесе алмайды және маған қайта қоңырау шалуды өтінді. Атыңыз кім және қандай мәселе бойынша хабарласқаныңызды айтып жібересіз бе?» 4. Алғашқы фразалардан кейін үндемесе, бір рет «Алло, мені естіп тұрсыз ба?» деп қайта сұра. Тағы тыныштық болса, сыпайы қоштасып, қоңырауды аяқта. 5. Атын, компаниясын/саласын және хабарласу себебін анықта. Жоба немесе тапсырма туралы барынша көп білу үшін нақтылау сұрақтарын қой. 6. Егер бұл спам, жарнама немесе сату болса, сыпайы қоштасып, қоңырауды аяқта, бірақ кім қоңырау шалғанын және не ұсынғанын есепке міндетті түрде жаз. 7. Егер әңгімелесуші өзін таныстырудан бас тартса, қоңырау мақсатын айтқысы келмесе немесе жай ғана Әлібектің қайта қоңырау шалуын сұраса, Әлібекке Telegram немесе WhatsApp арқылы тікелей жазуды ұсын. 8. Мәліметтерді анықта: мәселенің шұғылдығы, жобаның немесе ұсыныстың егжей-тегжейі. 9. Барлық деректер жазылғанын және Әлібекке жеткізілетінін раста. Сыпайы қоштас. ## Не жинау керек - caller_name: қоңырау шалушының аты-жөні. - company: компания, жоба немесе «жеке / жеке тұлға». - purpose: хабарласу себебі (қосымшаға тапсырыс, Telegram-бот, серіктестік, спам/жарнама). - details: өтініштің толық мәліметтері. ## Шектеулер - Әлібектің атынан ештеңе уәде берме (мерзім де, баға да, жобаларға/кездесулерге келісім де). - Әлібектің жеке ақпаратын жария етпе, тек оның ауырып қалғанын және дауысы шықпай тұрғанын айтуға болады. - Сөйлескісі келмесе немесе қайта қоңырау шалуды сұраса, Әлібекке Telegram немесе WhatsApp арқылы жазуды ұсын.
Ботқа келетін өрістер: caller_name (кім), company (қайдан), purpose (не үшін) және details (мәліметтер). Кілттерді есте сақтаңыз, бот дәл соларды шығарады.
2-қадам. API кілті
«API» бөлімінде тек бот үшін бөлек кілт жасаймын. Құқықтар ең аз: қоңырау науқандары мен қоңыраулар.
3-қадам. Боттың өзі
Ботты @BotFather арқылы тіркеймін, өз Telegram ID нөмірімді @userinfobot арқылы аламын: бот тек мені тыңдайды. Бүкіл код бір файлда:
bot.py
import asyncio
import html
import os
import re
import shutil
from aiohttp import ClientSession, web
from aiogram import Bot, Dispatcher, F
from aiogram.types import BufferedInputFile, Message
API = "https://autocall.kz/api/v1"
TOKEN = os.environ["TELEGRAM_TOKEN"]
OWNER_ID = int(os.environ["OWNER_ID"])
AUTOCALL_KEY = os.environ["AUTOCALL_KEY"]
AGENT_ID = int(os.environ["AGENT_ID"])
PUBLIC_URL = os.environ["PUBLIC_URL"].rstrip("/")
HOOK_SECRET = os.environ["HOOK_SECRET"]
PORT = int(os.environ.get("PORT", 8080))
FIELDS = {
"caller_name": "Кім",
"company": "Қайдан",
"purpose": "Не үшін",
"details": "Мәліметтер",
}
MISSED = {
"no_answer": "телефонды көтермейді",
"busy": "үнемі бос емес",
"error": "мұндай нөмір жоқ",
"spam": "енді қоңырау шалмауды сұрады",
}
bot = Bot(TOKEN)
dp = Dispatcher()
http: ClientSession
seen: set[int] = set()
def phone(text: str) -> str | None:
digits = re.sub(r"\D", "", text)
if len(digits) == 10:
digits = "7" + digits
if len(digits) != 11 or digits[0] not in "78":
return None
return "+7" + digits[1:]
async def to_voice(wav: bytes) -> bytes | None:
if not shutil.which("ffmpeg"):
return None
proc = await asyncio.create_subprocess_exec(
"ffmpeg", "-loglevel", "error", "-i", "pipe:0", "-c:a", "libopus", "-b:a", "24k", "-f", "ogg", "pipe:1",
stdin=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE,
)
ogg, _ = await proc.communicate(wav)
return ogg if proc.returncode == 0 else None
@dp.message(F.from_user.id == OWNER_ID, F.text)
async def callback_request(message: Message):
number = phone(message.text)
if not number:
await message.answer("нөмір жібер, мысалы +7 701 123 45 67")
return
payload = {
"name": f"Кім қоңырау шалды {number}",
"type": "agent",
"agent_id": AGENT_ID,
"list_id": [{"number": number}],
"time_from": "11:00:00",
"time_to": "21:00:00",
"max_tries": 3,
"tries_interval": 15,
"record": True,
"callback_url": f"{PUBLIC_URL}/hook/{HOOK_SECRET}",
}
async with http.post(f"{API}/autocalls", json=payload) as r:
if r.status != 201:
error = (await r.json(content_type=None) or {}).get("message", r.status)
await message.answer(f"болмады: {error}")
return
await message.answer(f"Айсулу {number} нөміріне қайта қоңырау шалып, бәрін біліп береді. көтермесе, тағы екі рет шалып көреді")
async def fresh(call: dict) -> dict:
async with http.get(f"{API}/autocalls/{call['autocall_id']}") as r:
if r.status != 200:
return call
calls = (await r.json())["calls"]["data"]
return next((c for c in calls if c["id"] == call["id"]), call)
async def report(call: dict):
number = call["number"]
if call["status"] in MISSED:
text = f"{number} {MISSED[call['status']]}, әрекет саны: {call['tries']}"
if call["status"] in ("no_answer", "busy"):
text += "\nсірә, спам"
await bot.send_message(OWNER_ID, text)
return
# өрістер мен сөйлесу мәтіні қоңыраудан кейін тағы он секундтай толығып жатады
await asyncio.sleep(15)
call = await fresh(call)
data = call.get("data") or {}
lines = [f"<b>{label}:</b> {html.escape(str(data[key]))}" for key, label in FIELDS.items() if data.get(key)]
await bot.send_message(OWNER_ID, f"{number} нөмірімен сөйлестім\n\n" + "\n".join(lines), parse_mode="HTML")
async with http.get(f"{API}/calls/{call['id']}/transcript") as r:
text = (await r.json()).get("text") if r.status == 200 else None
if text:
quote = html.escape(text[:3500])
await bot.send_message(OWNER_ID, f"<blockquote expandable>{quote}</blockquote>", parse_mode="HTML")
async with http.get(f"{API}/calls/recordings/{call['id']}") as r:
if r.status != 200:
return
wav = await r.read()
voice = await to_voice(wav)
if voice:
await bot.send_voice(OWNER_ID, BufferedInputFile(voice, "call.ogg"))
return
await bot.send_document(OWNER_ID, BufferedInputFile(wav, f"{number}.wav"))
async def hook(request: web.Request) -> web.Response:
if request.match_info["secret"] != HOOK_SECRET:
raise web.HTTPNotFound()
call = (await request.json()).get("call")
if not call or call["status"] == "in_queue" or call["id"] in seen:
return web.Response()
seen.add(call["id"])
asyncio.create_task(report(call))
return web.Response()
async def main():
global http
http = ClientSession(headers={"Authorization": f"Bearer {AUTOCALL_KEY}", "Accept": "application/json"})
app = web.Application()
app.router.add_post("/hook/{secret}", hook)
runner = web.AppRunner(app)
await runner.setup()
await web.TCPSite(runner, port=PORT).start()
try:
await dp.start_polling(bot)
finally:
await http.close()
if __name__ == "__main__":
asyncio.run(main())
Код туралы бірер ескерту.
- Бір қоңырауға бір сұраныс.
type: agentпараметрі барPOST /autocallsменің агентіммен бір нөмірден тұратын қоңырау науқанын жасайды.max_tries: 3жәнеtries_interval: 1515 минут сайын үш әрекет береді,record: trueәңгімені жазады, ал нәтижеcallback_urlмекенжайына келеді. - Аралық оқиғаларды өткізіп жіберемін. Әрекеттер арасында қоңырау
in_queueкүйімен келеді. Соңғы күй: сөйлессеsuccess, сөйлеспесеno_answerнемесеbusy. Тек соңғысына ғана жауап беремін. - Неге 15 секунд күтемін. AutoCall.kz жағында есеп өрістері мен сөйлесу мәтіні әңгімеден кейін тағы бірнеше секунд толығып жататынын байқадым. Сірә, суммаризатор мен бөлек LLM жұмыс істейтін болар. Сондықтан бот күтіп, бәрін жартылай емес, толық жіберу үшін қоңырауды
GET /autocalls/{id}арқылы қайта оқиды. - Вебхукке бірден жауап беремін. Вебхук бірден
200қайтарады. Бір қоңыраудың қайталанған хабарламаларын бот елемейді. - Файлдың орнына дауыстық хабарлама. Жазба WAV форматында келеді. ffmpeg орнатылған болса, бот оны OGG/Opus форматына айналдырады, сонда Telegram ішінде ол толқыны мен "Транскрипция" батырмасы бар кәдімгі дауыстық хабарлама болады. ffmpeg болмаса, файл ретінде жібереді.
4-қадам. Іске қосу
терминал
pip install aiogram aiohttp export TELEGRAM_TOKEN=123456:ABC export OWNER_ID=123456789 export AUTOCALL_KEY=сіздің_кілтіңіз export AGENT_ID=агент_id export PUBLIC_URL=https://бот-мекенжайы export HOOK_SECRET=кез-келген-ұзын-жол python bot.py
Ботқа жария https-мекенжай керек, AutoCall.kz қоңырау нәтижесін соған жібереді. Бұл үшін сервер міндетті емес: ботты тікелей ноутбуктан іске қосып, Cloudflare Tunnel арқылы сыртқа шығаруға болады. cloudflared tunnel --url http://localhost:8080 командасы мекенжай береді, соны PUBLIC_URL ішіне жазыңыз.
README мен баптау үлгісі бар толық код GitHub сайтында жатыр. Форк жасап, өзіңізге бейімдеңіз.
Бұл қанша тұрады
Тек әңгіме үшін секунд бойынша төлеймін: байланыс плюс ЖИ жұмысы.
| Тариф | Хатшымен әңгіменің минуты | Жазба | 1 жауапсыз әрекет | 3 жауапсыз әрекет |
|---|---|---|---|---|
| BRONZE | 148.8 ₸ | 5 ₸ | 0 ₸ | 0.7 ₸ |
| SILVER | 102.6 ₸ | 3 ₸ | 0 ₸ | 0.5 ₸ |
| GOLD | 79.8 ₸ | 0.5 ₸ | 0 ₸ | 0.3 ₸ |
Мұндай әдеттегі әңгіме бір минутқа сыяды. Өзекті бағалар мен шарттар тарифтер бетінде.
Балансқа 1200 ₸ салдым, бір аптада шамамен 190 ₸ жұмсалды.
Тағы не қосуға болады
- Басқа мақсаттар үшін (қандай да бір ақпаратты жеткізу немесе төлем туралы еске салу) басқа агент жасап, мақсатты боттың өзінде батырмалар арқылы таңдау.
- AutoCall.kz сервисінде кіріс қоңыраулар мүмкіндігінің пайда болуын күтіп жүрмін, сонда телефонымнан қоңырауларды AutoCall.kz сервисіне бағыттап, қорытындыны бірден Telegram ботынан ала аламын.
AutoCall.kz тарапынан: кіріс қоңыраулар қазірдің өзінде бар, басқа клиентіміз дәл солай істеді. Оқыңыз: ЖИ-ассистент қоңырауларға жауап беріп, Telegram арқылы жазады.
Бұл мақала телефонмен сөйлескенді және дауыстық хабарламаларды ұнатпайтын барлық адамға пайдалы болады деп үміттенемін ;)
Біздің сервисті пайдалану тәжірибеңіз туралы өз мақалаңызды ұсынсаңыз, AutoCall.kz командасы жеке кабинеттегі балансыңызға бонус беруге дайын.