Tích hợp SMS vào ứng dụng của bạn trong vài phút

API SMS mạnh mẽ, có khả năng mở rộng và dễ sử dụng cho các nhà phát triển.

curl -X POST https://api.send-text.com/v1/messages 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d "data"

Hướng dẫn bắt đầu nhanh

const sendText = require('send-text');
const client = new sendText('YOUR_API_KEY');

// Gửi tin nhắn
await client.messages.create();

Tính năng API

📤

Gửi SMS

Gửi tin nhắn SMS đến bất kỳ số điện thoại nào trên toàn thế giới với API đơn giản của chúng tôi.

📥

Nhận SMS

Thiết lập webhooks để nhận tin nhắn SMS đến trong thời gian thực.

📊

Báo cáo gửi tin

Theo dõi trạng thái gửi tin nhắn với báo cáo gửi tin chi tiết.

🔄

Nhắn tin hai chiều

Cho phép trò chuyện hai chiều với khách hàng của bạn.

🛡️

Ẩn số điện thoại

Bảo vệ quyền riêng tư của người dùng bằng cách ẩn số điện thoại.

🌐

Phạm vi toàn cầu

Gửi tin nhắn đến hơn 200 quốc gia trên toàn thế giới.

Trường hợp sử dụng

🔐

Xác thực hai yếu tố

Bảo mật ứng dụng của bạn với xác thực hai yếu tố qua SMS.

📣

Chiến dịch tiếp thị

Tiếp cận khách hàng với các chiến dịch tiếp thị SMS có mục tiêu.

📦

Thông báo đơn hàng

Cập nhật cho khách hàng về trạng thái đơn hàng của họ.

🏥

Nhắc nhở lịch hẹn

Giảm tỷ lệ vắng mặt với nhắc nhở SMS tự động.

Tài liệu tham khảo API

ENDPOINT

/v1/messages

DESCRIPTION

Gửi tin nhắn SMS đến một số điện thoại.

PARAMETERS

Name	Type	Required	Description
to	string	Yes	Số điện thoại người nhận ở định dạng E.164
message	string	Yes	Nội dung tin nhắn
from	string	No	ID người gửi hoặc số điện thoại

EXAMPLE

Request

curl -X POST https://api.send-text.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "message": "Xin chào từ send-text.com!"
  }'

Response

{
  "id": "msg_1234567890",
  "status": "queued",
  "to": "+1234567890",
  "message": "Xin chào từ send-text.com!"
}

SDK và Thư viện

Node.js

v2.1.0

SDK Node.js chính thức để tích hợp liền mạch với các ứng dụng JavaScript và TypeScript.

npm install @send-text/sdk

View Documentation

Python

v1.8.2

SDK Python để tích hợp dễ dàng với các ứng dụng Django, Flask và FastAPI.

pip install sendtext

View Documentation

PHP

v3.0.1

SDK PHP hỗ trợ các ứng dụng Laravel, Symfony và PHP thuần.

composer require sendtext/sdk

View Documentation

Java

v2.4.0

SDK Java với hỗ trợ Spring Boot và tài liệu toàn diện.

implementation 'com.sendtext:sdk:2.4.0'

View Documentation

Ruby

v1.5.0

SDK Ruby cho ứng dụng Rails và Sinatra với tích hợp đơn giản.

gem install sendtext

View Documentation

Go

v1.2.1

SDK Go với giới hạn tốc độ tích hợp và pooling kết nối.

go get github.com/sendtext/sdk

View Documentation

C#

v2.2.0

SDK .NET hỗ trợ các ứng dụng .NET Core và .NET Framework.

Install-Package SendText.SDK

View Documentation

Công cụ kiểm thử

Kiểm thử tích hợp SMS của bạn trong thời gian thực với sân chơi API tương tác của chúng tôi.

API Key

Parameters

message

from

Webhooks và Callbacks

Nhận cập nhật thời gian thực về trạng thái gửi tin nhắn và tin nhắn đến thông qua webhooks.

Cấu hình URL Webhook

Thiết lập endpoint webhook của bạn trong bảng điều khiển để nhận callbacks.

https://your-app.com/webhooks/sms

Xác minh chữ ký

Xác thực tính xác thực của webhook bằng chữ ký được cung cấp.

const isValid = verifyWebhookSignature(
  request.headers['x-send-text-signature'],
  webhookSecret,
  request.rawBody
);

Xử lý sự kiện

Xử lý các sự kiện webhook khác nhau trong ứng dụng của bạn.

app.post('/webhooks/sms', (req, res) => {
  const event = req.body;
  
  switch(event.type) {
    case 'message.delivered':
      handleDelivered(event);
      break;
    case 'message.failed':
      handleFailed(event);
      break;
    case 'message.received':
      handleInbound(event);
      break;
  }

  res.sendStatus(200);
});

Event Types

message.delivered

Kích hoạt khi một tin nhắn được gửi thành công

message.failed

Kích hoạt khi việc gửi tin nhắn thất bại

message.received

Kích hoạt khi nhận được tin nhắn đến

Ready to Get Started?

Set up webhooks in your dashboard to start receiving real-time updates.

Configure Webhooks

Giới hạn tốc độ và Mã lỗi

Rate Limits

Endpoint	Limit	Note
Gửi SMS	100 yêu cầu mỗi phút	Giới hạn cao hơn có sẵn trong gói doanh nghiệp
Gửi hàng loạt	1000 tin nhắn mỗi yêu cầu	Tối đa 10 yêu cầu mỗi phút
Kiểm tra trạng thái	1000 yêu cầu mỗi phút	Được lưu trong bộ nhớ đệm trong 60 giây

Error Codes

400Yêu cầu không hợp lệ

Yêu cầu không hợp lệ hoặc thiếu các tham số bắt buộc.

Solution: Kiểm tra các tham số yêu cầu và đảm bảo chúng khớp với đặc tả API.

401Không được phép

Khóa API không hợp lệ hoặc bị thiếu.

Solution: Đảm bảo bạn đang sử dụng khóa API hợp lệ và nó được bao gồm trong tiêu đề Authorization.

429Quá nhiều yêu cầu

Vượt quá giới hạn tốc độ.

Solution: Thực hiện backoff theo cấp số nhân và giữ trong giới hạn tốc độ.

500Lỗi máy chủ nội bộ

Đã xảy ra lỗi trên máy chủ của chúng tôi.

Solution: Liên hệ với bộ phận hỗ trợ nếu vấn đề vẫn tiếp diễn.