在Twilio Functions中直接指定TwiML替代URL的可行性及报错咨询

安全阿岳

2026-7-31

在Twilio Functions中直接指定TwiML实现通话内容的方法

Twilio 支持直接指定TwiML来定义通话内容，无需依赖外部URL。你碰到的Url parameter is required错误，是因为参考的官方示例默认用Url参数指向返回TwiML的资源，要是想直接传TwiML，得调整参数的使用方式。

方式1：在Function里直接返回TwiML

如果你的Function用来处理呼叫逻辑并返回TwiML，直接在代码里构建返回就行：

exports.handler = function(context, event, callback) {
  const twiml = new Twilio.twiml.VoiceResponse();
  twiml.say('这是来自Twilio Functions的直接TwiML问候！');
  twiml.hangup();
  
  callback(null, twiml);
};

这种情况发起呼叫时，要把这个Function的URL作为Url参数传入，也就是官方示例的常规用法。如果想跳过Url，直接在发起呼叫时传TwiML，看下面的方式2。

方式2：发起呼叫时直接传入TwiML内容

通过Twilio API发起外呼时，直接用twiml参数传入内容，不用Url参数，示例代码如下：

exports.handler = async function(context, event, callback) {
  const client = context.getTwilioClient();
  
  try {
    const call = await client.calls.create({
      to: event.to, // 目标通话号码
      from: context.TWILIO_PHONE_NUMBER, // 你的Twilio号码（需在环境变量配置）
      twiml: '<Response><Say>直接通过传入的TwiML发起通话！</Say></Response>' // 直接写TwiML字符串
    });
    callback(null, { 通话ID: call.sid });
  } catch (error) {
    callback(error);
  }
};

这里要注意用的是小写的twiml参数，不是Url，这样就不会触发Url parameter is required的错误了。