没问题！我来一步步给你讲清楚怎么安装和使用 messaging-api-viber 包，先从npm的基础准备说起～

npm是Node.js的包管理工具，所以首先得确保你已经装了Node.js（npm会随Node.js一起安装）。打开终端/命令提示符，输入以下命令检查版本：

node -v
npm -v

如果能看到对应的版本号，说明已经安装好了；如果没装，直接去Node.js官方网站下载对应系统的安装包，安装完成后npm就自动可用了。

打开你的项目目录（如果还没项目，先新建一个文件夹并进入），在终端里运行以下命令完成本地安装（推荐项目本地安装，避免全局依赖冲突）：

npm install messaging-api-viber

如果你习惯用yarn，也可以用：

yarn add messaging-api-viber

如果需要全局安装（比如在多个项目里共用），可以加-g参数：

npm install -g messaging-api-viber

1. 初始化Viber客户端 #

首先你需要从Viber开发者平台获取你的API密钥（要先创建一个Viber公共账号），然后用密钥初始化客户端：

const { ViberClient } = require('messaging-api-viber');

// 替换成你自己的Viber API密钥
const client = ViberClient.connect('YOUR_VIBER_API_KEY');

2. 发送文本消息 #

初始化完成后，就可以给指定用户发送消息了，记得替换成目标用户的Viber ID：

// 发送文本消息
client.sendText('TARGET_USER_VIBER_ID', '嗨！这是来自messaging-api-viber的测试消息～')
  .then(response => {
    console.log('消息发送成功:', response);
  })
  .catch(error => {
    console.error('发送消息失败:', error);
  });

3. 设置Webhook接收消息 #

如果需要接收用户发来的消息，你得设置一个Webhook，下面是用Express框架实现的简单示例：

const express = require('express');
const { ViberClient, ViberWebhook } = require('messaging-api-viber');

const app = express();
const client = ViberClient.connect('YOUR_VIBER_API_KEY');

// 配置Webhook路由
app.use('/viber/webhook', ViberWebhook({
  authToken: 'YOUR_VIBER_API_KEY',
  // 处理收到的消息
  onMessage: async (event) => {
    console.log('收到用户消息:', event);
    // 回复用户消息
    await client.sendText(event.sender.id, `你刚才说：${event.message.text}`);
  },
}));

// 启动服务器
app.listen(3000, () => {
  console.log('服务器运行在3000端口');
});

• API密钥要保密：别把密钥硬编码在代码里，建议用环境变量（比如process.env.VIBER_API_KEY）来管理。
• Webhook需要公网可访问：Viber的Webhook服务需要能访问到你的服务器，所以如果是本地开发，可能需要用内网穿透工具来临时暴露本地端口。
• 拓展功能参考文档：如果需要发送图片、视频、交互式键盘等复杂消息，可以查看包的内置说明或Viber官方的API规范。

内容的提问来源于stack exchange，提问作者Ivan Yurchenko