导入
可编程短信
学习如何使用 Twilio 的可编程消息服务发送 outbound SMS 消息并响应传入的消息。
...
代码示例
1https://api.twilio.com/2010-04-01/Accounts/{{ACCOUNT_SID}}/Messages.json
| 参数名 | 类型 | 分类 | 说明 |
|---|---|---|---|
| From | 字符串 | 必填 | 用于发送消息的 Twilio 电话号码。 |
| Body | 字符串 | 必填 | 要发送的消息内容。 |
| To | 字符串 | 必填 | 要发送消息的目标电话号码,格式为“%2B [国家代码] [电话号码]”。其中“%2B”是加号(+)的编码。 |
| StatusCallback | 字符串 | 选填 | 消息状态更新时,希望接收 POST 请求的 URL 地址。 |
| ApplicationSid | 字符串 | 选填 | 消息状态更新时,希望接收数据的应用程序 ID。 |
| MaxPrice | 浮点数 | 选填 | 消息送达所愿意支付的最高价格(单位:美元)。 |
| ProvideFeedback | 布尔值 | 选填 | 若设为 true,则在消息成功送达时会收到通知。 |
| Attempt | 整数 | 选填 | 尝试发送消息的总次数。 |
| ValidityPeriod | 整数 | 选填 | 消息在出站队列中可保留的最长时间(单位:秒)。超过该时间后消息将被丢弃。最小值为 1,最大值为 14400。 |
| ScheduleType | 枚举 | 选填 | 指定是否在特定时间发送消息。可接受的值为 fixed(固定时间)。 |
| SendAt | 字符串 | 选填 | 消息发送的时间,需采用 ISO 8601 格式(YYYY-MM-DD HH:MM:SS)。 |
1import fetch from "node-fetch"; 2 3// 定义请求头参数 4const header = { 5 'Authorization': 'Basic ' + Buffer.from('{{ACCOUNT_SID}}' + ':' + '{{AUTH_TOKEN}}').toString('base64'), 6 'Content-Type': 'application/x-www-form-urlencoded', 7}; 8 9// 定义请求地址 10const url = new URL('https://api.twilio.com/2010-04-01/Accounts/{{ACCOUNT_SID}}/Messages.json'); 11 12// 定义请求体参数 13const body = 'Body=Hi there&From={{TWILIO_PHONE_NUMBER}}&To={{YOUR_PHONE_NUMBER}}'; 14 15// 设置 API 请求选项 16const options = { 17 method: 'POST', 18 headers: header, 19 body: body 20}; 21 22async function SMSEndpoint() { 23 try { 24 const response = await fetch(url, options); 25 // 自定义函数用于打印 API 响应结果 26 printResponse(response); 27 } catch (error) { 28 console.log(`Error: ${error}`); 29 } 30} 31 32SMSEndpoint();
| 参数名 | 类型 | 说明 |
|---|---|---|
| body | 字符串 | 发送的消息内容。 |
| num_segments | 字符串 | 如果消息内容过长无法单条发送,会被拆分为多个段落,此字段表示分段数量。 |
| direction | 枚举 | 消息的方向。可能值包括:inbound(接收)、outbound-api(通过 API 发送)、outbound-call(通话中发起)、outbound-reply(作为回复发送)。 |
| from | 字符串 | 消息发送方的电话号码。 |
| date_updated | 字符串 | 消息最后更新的时间。 |
| price | 字符串 | 发送该消息所收取的费用。 |
| error_message | 字符串 | 若消息未成功发送,此字段包含错误描述信息。 |
| uri | 字符串 | 消息的相对 Twilio 资源路径。 |
| account_sid | 字符串 | 发送该消息的账户 SID。 |
| num_media | 字符串 | 附加到消息中的媒体文件数量。最多支持 10 个文件。 |
| to | 字符串 | 消息接收方的电话号码。 |
| date_created | 字符串 | 消息创建的时间。 |
| status | 枚举 | 外部消息的状态。 |
| sid | 字符串 | 与消息关联的唯一标识 ID。 |
| date_sent | 字符串 | 消息被接收方号码接收的时间。 |
| message_service_sid | 字符串 | 使用的消息服务 SID。若未使用服务则为 null。 |
| error_code | 整数 | 消息未送达时的错误代码。 |
| price_unit | 字符串 | 价格对应的货币单位。 |
| api_version | 字符串 | 使用的 Twilio API 版本。 |
代码示例
1https://demo.twilio.com/welcome/sms/reply/
...
为入站消息配置 Webhook 地址
No configuration found for ID: 0070a33dc6aa7a4c61c7a9d03ca4f16aba94d811347b2e9668a1b698773a5a0b
No configuration found for ID: e910066f0e6d66a673940f81cd3f74e43dc148349fed01f7b1a1c843dc1f675c