SuperAPI AI 工具集

twilio

通用与其它

查看项目

更新于 10-16 06:57

技能介绍

Twilio 技能用于通过 Twilio REST API 发送短信、发起语音通话以及管理电话号码。

用途 该技能面向需要通过 Twilio 平台进行通信操作的场景,包括发送 SMS 消息、发起语音呼叫,以及查询和管理账户下的电话号码与消息记录。

主要能力

  • 发送短信:向指定号码发送 SMS 消息。
  • 发起语音通话:向指定号码发起语音呼叫,并可通过 Url 参数指定语音 XML 文档。
  • 列出消息:查询账户下的消息列表,支持分页(如 PageSize=10)。
  • 列出电话号码:查询账户下的来电电话号码列表。
  • 获取通话详情:根据通话 SID 查询单次通话的详细信息,包括状态、时长和价格。

使用方式 该技能通过环境变量进行认证,需要设置:

  • TWILIO_ACCOUNT_SID:账户 SID
  • TWILIO_AUTH_TOKEN:认证令牌

所有操作均通过 curl 命令调用 Twilio REST API(API 版本为 2010-04-01)完成,并使用 -u 参数传入账户 SID 与认证令牌进行基本认证。

发送短信示例: curl -s -X POST
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json"
-u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN"
--data-urlencode "To=+15551234567"
--data-urlencode "From=+15559876543"
--data-urlencode "Body=Hello from ThinkFleetBot!" | jq '{sid, status, to, from}'

发起语音通话示例: curl -s -X POST
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Calls.json"
-u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN"
--data-urlencode "To=+15551234567"
--data-urlencode "From=+15559876543"
--data-urlencode "Url=http://demo.twilio.com/docs/voice.xml" | jq '{sid, status, to, from}'

列出消息示例: curl -s "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json?PageSize=10"
-u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" | jq '.messages[] | {sid, to, from, body, status, date_sent}'

列出电话号码示例: curl -s "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json"
-u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" | jq '.incoming_phone_numbers[] | {sid, phone_number, friendly_name}'

获取通话详情示例: curl -s "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Calls/CALL_SID.json"
-u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" | jq '{sid, to, from, status, duration, price}'

适用场景 适用于需要以编程方式发送短信、拨打电话或查询 Twilio 账户中消息与电话号码信息的自动化流程或集成场景。

限制与注意事项

  • 在发送短信或拨打电话前应始终进行确认。
  • 电话号码必须采用 E.164 格式(例如 +15551234567)。
  • 关于该技能的收费、价格、平台支持范围等更多信息,资料中暂未提供。