WhatsApp API 開發(fā)指南

概述

WhatsApp 是全球最受歡迎的消息應(yīng)用程序之一。通過 WhatsApp Business Platform 和 Twilio，開發(fā)人員可以發(fā)送通知、進(jìn)行雙向?qū)υ挷?gòu)建聊天機(jī)器人。本文將介紹如何使用 Twilio 的 WhatsApp API 進(jìn)行開發(fā)。

WhatsApp 消息傳遞產(chǎn)品

1. WhatsApp 消費(fèi)者應(yīng)用程序：全球用戶使用的標(biāo)準(zhǔn) WhatsApp 應(yīng)用。
2. WhatsApp Business 應(yīng)用程序：主要由小型和微型企業(yè)使用。
3. WhatsApp 商業(yè)平臺：以前稱為 WhatsApp 商業(yè) API，適用于企業(yè)與客戶之間的互動。

獲取 WhatsApp 訪問權(quán)限

要使用 WhatsApp API，您需要：

1. 創(chuàng)建 Twilio 賬戶：訪問 Twilio 官網(wǎng) 注冊。
2. 啟用 WhatsApp：在 Twilio 控制臺中按照 自助注冊指南 啟用 WhatsApp。
3. 獲取 Meta Business Manager 賬戶：通過您的 Meta 業(yè)務(wù)管理器賬戶驗證您的企業(yè)。

用戶選擇加入

WhatsApp 要求應(yīng)用程序?qū)崿F(xiàn)明確的用戶選擇加入。您可以通過網(wǎng)頁或移動應(yīng)用程序收集此信息。在未經(jīng)選擇加入的情況下發(fā)送消息可能會導(dǎo)致賬戶暫停。

使用 Twilio API 發(fā)送消息

發(fā)送文本消息

要發(fā)送 WhatsApp 消息，您需要使用 Twilio Programmable Messaging API。以下是發(fā)送消息的基本代碼示例：

// 下載 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();

發(fā)送媒體消息

要發(fā)送包含媒體的消息，可以使用以下代碼：

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 會在用戶發(fā)送消息時向您指定的 URL 發(fā)送請求。

配置 Webhook

在 Twilio 控制臺中，您可以設(shè)置 Webhook URL：

• 在 WhatsApp 號碼頁面
• 在消息服務(wù)設(shè)置的“集成”部分

處理入站消息

收到的消息將包含文本或媒體。以下是處理入站消息的基本示例：

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>'); // 發(fā)送響應(yīng)
});

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

消息狀態(tài)更新

您可以設(shè)置狀態(tài)回調(diào) URL，以接收消息狀態(tài)的實(shí)時更新。在發(fā)送消息時包含 statusCallback 參數(shù)：

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

結(jié)論

通過 Twilio 的 WhatsApp API，您可以輕松地與用戶進(jìn)行溝通并構(gòu)建強(qiáng)大的聊天解決方案。在開發(fā)過程中，請確保遵循 WhatsApp 的政策和最佳實(shí)踐，以維護(hù)賬戶的健康狀態(tài)。有關(guān)更多信息和詳細(xì)指南，請訪問 Twilio 文檔。