คำถามที่พบบ่อย

คำถามและคำตอบเกี่ยวกับ Bulk SMS API

คำตอบ 39 ข้อเกี่ยวกับบัญชี, การส่ง, ราคา, รายงานการส่งและ API ตรวจสอบกับขีดจำกัดในโค้ด สำหรับ endpoint และฟิลด์ สามารถดูรายละเอียดได้ที่ เอกสารอ้างอิง API

บริการ

BulkSMSAPI คืออะไร

Bulk SMS API สำหรับนักพัฒนา: ส่งข้อความเดียวหรือ batch สูงสุด 10,000 หมายเลขต่อคำขอไปยัง 227 ประเทศผ่าน REST ติดตามทุกข้อความด้วย webhooks ที่มีการเซ็น และชำระเงินต่อข้อความจากยอดเงินเติมล่วงหน้า คอนโซลเว็บส่งแคมเปญจากรายการที่วางหรือไฟล์ CSV โดยไม่ต้องเขียนโค้ด

ใครใช้ Bulk SMS API

ทีมผลิตภัณฑ์และวิศวกรรมที่ส่งข้อความจากระบบของตัวเอง: รหัสเข้าสู่ระบบและสมัครสมาชิก, อัปเดตการสั่งซื้อและการจัดส่ง, การแจ้งเตือนนัดหมาย, การแจ้งเตือนการชำระเงิน, ประกาศบริการและแคมเปญการตลาด ใครก็ตามที่สามารถสร้างคำขอ HTTPS ได้สามารถใช้งานได้

ส่งไปยังประเทศใดได้บ้าง

227 ประเทศและดินแดน ระบุราคาไว้ในหน้า pricing และหน้า countries คำขอเดียวสามารถผสมประเทศได้: ทุกหมายเลขจะถูกคิดราคาตามประเทศที่มันอยู่

มีค่าธรรมเนียมรายเดือนหรือสัญญาหรือไม่

ไม่ คุณชำระเงินต่อ segment ของข้อความจากยอดเงินเติมล่วงหน้า และไม่มีค่าธรรมเนียมรายเดือน, ค่าตั้งต้นหรือปริมาณขั้นต่ำ ยอดเงินไม่มีวันหมดอายุ

มีทดลองใช้ฟรีหรือไม่

บัญชีเริ่มต้นด้วยยอดเงินเป็นศูนย์และการเติมเงินครั้งแรกจะเปิดใช้งานทุกอย่าง การเติมเงินครั้งแรกจะเพิ่มโบนัสสูงสุด 40% ดังนั้นข้อความแรกจึงมีต้นทุนที่ต่ำกว่า ราคาเป็นสาธารณะ และ endpoint estimate และคอนโซลจะแสดงต้นทุนที่แน่นอนก่อนที่จะส่งอะไรออกไป

บัญชีและ API keys

สร้างบัญชีอย่างไร

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

จะเกิดอะไรขึ้นหากฉันสูญเสีย account key

เราเก็บเฉพาะ hash ที่มีคีย์ของมัน ดังนั้นไม่มีใครสามารถแสดงมันได้อีกครั้ง รวมถึงทีมสนับสนุนของเรา เก็บไว้ใน password manager ในขณะที่คุณยังคงเข้าสู่ระบบอยู่ คอนโซลจะยังคงทำงาน และคุณสามารถติดต่อฝ่ายสนับสนุนจากคอนโซลได้

ฉันจะรับ API key ได้อย่างไร?

ที่หน้า API keys ในคอนโซล หลังจากเติมเงินครั้งแรกเสร็จสิ้น ให้ตั้งชื่อคีย์ สร้างคีย์และคัดลอกคีย์เพียงครั้งเดียว: คีย์จะขึ้นต้นด้วย bsa_live_ บัญชีหนึ่งสามารถมีคีย์ที่ใช้งานได้สูงสุด 10 คีย์ แต่ละคีย์จะมีชื่อและตัวนับ rate limit ของตัวเอง

ฉันสามารถใช้คีย์ต่างกันสำหรับ production และ staging ได้หรือไม่?

ได้ สร้างคีย์หนึ่งคีย์ต่อแอปหรือ environment และตั้งชื่อให้คีย์ แต่ละคีย์จะแสดงเวลาที่ถูกใช้ครั้งล่าสุด และการยกเลิกคีย์หนึ่งจะไม่ส่งผลต่อการทำงานของคีย์อื่น

ฉันสามารถสร้างบัญชีได้กี่บัญชี?

สูงสุด 3 บัญชีต่อที่อยู่เครือข่าย ทีมส่วนใหญ่ต้องการบัญชีเดียวที่มี API keys หลายคีย์

การส่งข้อความ

หนึ่งคำขอสามารถรับหมายเลขได้กี่หมายเลข?

POST /v1/batches สามารถรับหมายเลขได้สูงสุด 10,000 หมายเลขต่อคำขอ ไม่ว่าจะเป็นข้อความเดียวกันสำหรับทุกคนหรือข้อความเฉพาะสำหรับแต่ละหมายเลข คอนโซลสามารถรับได้ 50,000 หมายเลขต่อแคมเปญ รายชื่อที่ใหญ่กว่าจะถูกแบ่งออกเป็นหลายคำขอ

ข้อความถูกส่งเร็วแค่ไหน?

คิวทำงานทุกสองวินาทีและส่งข้อความได้สูงสุด 1,200 ข้อความต่อนาทีต่อบัญชีไปยังเครือข่าย ตามลำดับที่ข้อความถูกยอมรับ ข้อความเดียวมักจะถูกส่งออกไปภายในไม่กี่วินาทีหลังจากคำขอ

หมายเลขโทรศัพท์ควรอยู่ในรูปแบบใด?

รูปแบบสากล E.164: เครื่องหมายบวก รหัสประเทศและหมายเลขภายในประเทศ เช่น +14155550123 ช่องว่าง เครื่องหมายขีด วงเล็บและคำนำหน้า 00 จะถูกทำความสะอาดโดยอัตโนมัติ หมายเลขที่ซ้ำกันและหมายเลขที่ไม่สามารถอ่านได้จะถูกแยกออกและไม่ถูกคิดเงิน

ข้อความสามารถยาวได้แค่ไหน?

สูงสุด 10 segments: 1,530 ตัวอักษรใน GSM-7 หรือ 670 ใน Unicode หนึ่ง segment สามารถบรรจุได้ 160 ตัวอักษร GSM-7 หรือ 70 ตัวอักษร Unicode ข้อความที่ยาวกว่าจะถูกแบ่งออกเป็นส่วนๆ ละ 153 หรือ 67 ตัวอักษรและจะถูกเชื่อมต่ออีกครั้งบนโทรศัพท์

ทำไมข้อความของฉันใช้ segments มากกว่าที่ฉันคาดไว้?

ตัวอักษรหนึ่งตัวที่อยู่นอกชุดตัวอักษร GSM-7 เช่น เครื่องหมายคำพูดโค้ง อีโมจิหรือตัวอักษรเช่น á หรือ ç จะเปลี่ยนข้อความทั้งหมดเป็น Unicode ที่ 70 ตัวอักษรต่อ segment คอนโซล composer จะระบุตัวอักษรเหล่านั้น และ POST /v1/estimates จะส่งกลับการเข้ารหัสก่อนที่คุณจะส่ง

ฉันสามารถกำหนดเวลาส่งข้อความได้หรือไม่?

ได้ เพิ่ม send_at ในคำขอ API หรือเลือกเวลาในคอนโซล ตั้งแต่ 2 นาทีถึง 45 วันล่วงหน้า แบทช์ที่กำหนดเวลาสามารถยกเลิกได้จนกว่าจะเริ่มต้น และต้นทุนทั้งหมดจะถูกคืนกลับไปยังยอดเงิน

ผู้รับแต่ละคนสามารถได้รับข้อความที่แตกต่างกันได้หรือไม่?

ได้ ผ่าน API ส่งแบทช์ที่มีข้อความ หนึ่ง {to, text} ต่อผู้รับ ในคอนโซล ให้วางหรืออัปโหลดรายการที่มีคอลัมน์เพิ่มเติมและใช้ merge fields {{1}} ถึง {{9}} ในข้อความ

มีการเพิ่มข้อความปฏิเสธการรับข้อความในข้อความของฉันหรือไม่?

ตั้งค่าข้อความปฏิเสธการรับข้อความของคุณหนึ่งครั้งใน Settings เช่น ลิงก์หรือที่อยู่อีเมล และคอนโซลจะเพิ่มข้อความนั้นในข้อความแคมเปญเมื่อคุณติ๊กช่องทำเครื่องหมาย ผ่าน API คุณควบคุมข้อความทั้งหมด ดังนั้นให้เพิ่มข้อความนั้นเองในข้อความการตลาด หมายเลขในรายการ do-not-send ของคุณจะถูกข้ามโดยคอนโซลและ API และไม่ถูกคิดเงิน

ฉันสามารถส่งข้อความทดสอบก่อนได้หรือไม่?

ได้ คอนโซลมีตัวเลือกส่งทดสอบไปยังหมายเลขหนึ่งก่อนเริ่มแคมเปญ และผ่าน API คุณสามารถส่งข้อความเดียวไปยังโทรศัพท์ของคุณเองด้วย POST /v1/messages

ราคาและการชำระเงิน

SMS หนึ่งข้อความมีราคาเท่าไหร่?

ขึ้นอยู่กับประเทศของหมายเลข: แต่ละประเทศมีราคาต่อ segment ในดอลลาร์สหรัฐ เริ่มต้นที่ $0.00247 (บราซิล) หน้า pricing และ GET /v1/pricing จะแสดงรายการทุกประเทศ

ต้นทุนของแบทช์ถูกคำนวณอย่างไร?

สำหรับผู้รับแต่ละคน: ราคาต่อ segment ของประเทศนั้นคูณด้วย segments ของข้อความนั้น ผลรวมจะถูกหักจากยอดเงินเมื่อคำขอถูกยอมรับ และคำตอบจะแสดงต้นทุนนั้น

ต้องเติมเงินขั้นต่ำเท่าไหร่

$40 สามารถเติมเงินได้ตั้งแต่ $40 ถึง $5,000 การเติมเงินครั้งแรกจะได้รับโบนัสสูงสุด 40% ซึ่งจะแสดงจำนวนเงินก่อนชำระ

ชำระเงินอย่างไร

ในคอนโซล ส่วน Billing จะเปิดหน้าชำระเงินในหน้าต่างใหม่ คุณเลือกจำนวนและชำระด้วยคริปโตเคอร์เรนซี โดยหน้าชำระเงินจะแสดงจำนวนเงินและที่อยู่ที่แน่นอน หน้าชำระเงินจะแสดงขั้นตอนแต่ละขั้น

ข้อความที่ส่งไม่สำเร็จได้เงินคืนไหม

ใช่ เมื่อข้อความส่งไม่สำเร็จ จำนวนเงินจะถูกคืนเข้าบัญชีโดยอัตโนมัติในรายการคืนเงิน สำหรับชุดข้อความที่ถูกยกเลิกจะได้รับเงินคืนเต็มจำนวน

ถอนยอดเงินได้ไหม

ยอดเงินใช้สำหรับชำระค่าข้อความและจะคงอยู่ในบัญชีโดยไม่มีวันหมดอายุ เงินคืนจากข้อความที่ล้มเหลวหรือถูกยกเลิกจะกลับเข้าบัญชีด้วย

ราคาเปลี่ยนแปลงไหม

ราคาอาจเปลี่ยนแปลงเมื่อค่าใช้จ่ายเครือข่ายเปลี่ยนแปลง รายการราคาปัจจุบันจะมีวันที่กำกับ และ API จะคืนค่าวันที่พร้อมแต่ละราคา ส่วนข้อความที่รับแล้วจะคงราคาตามที่เรียกเก็บ

การส่งและรายงาน

ตรวจสอบการส่งข้อความได้อย่างไร

แต่ละข้อความจะเปลี่ยนสถานะจาก queued เป็น sent แล้วเป็น delivered หรือ failed เพิ่ม URL webhook ในคอนโซลเพื่อรับเหตุการณ์ที่มีลายเซ็นสำหรับแต่ละสถานะสุดท้าย หรืออ่านผ่าน GET /v1/messages/{id} และ GET /v1/batches/{id}

webhook ลงลายเซ็นอย่างไร

ในรูปแบบ Standard Webhooks: มีส่วนหัว webhook-id, webhook-timestamp และ webhook-signature ซึ่งลายเซ็นคือ HMAC-SHA256 ของ id, timestamp และ raw body ด้วยรหัสลับ whsec_ เอกสารมีโค้ดตรวจสอบสำหรับ Node.js, Python, PHP และ Go

ถ้า endpoint webhook ล่มจะทำอย่างไร

แต่ละเหตุการณ์จะมีการลองส่ง 10 ครั้งภายใน 24 ชั่วโมง และแต่ละครั้งจะแสดงในคอนโซลพร้อมสถานะ HTTP คุณยังสามารถตรวจสอบ endpoint ข้อความได้ตลอดเวลา

ทำไมข้อความถึงส่งไม่สำเร็จ

มือถืออาจถูกปิดเป็นเวลานานเกินไป, หมายเลขอาจไม่ให้บริการอีกต่อไป, หรือเครือข่ายอาจปฏิเสธข้อความ สถานะล้มเหลวจะมีรหัสข้อผิดพลาด และราคาจะถูกคืนเงิน

บันทึกข้อความเก็บไว้นานแค่ไหน

ชุดข้อความ, ข้อความและบันทึกยอดเงินจะอยู่ในบัญชีและ API ของคุณ บันทึกคำขอจะเก็บ API call ล่าสุด 500 ครั้ง และบันทึก webhook จะเก็บการส่งล่าสุด 500 ครั้ง

สำหรับนักพัฒนา

มี SDK ไหม

API นี้เป็น JSON ธรรมดาผ่าน HTTPS ดังนั้นไลบรารีมาตรฐานของทุกภาษาก็เพียงพอ เอกสารมีตัวอย่างครบถ้วนใน curl, Node.js, Python, PHP และ Go และ OpenAPI spec ที่ /openapi.json สามารถสร้างไคลเอนต์แบบระบุประเภทในภาษาส่วนใหญ่

มีขีดจำกัดอัตราเท่าไหร่

600 คำขอต่อนาทีต่อ API key แต่ละคำตอบจะมีส่วนหัว X-RateLimit-Limit, X-RateLimit-Remaining และ X-RateLimit-Reset และคำตอบ 429 จะมี Retry-After

ลองส่งใหม่อย่างปลอดภัยหลัง timeout อย่างไร

ส่งคำขอ POST พร้อมส่วนหัว Idempotency-Key และลองใหม่ด้วยคีย์เดิม ภายใน 24 ชั่วโมง คีย์และเนื้อหาเดิมจะได้รับคำตอบแรกแทนการส่งซ้ำ

ตรวจสอบราคาโดยไม่มี API key ได้ไหม

ได้ GET /v1/pricing และ GET /v1/pricing/{country} เป็นสาธารณะ ดังนั้นหน้าชำระเงินหรือแดชบอร์ดสามารถแสดงราคาแบบเรียลไทม์ได้

ฉันจะดูสิ่งที่โค้ดของฉันส่งไปได้ที่ไหน

ในคอนโซลจะมีบันทึกคำขอที่แสดงเมธอด, path, สถานะและเวลาของการเรียก API ครั้งล่าสุด 500 ครั้ง พร้อมกับข้อมูล batch, ข้อความและบันทึก webhook

คอนโซล

ฉันสามารถส่งข้อความโดยไม่ต้องเขียนโค้ดได้ไหม

ได้ ในคอนโซล คุณสามารถวางหมายเลขหรืออัปโหลดไฟล์ CSV สูงสุด 50,000 แถว เขียนข้อความด้วย merge fields ตรวจสอบตัวอย่างสำหรับผู้รับแต่ละรายและค่าใช้จ่ายต่อประเทศ แล้วส่งได้ทันทีหรือตั้งเวลาส่ง

คอนโซลแสดงอะไรบ้าง

ยอดเงิน, batch ล่าสุดพร้อมจำนวนแบบเรียลไทม์, แต่ละ batch พร้อมข้อความและสถานะ, การเติมเงินและบัญชีแยกประเภท, คีย์ API, การตั้งค่าและการส่ง webhook, บันทึกคำขอ, รายการราคา, ตั๋วสนับสนุนและการตั้งค่า

ฉันจะติดต่อฝ่ายสนับสนุนได้อย่างไร

จากหน้า Support ในคอนโซล สามารถสอบถามเกี่ยวกับการชำระเงินได้ตั้งแต่วันแรก ส่วนหัวข้ออื่นๆจะเปิดให้ใช้งานได้หลังจากเติมเงินครั้งแรกเรียบร้อยแล้ว

ยังมีคำถามอยู่ใช่ไหม

บัญชีที่ลงชื่อเข้าใช้สามารถเปิดตั๋วสนับสนุนจากคอนโซลได้ สามารถสอบถามเกี่ยวกับการชำระเงินได้ตั้งแต่วันแรก

Bulk SMS API FAQ: คีย์, การส่ง, ราคา, Webhooks | BulkSMSAPI