Документация

Всё, что нужно для запуска первого звонка за 5 минут.

Быстрый старт

Установите SDK, получите API-ключ в личном кабинете и сделайте первый звонок.

pip install tehnozvon

from tehnozvon import Client

tz = Client(api_key="tz_live_xxx")

call = tz.voice.create(
    to="+79991234567",
    from_="+74951234567",
    url="https://myapp.ru/handler.xml"
)
print(call.sid)  # CAxxxxx

REST API

Базовый URL: https://api.tehnozvon.ru/v1. Аутентификация — Bearer токен.

Метод	Endpoint	Описание
POST	/calls	Создать звонок
POST	/messages	Отправить SMS
GET	/calls/{sid}	Информация о звонке
POST	/calls/{sid}/hangup	Завершить звонок
POST	/ai_agents	Создать ИИ-агента
GET	/recordings	Список записей

curl -X POST https://api.tehnozvon.ru/v1/calls \
  -H "Authorization: Bearer tz_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"to":"+79991234567","from":"+74951234567","url":"https://myapp.ru/h.xml"}'

Вебхуки

Технозвон вызывает ваш URL на события. Подпись в заголовке X-TZ-Signature.

call.initiated

Звонок начат

call.answered

Абонент ответил

call.completed

Звонок завершён

message.delivered

SMS доставлена

SDK Python

pip install tehnozvon

from tehnozvon import Client
tz = Client(api_key="tz_live_xxx")

# Отправить SMS
msg = tz.messages.create(
    to="+79991234567",
    body="Ваш код: 1234"
)

# Получить запись звонка
recording = tz.recordings("RExxxxx").fetch()
recording.save("call.mp3")

SDK JavaScript

npm install @tehnozvon/sdk

import { Tehnozvon } from '@tehnozvon/sdk';

const tz = new Tehnozvon('tz_live_xxx');

const call = await tz.voice.create({
  to: '+79991234567',
  from: '+74951234567',
  url: 'https://myapp.ru/h.xml'
});

console.log(call.sid);

ИИ-агенты

Создайте голосового ИИ-агента с моделью GLM-5, YandexGPT или GigaChat.

agent = tz.ai_agents.create(
    name="Кассир",
    model="glm-5",
    voice="yandex_alena",
    system_prompt="Ты — кассир пиццерии. Принимай заказы.",
    tools=["place_order", "check_status"]
)

# Запустить на номере
tz.numbers("+74951234567").update(agent=agent.id)

Совет: Используйте listen_ai(max_turns=5) для лимита диалога, чтобы агент не зацикливался.

152-ФЗ и персональные данные

Технозвон зарегистрирован в реестре операторов ПДн (№ 2-22-xxxx). Все данные хранятся на территории РФ.

Журналирование всех операций с ПДн — 5 лет
Шифрование at-rest (AES-256) и in-transit (TLS 1.3)
Договор о обработке ПДн с каждым клиентом
Возможность полного удаления данных по запросу
Аудит ИБ — ежегодный, отчёт по запросу

SIP-транки

Подключите свою АТС к Технозвон через SIP-транк. Поддержка G.711 (a/μ-law), G.729, Opus.

; /etc/asterisk/sip.conf
[tehnozvon]
type=peer
host=sip.tehnozvon.ru
username=ACCT_xxx
secret=SECRET
fromuser=ACCT_xxx
context=incoming
disallow=all
allow=alaw,ulaw,opus
insecure=invite,port
qualify=yes

Нужна помощь?

Загляните в сообщество Telegram или напишите в поддержку.

Telegram Поддержка