树莓派传感器触发：通过Twilio API发送WhatsApp消息教程-Python教程-PHP中文网

树莓派传感器触发：通过Twilio API发送WhatsApp消息教程

DDD

发布： 2025-12-01 12:16:36

原创

997人浏览过

树莓派传感器触发：通过Twilio API发送WhatsApp消息教程

本教程详细介绍了如何利用树莓派（raspberry pi）监测传感器事件，并通过twilio api发送whatsapp消息通知。文章涵盖了twilio whatsapp功能配置、python编程实现以及在树莓派上部署的完整流程，旨在帮助用户构建一个经济高效的海外即时通知系统，有效规避传统短信在国际漫游时可能产生的高额费用。

1. 概述与需求分析

在物联网项目中，当特定事件（如传感器触发）发生时，即时通知用户至关重要。传统的短信（SMS）在国际环境下可能会产生较高的漫游费用，而WhatsApp作为全球流行的即时通讯工具，通过互联网发送消息，成本显著降低，成为海外通知的理想选择。本教程将指导您如何结合树莓派的硬件交互能力和Twilio的WhatsApp API，实现一个低成本、高效率的传感器触发通知系统。

2. Twilio WhatsApp API配置

Twilio是一个云通信平台，提供了强大的API来发送短信、拨打电话和发送WhatsApp消息。要通过Twilio发送WhatsApp消息，您需要完成以下设置：

注册Twilio账户并获取凭证： 访问Twilio官网注册账户。注册后，您将在控制台仪表板上找到您的Account SID和Auth Token。这些是您通过Twilio API进行身份验证的关键凭证。
启用Twilio号码支持WhatsApp： Twilio提供了两种方式来使用WhatsApp API：
- Twilio WhatsApp沙盒： 这是最快捷的测试方式。Twilio会为您提供一个预配置的Twilio号码，您需要通过向该号码发送特定消息来加入沙盒。沙盒模式下，您只能向已加入沙盒的WhatsApp号码发送消息，并且有24小时会话限制。
- Twilio生产环境号码： 如果您需要长期、稳定地发送WhatsApp消息，需要购买一个支持WhatsApp功能的Twilio号码，并提交申请以将其与您的WhatsApp Business Profile关联。此过程可能需要一些时间进行审核。
无论哪种方式，您都需要一个Twilio号码作为消息的发送方（From号码），以及一个接收消息的WhatsApp号码（To号码）。
安装Twilio Python SDK： 在您的开发环境或树莓派上，通过pip安装Twilio Python库：
```
pip install twilio
```
登录后复制

3. 树莓派与传感器集成

树莓派提供了GPIO（通用输入/输出）引脚，可以方便地连接各种传感器。本教程以一个简单的数字传感器（如按钮或PIR运动传感器）为例，当传感器状态改变时触发WhatsApp消息。

连接传感器： 将您的数字传感器连接到树莓派的GPIO引脚。通常，这包括VCC（电源）、GND（地）和DATA（数据）引脚。请查阅您的传感器数据手册以获取正确的接线方式。
安装RPi.GPIO库： 树莓派通常预装了RPi.GPIO库，如果没有，您可以通过以下命令安装：
```
sudo apt-get update
sudo apt-get install python3-rpi.gpio
```
登录后复制

4. Python编程实现

以下是一个Python脚本示例，演示如何在树莓派上读取传感器状态，并在触发时通过Twilio发送WhatsApp消息。

import RPi.GPIO as GPIO
import time
from twilio.rest import Client

# --- Twilio 配置 ---
# 从Twilio控制台获取您的Account SID和Auth Token
ACCOUNT_SID = "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # 替换为您的Account SID
AUTH_TOKEN = "your_auth_token"                  # 替换为您的Auth Token
TWILIO_WHATSAPP_FROM = "whatsapp:+14155238886"   # 替换为您的Twilio WhatsApp号码（沙盒或生产）
TO_WHATSAPP_NUMBER = "whatsapp:+8613800138000"   # 替换为接收消息的WhatsApp号码

# --- 传感器配置 ---
SENSOR_PIN = 17  # 替换为您连接传感器的GPIO引脚编号 (BCM模式)

# --- 初始化Twilio客户端 ---
client = Client(ACCOUNT_SID, AUTH_TOKEN)

def send_whatsapp_message(message_body):
    """
    通过Twilio发送WhatsApp消息
    """
    try:
        message = client.messages.create(
            from_=TWILIO_WHATSAPP_FROM,
            body=message_body,
            to=TO_WHATSAPP_NUMBER
        )
        print(f"WhatsApp消息发送成功，SID: {message.sid}")
    except Exception as e:
        print(f"发送WhatsApp消息失败: {e}")

def setup_gpio():
    """
    设置GPIO引脚
    """
    GPIO.setmode(GPIO.BCM)  # 使用BCM引脚编号
    GPIO.setup(SENSOR_PIN, GPIO.IN, pull_up_down=GPIO.PUD_DOWN) # 设置为输入模式，并启用下拉电阻

def main():
    """
    主程序循环，监测传感器状态
    """
    setup_gpio()
    print(f"正在监测GPIO引脚 {SENSOR_PIN} 的传感器状态...")
    sensor_triggered = False # 记录传感器上次状态

    try:
        while True:
            current_sensor_state = GPIO.input(SENSOR_PIN)

            if current_sensor_state == GPIO.HIGH and not sensor_triggered:
                print("传感器触发！")
                send_whatsapp_message("注意：您的传感器已被触发！")
                sensor_triggered = True
            elif current_sensor_state == GPIO.LOW and sensor_triggered:
                print("传感器复位。")
                # 可选：传感器复位时发送消息
                # send_whatsapp_message("传感器已复位。")
                sensor_triggered = False

            time.sleep(0.5) # 每0.5秒检查一次

    except KeyboardInterrupt:
        print("程序终止。")
    finally:
        GPIO.cleanup() # 清理GPIO设置，释放资源

if __name__ == "__main__":
    main()

登录后复制

代码说明：

Remove.bg

AI在线抠图软件，图片去除背景

174

查看详情

Twilio配置： 替换ACCOUNT_SID、AUTH_TOKEN、TWILIO_WHATSAPP_FROM和TO_WHATSAPP_NUMBER为您的实际信息。
- TWILIO_WHATSAPP_FROM：格式为whatsapp:+<国家码><区号><号码>，例如whatsapp:+14155238886。
- TO_WHATSAPP_NUMBER：同样为whatsapp:+<国家码><区号><号码>，例如whatsapp:+8613800138000。
传感器配置： SENSOR_PIN变量应设置为您传感器连接的GPIO引脚的BCM编号。
send_whatsapp_message函数： 封装了Twilio API调用，用于发送消息。
setup_gpio函数： 初始化GPIO引脚为输入模式，并设置内部下拉电阻，以确保在没有外部输入时引脚保持低电平。
main函数： 进入一个无限循环，持续读取传感器引脚的状态。当检测到传感器从低电平变为高电平（触发）时，调用send_whatsapp_message发送通知。sensor_triggered变量用于避免在传感器持续触发时重复发送消息。
错误处理与清理： 使用try...except KeyboardInterrupt...finally结构来确保程序在终止时能正确清理GPIO资源。

5. 部署与测试

保存脚本： 将上述代码保存为.py文件，例如sensor_whatsapp.py。
上传到树莓派： 将文件上传到您的树莓派。
运行脚本： 在树莓派的终端中执行脚本：
```
python3 sensor_whatsapp.py
```
登录后复制
触发传感器： 模拟传感器触发事件（例如，按下连接到GPIO引脚的按钮，或在PIR传感器前移动）。您应该会在接收方WhatsApp上收到通知消息。

为了让脚本在后台持续运行，即使您关闭终端，可以使用nohup命令或配置systemd服务：

使用nohup：
```
nohup python3 /path/to/your/sensor_whatsapp.py &
```
登录后复制
这将使脚本在后台运行，并将输出重定向到nohup.out文件。

配置systemd服务（推荐用于生产环境）： 创建一个新的服务文件，例如/etc/systemd/system/sensor_whatsapp.service：

[Unit]
Description=Sensor WhatsApp Notification Service
After=network.target

[Service]
ExecStart=/usr/bin/python3 /path/to/your/sensor_whatsapp.py
WorkingDirectory=/path/to/your/script/directory
StandardOutput=inherit
StandardError=inherit
Restart=always
User=pi # 或者其他非root用户

[Install]
WantedBy=multi-user.target

登录后复制

然后启用并启动服务：

sudo systemctl enable sensor_whatsapp.service
sudo systemctl start sensor_whatsapp.service

登录后复制

6. 注意事项与优化

Twilio沙盒限制： 如果使用沙盒模式，请记住消息发送有24小时会话窗口限制。要进行持续测试，您可能需要每24小时重新加入沙盒。
Twilio生产环境： 对于正式项目，务必申请Twilio生产环境的WhatsApp号码，并完成WhatsApp Business Profile的审核。
错误处理与日志： 在生产环境中，应加入更健壮的错误处理机制和日志记录，以便追踪消息发送失败的原因。
安全性： 切勿在公共代码仓库中硬编码您的Twilio ACCOUNT_SID和AUTH_TOKEN。建议使用环境变量或配置文件来存储这些敏感信息。
网络连接： 树莓派需要稳定的互联网连接才能与Twilio API通信。
消息频率： 注意Twilio和WhatsApp的消息发送频率限制，避免因发送过快而被限流。
电源管理： 确保树莓派和传感器有稳定的电源供应。

总结

通过本教程，您已经学会了如何利用树莓派、传感器和Twilio WhatsApp API构建一个经济高效的实时通知系统。这种方案不仅解决了传统短信在国际漫游时的费用问题，还提供了一个灵活且可扩展的通知平台，适用于各种物联网应用场景，如家庭安防、环境监测或设备状态报警等。通过合理的配置和编程，您可以轻松扩展此系统以适应更复杂的通知需求。

以上就是树莓派传感器触发：通过Twilio API发送WhatsApp消息教程的详细内容，更多请关注php中文网其它相关文章！