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 文檔。