Teloz REST API

Вбудуйте голос у будь-що за допомогою Teloz API

Здійснюйте дзвінки, отримуйте веб-перехоплення, транслюйте стенограми та вбудовуйте повнофункціональний номеронабирач — і все це через чистий REST API із SDK для кожної основної мови.

REST APIВеб-хукиСпецифікація OpenAPISDK99,99% безвідмовної роботи
200 OK — виклик у черзі
Специфікація OpenAPI 3.0 включена
teloz-api.js
// Initiate an outbound call
 
const response = await teloz.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
webhook: "https://your-app.com/events"
});
 
// Response
// {
// sid: "CA3f9a…"
// status: "queued"
// duration: null
// }
За цифрами

Створений для виробництва з першого дня

Teloz API — це та сама інфраструктура, що живить тисячі США бізнес телефонні системи кожен день.

99.99%
Угода про безвідмовну роботу API
Надійність корпоративного рівня
< 100 мс
Середній час відповіді
У всіх регіонах США
50+
Кінцеві точки REST
Дзвінки, контакти, номери тощо
4 SDK
Офіційні мовні бібліотеки
Node, Python, PHP, Go
Кінцеві точки

Шість груп ресурсів, понад 50 кінцевих точок

Усе, що вам потрібно для створення функцій голосового зв’язку, SMS і контакт-центру у вашому продукті.

ПУБЛІКУВАТИ · ОТРИМАТИ · ВИДАЛИТИ

Дзвінки

Ініціювати вихідні дзвінки, отримувати записи дзвінків, отримувати доступ до записів і транслювати стенограми в реальному часі.

ПОСТ/v1/calls
ОТРИМАТИ/v1/calls/:sid
ОТРИМАТИ/v1/calls/:sid/recording
ВИДАЛИТИ/v1/calls/:sid
ОПУБЛІКУВАТИ · ОТРИМАТИ · РОЗМІСТИТИ · ВИДАЛИТИ

Контакти

Створення, читання, оновлення та видалення контактів. Синхронізуйте зі своєю CRM або створіть власну телефонну книгу.

ПОСТ/v1/contacts
ОТРИМАТИ/v1/contacts
ПОСТАВИТИ/v1/contacts/:id
ВИДАЛИТИ/v1/contacts/:id
ПУБЛІКУВАТИ · ОТРИМАТИ · ВИДАЛИТИ

Числа

Пошук доступних номерів, надання місцевих або безкоштовних номерів DID та керування конфігурацією номера.

ОТРИМАТИ/v1/numbers/available
ПОСТ/v1/numbers
ОТРИМАТИ/v1/numbers/:id
ВИДАЛИТИ/v1/numbers/:id
ПУБЛІКУВАТИ · ОТРИМАТИ · ВИДАЛИТИ

Веб-хуки

Зареєструйте кінцеві точки, щоб отримувати події в реальному часі для дзвінків, голосової пошти, розшифровок і SMS.

ПОСТ/v1/webhooks
ОТРИМАТИ/v1/webhooks
ПОСТАВИТИ/v1/webhooks/:id
ВИДАЛИТИ/v1/webhooks/:id
ОТРИМАТИ

Аналітика

Отримайте статистику обсягу, тривалості, розподілу та черги викликів для своїх інформаційних панелей і звітів.

ОТРИМАТИ/v1/analytics/calls
ОТРИМАТИ/v1/analytics/queues
ОТРИМАТИ/v1/analytics/agents
ОТРИМАТИ/v1/analytics/summary
JavaScript SDK

Вбудований номеронабирач

Розмістіть повнофункціональний віджет Click-to-Call у будь-яку веб-програму за допомогою кількох рядків JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Приклади коду

Інтегруйте мову на ваш вибір

Офіційні SDK для Node.js, Python, PHP і Go — або зателефонуйте REST API безпосередньо з будь-якої мови.

Ініціювати дзвінок
import Teloz from "@teloz/node";
 
const client = new Teloz(process.env.TELOZ_API_KEY);
 
const call = await client.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
transcribe: true,
webhook: "https://your-app.com/events",
});
 
console.log(call.sid); // CA3f9a7b…
Веб-хуки

Реагувати на кожну подію виклику в реального часу

Зареєструйте URL-адресу веб-хуку, і Teloz ПУСТИТЬ підписане корисне навантаження JSON на вашу кінцеву точку в момент виникнення події — опитування не потрібне. Поєднайте веб-хуки з нашими інтеграції для наскрізної автоматизації ваших робочих процесів.

Підпис HMAC-SHA256 на кожному корисному навантаженні
Автоматична повторна спроба з експоненційною відстрочкою
Журнали доставки та відтворення на інформаційній панелі
Можна фільтрувати за типом події для кожної кінцевої точки
ПодіяКатегорія
call.initiatedЗапускається, коли вихідний виклик стоїть у черзі
Дзвінки
call.ringingТелефон призначення дзвонить
Дзвінки
call.answeredВиклик прийнято — містить метадані абонента
Дзвінки
call.completedВиклик завершено — включає тривалість, розташування
Дзвінки
call.missedВхідний дзвінок залишився без відповіді
Дзвінки
recording.readyURL-адреса файлу запису доступна для завантаження
Запис
transcript.readyПовний текст стенограми та етикетки доповідачів додаються
ШІ
voicemail.newОтримано нове голосове повідомлення з URL-адресою аудіо
Голосова пошта
sms.inboundВхідні SMS отримані на наданий номер
SMS
API FAQ

Короткі відповіді.

Поширені запитання перед початком будівництва.

Зареєструйте обліковий запис Teloz і перейдіть до Налаштування → Розробник → Ключі API. Ви можете створити кілька ключів із обмеженими дозволами (лише читання, лише виклики, адміністратор) і відкликати їх у будь-який час.

так Повна специфікація OpenAPI 3.0 доступна на api.teloz.com/openapi.json і може бути імпортована безпосередньо в Postman, Insomnia або будь-який сумісний клієнт. Він синхронізується з кожним випуском.

API використовує автентифікацію маркера носія. Передайте свій ключ API у заголовку авторизації як «Носій YOUR_API_KEY». Для міжсерверного використання ми рекомендуємо ключі з областю дії; для вбудованих у браузер програм набору номера використовуйте короткочасні токени OAuth.

Так — обмеження за умовчанням становить 100 запитів на секунду на ключ API. Серії до 500 запитів/с дозволені протягом 10 секунд. Корпоративні плани можуть вимагати вищі ліміти. Заголовки обмеження швидкості (X-RateLimit-Remaining, X-RateLimit-Reset) повертаються під час кожної відповіді.

Кожен вебхук POST містить заголовок X-Teloz-Signature, що містить хеш HMAC-SHA256 необробленого тіла запиту, підписаного вашим секретом вебхуку. Обчисліть той самий хеш зі свого боку та порівняйте — відхиліть запити, які не збігаються.

так Використовуйте базову URL-адресу https://api.sandbox.teloz.com зі своїм тестовим ключем API. Дзвінки, здійснені в режимі пісочниці, ніколи не підключаються до телефонної мережі загального користування — вони імітують повний життєвий цикл події, включаючи записи та стенограми.

Почніть створення з Teloz API. Безкоштовна пісочниця включена.

Отримайте ключ API менш ніж за дві хвилини. Протестуйте нашу повнофункціональну пісочницю перед опублікуванням — кредитна картка не потрібна.

Повна специфікація OpenAPI4 офіційних SDKСередовище пісочниціПідтримка розробників США