เริ่มต้นใช้งาน

เริ่มต้นเร็ว: ส่ง SMS แรกของคุณผ่าน API

คู่มือนี้จะพาคุณจากไม่มีบัญชีไปสู่ข้อความที่ส่งถึงและเหตุการณ์การส่งที่ลงนาม ต้องการเทอร์มินัลและเวลา 5 นาที

1. สร้างบัญชีและเติมเงิน

เปิด Get API key บราวเซอร์ของคุณจะสร้างคีย์บัญชีที่ขึ้นต้นด้วย acct_ คัดลอกหรือบันทึกเป็นไฟล์ แล้วยืนยัน คีย์นั้นคือการเข้าสู่ระบบคอนโซลของคุณ เพิ่มเงินในหน้า Billing: การชำระเงินแบบโฮสต์จะเปิดในคอนโซล และยอดเงินจะแสดงที่ด้านบนของทุกหน้าในคอนโซล

2. สร้าง API key

ในหน้า API keys ตั้งชื่อคีย์ (เช่น production หรือ staging) และสร้างมัน คีย์จะขึ้นต้นด้วย bsa_live_ และแสดงเพียงครั้งเดียว: คัดลอกไปยังที่เก็บความลับหรือตัวแปรสภาพแวดล้อมของคุณ

export BULKSMSAPI_KEY="bsa_live_..."

3. ส่งข้อความ

ส่งข้อความไปยังโทรศัพท์ของคุณเอง หมายเลขจะเขียนในรูปแบบสากลพร้อมเครื่องหมายบวก

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'

คำตอบคือ 202 Accepted พร้อมกับ message id ราคา และสถานะ queued ภายในไม่กี่วินาที สถานะจะเปลี่ยนเป็น sent แล้ว delivered

4. อ่านสถานะ

curl https://bulksmsapi.cc/v1/messages/msg_8F3K2Q9TZ1MX \
  -H "Authorization: Bearer $BULKSMSAPI_KEY"

5. ส่งเป็นชุด

การส่งเป็นชุดจะส่งข้อความหนึ่งข้อความไปยังหมายเลขได้สูงสุด 10,000 หมายเลข หมายเลขที่ซ้ำกันและไม่สามารถอ่านได้จะถูกระบุใน set_aside และไม่ถูกคิดเงิน

curl https://bulksmsapi.cc/v1/batches \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: spring-sale-0412" \
  -d '{
    "name": "Spring sale",
    "text": "Spring sale at Northwind: 20% off until Sunday. Opt out: northwind.example/sms",
    "to": [
      "+14155550123",
      "+447400123456",
      "+4915123456789"
    ]
  }'

6. รับเหตุการณ์การส่ง

ในหน้า Webhooks เพิ่ม HTTPS endpoint แต่ละข้อความที่ส่งถึงหรือล้มเหลวจะเรียกมันด้วยเหตุการณ์ JSON ที่ลงนาม ตรวจสอบลายเซ็นด้วยโค้ดในหน้า Webhooks และตอบกลับด้วยสถานะ 2xx ใดๆ

ต่อไป: อ่าน Batches สำหรับข้อความส่วนตัวต่อหมายเลขและการกำหนดเวลา และ Errors สำหรับรหัสข้อผิดพลาดทุกประเภทและความหมายต่อยอดเงินของคุณ

เริ่มต้นเร็ว: ส่ง SMS แรกของคุณผ่าน API | BulkSMSAPI Docs