API REST của Teloz

Xây dựng giọng nói thành mọi thứ với API Teloz

Bắt đầu cuộc gọi, nhận webhook, ghi trực tiếp và nhúng trình quay số đầy đủ tính năng — tất cả đều thông qua API REST sạch có SDK cho mọi ngôn ngữ chính.

API RESTWebhookThông số OpenAPISDKThời gian hoạt động 99,99%
200 OK — cuộc gọi xếp hàng
Bao gồm thông số 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
// }
Bằng những con số

Được xây dựng để sản xuất ngay từ ngày đầu tiên

API Teloz là cơ sở hạ tầng tương tự cung cấp năng lượng cho hàng ngàn người Mỹ hệ thống điện thoại doanh nghiệp mỗi ngày.

99.99%
SLA thời gian hoạt động của API
Độ tin cậy cấp doanh nghiệp
< 100 mili giây
Thời gian phản hồi trung bình
Trên khắp các vùng của Hoa Kỳ
50+
Điểm cuối REST
Cuộc gọi, danh bạ, số điện thoại và hơn thế nữa
4 SDK
Thư viện ngôn ngữ chính thức
Nút, Python, PHP, Đi
Điểm cuối

Sáu nhóm tài nguyên, hơn 50 điểm cuối

Mọi thứ bạn cần để tích hợp các tính năng thoại, SMS và trung tâm liên lạc vào sản phẩm của mình.

ĐĂNG · NHẬN · XÓA

Cuộc gọi

Bắt đầu cuộc gọi đi, truy xuất bản ghi cuộc gọi, truy cập bản ghi và truyền phát bản ghi thời gian thực.

BƯU KIỆN/v1/calls
LẤY/v1/calls/:sid
LẤY/v1/calls/:sid/recording
XÓA BỎ/v1/calls/:sid
ĐĂNG · NHẬN · ĐẶT · XÓA

Danh bạ

Tạo, đọc, cập nhật và xóa danh bạ. Đồng bộ hóa với CRM hoặc tạo danh bạ của riêng bạn.

BƯU KIỆN/v1/contacts
LẤY/v1/contacts
ĐẶT/v1/contacts/:id
XÓA BỎ/v1/contacts/:id
ĐĂNG · NHẬN · XÓA

số

Tìm kiếm các số có sẵn, cung cấp DID địa phương hoặc miễn phí và quản lý cấu hình số.

LẤY/v1/numbers/available
BƯU KIỆN/v1/numbers
LẤY/v1/numbers/:id
XÓA BỎ/v1/numbers/:id
ĐĂNG · NHẬN · XÓA

Webhook

Đăng ký điểm cuối để nhận các sự kiện theo thời gian thực cho cuộc gọi, thư thoại, bản ghi và SMS.

BƯU KIỆN/v1/webhooks
LẤY/v1/webhooks
ĐẶT/v1/webhooks/:id
XÓA BỎ/v1/webhooks/:id
LẤY

Phân tích

Kéo số liệu thống kê về số lượng cuộc gọi, thời lượng, cách bố trí và hàng đợi cho trang tổng quan và báo cáo của bạn.

LẤY/v1/analytics/calls
LẤY/v1/analytics/queues
LẤY/v1/analytics/agents
LẤY/v1/analytics/summary
SDK JavaScript

Trình quay số nhúng

Thả tiện ích nhấp để gọi đầy đủ tính năng vào bất kỳ ứng dụng web nào có một vài dòng JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Ví dụ về mã

Tích hợp bằng ngôn ngữ bạn chọn

SDK chính thức cho Node.js, Python, PHP và Go — hoặc gọi API REST trực tiếp từ bất kỳ ngôn ngữ nào.

Bắt đầu cuộc gọi
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…
Webhook

Phản ứng với mọi sự kiện cuộc gọi trong thời gian thực

Đăng ký URL webhook và Teloz sẽ ĐĂNG tải trọng JSON đã ký tới điểm cuối của bạn ngay khi sự kiện xảy ra — không cần bỏ phiếu. Kết hợp webhooks với của chúng tôi tích hợp để tự động hóa quy trình công việc của bạn từ đầu đến cuối.

Chữ ký HMAC-SHA256 trên mỗi tải trọng
Tự động thử lại với thời gian chờ theo cấp số nhân
Nhật ký phân phối và phát lại trong bảng điều khiển
Có thể lọc theo loại sự kiện cho mỗi điểm cuối
Sự kiệnLoại
call.initiatedĐược kích hoạt khi một cuộc gọi đi được xếp hàng đợi
Cuộc gọi
call.ringingĐiện thoại đích đang đổ chuông
Cuộc gọi
call.answeredCuộc gọi đã được nhận - bao gồm siêu dữ liệu người gọi
Cuộc gọi
call.completedCuộc gọi đã kết thúc - bao gồm thời lượng, cách bố trí
Cuộc gọi
call.missedCuộc gọi đến không được trả lời
Cuộc gọi
recording.readyURL tệp ghi có sẵn để tải xuống
Ghi âm
transcript.readyĐính kèm nhãn văn bản và người phát biểu đầy đủ
trí tuệ nhân tạo
voicemail.newĐã nhận được thư thoại mới có URL âm thanh
Thư thoại
sms.inboundĐã nhận được SMS gửi đến trên số được cung cấp
tin nhắn SMS
Câu hỏi thường gặp về API

Những câu trả lời ngắn gọn.

Những câu hỏi thường gặp trước khi bạn bắt đầu xây dựng.

Đăng ký tài khoản Teloz và điều hướng đến Cài đặt → Nhà phát triển → Khóa API. Bạn có thể tạo nhiều khóa với các quyền trong phạm vi (chỉ đọc, chỉ cuộc gọi, quản trị viên) và thu hồi chúng bất kỳ lúc nào.

Đúng. Thông số OpenAPI 3.0 đầy đủ có sẵn tại api.teloz.com/openapi.json và có thể được nhập trực tiếp vào Postman, Insomnia hoặc bất kỳ ứng dụng khách tương thích nào. Nó được giữ đồng bộ với mọi bản phát hành.

API sử dụng xác thực mã thông báo Bearer. Chuyển khóa API của bạn vào tiêu đề Cấp phép dưới dạng 'Bearer YOUR_API_KEY'. Để sử dụng từ máy chủ đến máy chủ, chúng tôi khuyên dùng các khóa có phạm vi; đối với trình quay số được nhúng trong trình duyệt, hãy sử dụng mã thông báo có thời gian tồn tại ngắn của OAuth.

Có — giới hạn mặc định là 100 yêu cầu mỗi giây cho mỗi khóa API. Cho phép bùng nổ lên tới 500 req/s trong tối đa 10 giây. Kế hoạch doanh nghiệp có thể yêu cầu giới hạn cao hơn. Các tiêu đề giới hạn tốc độ (X-RateLimit-Remaining, X-RateLimit-Reset) được trả về trên mỗi phản hồi.

Mỗi webhook POST bao gồm tiêu đề X-Teloz-Signature chứa hàm băm HMAC-SHA256 của nội dung yêu cầu thô được ký bằng bí mật webhook của bạn. Tính toán cùng một hàm băm từ phía bạn và so sánh — từ chối các yêu cầu không khớp.

Đúng. Sử dụng URL cơ sở https://api.sandbox.teloz.com với khóa API thử nghiệm của bạn. Các cuộc gọi được thực hiện ở chế độ hộp cát không bao giờ được kết nối với PSTN — chúng mô phỏng toàn bộ vòng đời sự kiện bao gồm bản ghi và bản ghi.

Bắt đầu xây dựng với API Teloz. Bao gồm hộp cát miễn phí.

Nhận khóa API của bạn trong vòng chưa đầy hai phút. Thử nghiệm với hộp cát đầy đủ tính năng của chúng tôi trước khi đi vào hoạt động — không cần thẻ tín dụng.

Thông số OpenAPI đầy đủ4 SDK chính thứcMôi trường hộp cátHỗ trợ nhà phát triển Hoa Kỳ