Телоз REST API

Встройте голос во что угодно с помощью Телоз API

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

ОТДЫХ APIВебхукиСпецификация OpenAPISDK99,99 % времени безотказной работы
200 ОК — вызов в очереди
Спецификация OpenAPI 3.0 включена
телоз-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
Официальные языковые библиотеки
Узел, 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

Встроенный номеронабиратель

Добавьте полнофункциональный виджет «Звонок по клику» в любое веб-приложение с помощью нескольких строк JavaScript.

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

Интегрируйтесь на выбранном вами языке

Официальные SDK для Node.js, Python, PHP и Go — или позвоните ОТДЫХ 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

Краткие ответы.

Общие вопросы, прежде чем начать строить.

Зарегистрируйте учетную запись 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ПесочницаПоддержка разработчиков из США
REST API и веб-хуки для облачной голосовой связи, SMS и контакт-центра