Xây dựng tính năng gọi điện, nhắn tin và AI trên api Acepeak.
Điểm cuối REST, webhook thời gian thực và SDK hạng nhất. Xác thực api bằng mã thông báo truy cập mang theo và gửi yêu cầu đầu tiên của bạn sau chưa đầy năm phút.
# Place a call from a US number
curl -X POST https://endpoints.acepeak.com/v1/calls \
-H "Authorization: Bearer $ACEPEAK_TOKEN" \
-H "Content-Type: application/json" \
-d '{"from":"+18005551212",
"to":"+14155551212",
"answer_url":"https://your.app/answer"}'Bắt đầu nhanh.
- 01bước chân
Nhận mã thông báo truy cập
Đăng nhập vào bảng điều khiển Acepeak, mở Nhà phát triển → Mã thông báo và tạo mã thông báo mang mới. Mã thông báo được phân bổ theo phạm vi môi trường (hộp cát hoặc trực tiếp) và có thể xoay từ trang tổng quan bất kỳ lúc nào.
Lưu ý — giữ mã thông báo trực tiếp phía máy chủ. Bất cứ điều gì chạm vào trình duyệt sẽ đi qua phần phụ trợ của bạn.
- 02bước chân
Xác thực
Mọi yêu cầu đều sử dụng xác thực mã thông báo mang trong tiêu đề Ủy quyền.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03bước chân
Gửi yêu cầu đầu tiên của bạn
Thực hiện cuộc gọi, gửi SMS hoặc liệt kê các số của bạn — chọn bất kỳ số nào phù hợp với trường hợp sử dụng của bạn. Bạn sẽ thấy danh sách JSON chứa số điện thoại của mình. Từ đó, bạn có thể thực hiện cuộc gọi, gửi SMS, thiết lập webhook và bắt đầu xây dựng.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Mọi khả năng trong nền tảng được hiển thị thông qua REST.
Cuộc gọi thoại
Thực hiện cuộc gọi đi, kiểm soát cuộc gọi đến, chuyển cuộc gọi, hội nghị, ghi âm, phiên âm. Luồng URL trả lời có thể lập trình, thu thập DTMF trong cuộc gọi, phát trực tuyến theo thời gian thực.
/v1/calls/v1/conferences/v1/recordingsNhắn tin (SMS & MMS)
Gửi và nhận trên các số 10DLC, số điện thoại miễn phí và mã ngắn của Hoa Kỳ. Hai chiều, biên lai giao hàng, tuân thủ chọn không tham gia, các tin nhắn dài được nối với nhau.
/v1/messages/v1/messages/inboundSố điện thoại
Tìm kiếm, mua, chuyển và phát hành. DID địa phương của Hoa Kỳ, số điện thoại miễn phí và quốc tế trên 60 quốc gia.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersNgười dùng & Nhóm
Cung cấp người dùng, phân công vai trò, quản lý nhóm, định cấu hình SSO. SCIM 2.0 để quản lý vòng đời tự động với IdP của bạn.
/v1/users/v1/teams/v1/ssoWebhook
Gửi các sự kiện cuộc gọi, tin nhắn và ghi âm theo thời gian thực tới điểm cuối của bạn. HMAC-SHA256 đã được ký, thử lại với thời gian chờ theo cấp số nhân trong 24 giờ.
/v1/webhooks/v1/webhooks/{id}/eventsBề mặt AI
Kích hoạt Nhân viên lễ tân AI, lấy bản ghi, lấy điểm cảm tính cho mỗi cuộc gọi hoặc mỗi cuộc trò chuyện.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentCách để xác thực.
Xác thực mã thông báo truy cập
Được đề xuất cho các dịch vụ phụ trợ. Mã thông báo mang được gửi trong mọi yêu cầu. Mã thông báo được phân bổ theo phạm vi môi trường, có thể xoay từ trang tổng quan và được gắn với một vai trò cụ thể để có quyền truy cập ít đặc quyền nhất.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Dành cho các ứng dụng đối tác và tích hợp thị trường. Cấp mã ủy quyền với PKCE. Sử dụng điều này khi ứng dụng của bạn hoạt động thay mặt cho khách hàng chứ không phải tài khoản của chính bạn.
- Mã ủy quyền + PKCE
- Làm mới mã thông báo · Mặc định 30 ngày
- Phạm vi theo từng khách hàng
Có thể dự đoán được, được ghi lại, và không bao giờ im lặng.
Giới hạn tỷ lệ
Mặc định: 100 vòng/giây mỗi mã thông báo truy cập. Bùng nổ lên đến 200 vòng/giây đối với cửa sổ ngắn. Khi vượt quá, nền tảng sẽ trả về 429 với tiêu đề Thử lại sau.
sự bình thường
Các yêu cầu thay đổi hỗ trợ một Idempotency-Key tiêu đề. Hãy sử dụng nó cho các yêu cầu POST, PUT và DELETE để các lần thử lại không bị tính phí hai lần hoặc gửi hai lần.
Mã lỗi
400Yêu cầu xấuXác thực không thành công401trái phépMã thông báo truy cập không hợp lệ hoặc bị thiếu403CấmMã thông báo không có phạm vi404Không tìm thấyKhông tìm thấy tài nguyên409Xung độtIdempotency hoặc trạng thái không phù hợp429Tỷ lệ giới hạnLàm chậm lại - Cung cấp thử lại sau5xxPhía máy chủThử lại với thời gian chờ theo cấp số nhân
Sự kiện thời gian thực được gửi đến điểm cuối của bạn.
Đăng ký điểm cuối HTTPS để gọi, nhắn tin và ghi lại sự kiện. Webhooks được ký bằng HMAC-SHA256 — xác minh chữ ký trước khi xử lý. Việc giao hàng không thành công sẽ được thử lại với thời gian chờ theo cấp số nhân trong tối đa 24 giờ. Bạn có thể phát lại bất kỳ sự kiện nào từ bảng điều khiển.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Thư viện hạng nhất, ánh xạ nhân bản tới REST.
URL ổn định. Những nâng cấp có thể dự đoán được.
Các phiên bản giao diện được ghim vào URL (/v1/). Những thay đổi đột phá được đưa ra đằng sau một phiên bản chính mới. Các bổ sung không vi phạm sẽ xuất hiện trên cùng một phiên bản với ghi chú phát hành trong nhật ký thay đổi của nhà phát triển.
Các tính năng vẫn tồn tại trong 12 tháng sau khi có thông báo ngừng sử dụng. Chúng tôi gửi email cho mọi nhóm bằng mã thông báo truy cập đang hoạt động tại 90, 30 và 7 ngày trước thời điểm cắt - không có bất ngờ nào trong quá trình sản xuất.
Sẵn sàng để bắt đầu xây dựng?
câu hỏi, đã trả lời.
Đó là giao diện REST cộng với các webhooks đã ký để hiển thị tính năng gọi thoại, SMS/MMS, số điện thoại, người dùng và bề mặt AI. Xác thực bằng mã thông báo truy cập mang, đạt các điểm cuối được ghi lại và gửi đi sau vài phút.
Xây dựng trên api, vận chuyển cùng ngày.
Bao gồm hỗ trợ 24/7. Số được chuyển từ bất kỳ nhà cung cấp dịch vụ nào trên toàn thế giới.