你笑了

你的笑，是星星跳跃浪花的笑

0%

twilio发送短信

发表于 分类于

账户配置

  1. 需要购买一个具有SMS功能的twilio电话号码用于发短信

    需要在 develop/phone-numbers/regulatory-compliance/bundles 里面提供证明，然后审核，需要2个工作日

  2. 设置允许给哪些区域的手机号发送

    https://www.twilio.com/console/sms/settings/geo-permissions

  1. 设置或取消入站短信、语音的webhook

    路径：Develop->Phone Numbers->Active numbers->Voice/Messaging->A CALL/MESSAGE COMES IN

    将Webhook 后面的 url 清空

    刚购买的号码有个默认配置，当用户给twilio发短信或语音时，twilio 会回复（收费）。如果不用该功能就取消

    • 日志中：direction 是 incoming 及 reply 的记录分别是用户回复及twilio回复的短信

    • 默认 Messaging Webhook https://demo.twilio.com/welcome/sms/reply/

      1
      2
      3
      <Response>
      <Message>Thanks for the message. Configure your number's SMS URL to change this message.Reply HELP for help.Reply STOP to unsubscribe.Msg&Data rates may apply.</Message>
      </Response>

    • 默认 Voice Webhook https://demo.twilio.com/welcome/voice/

      1
      2
      3
      4
      5
      <Response>
      <Say voice="alice">Thanks for the call. Configure your number's voice U R L to change this message.</Say>
      <Pause length="1"/>
      <Say voice="alice">Let us know if we can help you in any way during your development.</Say>
      </Response>

开发

Node.js Quickstart

发送出站(outbound)短信

  • 创建 twilio 客户端，需要 ACCOUNT_SID和AUTH_TOKEN

  • from 表示 twilio 用哪个号码发短信（测试号码或购买）

    格式为 [+][country code][phone number including area code]

  • to 表示twilio 给哪个号码发短信（顾客的手机号）

接收并回复入站(inbound)短信

  • twilio number 收到短信后，会向指定的URL发送一个请求（webhook）并期望获得一个XML格式的响应告诉twilio如何回复收到的短信

API

Message Resource

Create

发送短信

ERROR

https://www.twilio.com/docs/api/errors

logic

计算短信条数

1
2
3
4
5
6
7
// https://www.twilio.com/docs/glossary/what-sms-character-limit#sms-message-length-and-character-encoding
function calcTwilioSMSCount (text: string) {
    const gsmRegexp = new RegExp("^[A-Za-z0-9 \\r\\n@£$¥èéùìòÇØøÅå\u0394_\u03A6\u0393\u039B\u03A9\u03A0\u03A8\u03A3\u0398\u039EÆæßÉ!\"#$%&'()*+,\\-./:;<=>?¡ÄÖÑܧ¿äöñüà^{}\\\\\\[~\\]|\u20AC]*$")
    return gsmRegexp.test(text)
        ? (text.length > 160 ? Math.ceil(text.length / 153) : 1)
    : (text.length > 70 ? Math.ceil(text.length / 67) : 1) // 包含非GSM字符
}

客户端配置

1
2
3
4
5
6
7
8
9
10
11
const twilioSMSConfig = {
    accountSid: process.env.TWILIO_ACCOUNT_SID,
    authToken: process.env.TWILIO_AUTH_TOKEN,
    options: {
        edge: process.env.TWILIO_EDGE || '', // default: ashburn  https://www.twilio.com/docs/global-infrastructure/edge-locations
        region: process.env.TWILIO_REGION || '', // default: us1  https://www.twilio.com/docs/global-infrastructure/edge-locations/legacy-regions
        lazyLoading: true,
    } as Twilio.TwilioClientOptions,
    from: process.env.TWILIO_FROM_NUMBER,
    verificationTemplateId: process.env.TWILIO_VERIFICATION_TEMPLATE,
}

FAQ

Too-Many-Requests

  • 创建短信时可能发生 429 错误
1
2
3
4
5
const ret = await this.client.messages.create({
    from,
    to,
    body: text,
})