2025.3.4
首页 ▸ Integrations ▸

Twilio 短信

twilio_sms 通知平台支持通过短信发送通知，由 Twilio 提供支持。

前提是您已经设置了 Twilio。

配置

要在您的安装中使用此通知平台，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
notify:
  - name: NOTIFIER_NAME
    platform: twilio_sms
    from_number: E164_PHONE_NUMBER 或 SENDER_ID

Configuration Variables

Looking for your configuration file?
from_number string Required

一个 E.164 格式的电话号码，例如 +14151234567。有关格式化电话号码的更多信息，请参阅 Twilio 的电话号码格式指南。或者，可以使用发送者 ID 替代电话号码。发送者 ID 必须按照 Twilio 的指南格式进行格式化。有关更多信息，请参阅 Twilio 的发送者 ID 指南。请注意，并非所有国家都支持发送者 ID。有关更多信息，请参阅 Twilio 支持的国家页面。

name string (Optional, default: notify)

设置可选参数 name 允许创建多个通知器。通知器将绑定到 notify.NOTIFIER_NAME 操作。

用法

Twilio 是一个通知平台，因此可以通过调用通知操作来控制 如这里所述。它将向通知 目标 中的所有 E.164 电话号码发送通知。有关格式化电话号码的信息，请参阅上面的 from_number 配置变量说明。也可以使用 whatsapp:+123456789 向 Whatsapp 用户发送通知。

可以通过设置可选的 media_url 变量来与消息一起包含媒体。根据 Twilio 的文档，只有 .gif、.png 或 .jpeg 内容受支持，并且此功能 仅在美国和加拿大支持。

# 示例自动化通知条目
automation:
  - alias: "太阳已落山"
    triggers:
      - trigger: sun
        event: sunset
    actions:
      - action: notify.twilio_sms
        data:
          message: "太阳已落山"
          target:
            - '+14151234567'
            - '+15105555555'
          data:
            media_url:
              - "https://www.home-assistant.io/images/supported_brands/home-assistant.png"