WhatsApp API 开发指南

概述

WhatsApp 是全球最受欢迎的消息应用程序之一。通过 WhatsApp Business Platform 和 Twilio，开发人员可以发送通知、进行双向对话并构建聊天机器人。本文将介绍如何使用 Twilio 的 WhatsApp API 进行开发。

WhatsApp 消息传递产品

1. WhatsApp 消费者应用程序：全球用户使用的标准 WhatsApp 应用。
2. WhatsApp Business 应用程序：主要由小型和微型企业使用。
3. WhatsApp 商业平台：以前称为 WhatsApp 商业 API，适用于企业与客户之间的互动。

获取 WhatsApp 访问权限

要使用 WhatsApp API，您需要：

1. 创建 Twilio 账户：访问 Twilio 官网 注册。
2. 启用 WhatsApp：在 Twilio 控制台中按照 自助注册指南 启用 WhatsApp。
3. 获取 Meta Business Manager 账户：通过您的 Meta 业务管理器账户验证您的企业。

用户选择加入

WhatsApp 要求应用程序实现明确的用户选择加入。您可以通过网页或移动应用程序收集此信息。在未经选择加入的情况下发送消息可能会导致账户暂停。

使用 Twilio API 发送消息

发送文本消息

要发送 WhatsApp 消息，您需要使用 Twilio Programmable Messaging API。以下是发送消息的基本代码示例：

// 下载 Twilio 辅助库
const twilio = require("twilio");

// 获取您的账户 SID 和 Auth Token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const authToken = process.env.TWILIO_AUTH_TOKEN;
const client = twilio(accountSid, authToken);

async function createMessage() {
    const message = await client.messages.create({
        body: "Hello, this is a message from your WhatsApp bot!",
        from: "whatsapp:+14155238886", // Twilio 提供的 WhatsApp 号码
        to: "whatsapp:+15005550006" // 接收者的 WhatsApp 号码
    });
    console.log(message.sid);
}

createMessage();

发送媒体消息

要发送包含媒体的消息，可以使用以下代码：

async function sendMediaMessage() {
    const message = await client.messages.create({
        body: "Here's that picture you requested.",
        from: "whatsapp:+14155238886",
        mediaUrl: ['https://example.com/image.jpg'], // 媒体文件的 URL
        to: "whatsapp:+15017122661"
    });
    console.log(message.sid);
}

sendMediaMessage();

接收消息

要接收来自用户的消息，您需要配置 Webhook。Twilio 会在用户发送消息时向您指定的 URL 发送请求。

配置 Webhook

在 Twilio 控制台中，您可以设置 Webhook URL：

• 在 WhatsApp 号码页面
• 在消息服务设置的“集成”部分

处理入站消息

收到的消息将包含文本或媒体。以下是处理入站消息的基本示例：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
app.use(bodyParser.urlencoded({ extended: false }));

app.post('/incoming', (req, res) => {
    const incomingMsg = req.body.Body; // 获取消息文本
    console.log(`Received message: ${incomingMsg}`);
    res.send('<Response></Response>'); // 发送响应
});

app.listen(3000, () => {
    console.log('Webhook is listening on port 3000');
});

消息状态更新

您可以设置状态回调 URL，以接收消息状态的实时更新。在发送消息时包含 statusCallback 参数：

const message = await client.messages.create({
    body: "Your message here.",
    from: "whatsapp:+14155238886",
    to: "whatsapp:+15005550006",
    statusCallback: "https://yourdomain.com/status-callback"
});

结论

通过 Twilio 的 WhatsApp API，您可以轻松地与用户进行沟通并构建强大的聊天解决方案。在开发过程中，请确保遵循 WhatsApp 的政策和最佳实践，以维护账户的健康状态。有关更多信息和详细指南，请访问 Twilio 文档。