wouter0100/quepasa

QuePasa

一个（微型）web应用，让基于网页的***机器人开发变得简单。

基于https://github.com/Rhymen开发的库https://github.com/Rhymen/go-***构建。

镜像概述

QuePasa是一款开源工具，旨在简化***机器人的开发流程。它通过HTTP接口提供消息发送、接收等核心功能，并将账号数据和密钥存储在PostgreSQL数据库中，方便集成到各类web应用（如帮助台系统）中。

核心功能

• 注册***号码
• 通过QR码验证号码
• 账号数据和密钥的持久化存储
• 提供HTTP接口：
  • 发送消息
  • 接收消息

警告：本应用未经过安全审计，不应视为安全可靠，使用风险自负。
本项目为第三方独立开发，与***无任何关联。

使用场景

当您需要从其他服务（如帮助台系统或其他web应用）通过***进行通信时，QuePasa提供了简单的HTTP API来实现这一需求。

配置说明

前提条件

本地开发需准备：

• docker
• golang
• postgresql

Docker运行步骤

1. 构建镜像：

bash
make docker_build

2. 编辑docker-compose.yml.sample以适配您的需求
3. 启动服务：

bash
docker-compose up

HTTP API

使用时需添加Accept: application/json请求头，TOKEN需视为密码妥善保管。

获取机器人信息

测试机器人认证令牌的简单方法，无需参数，返回机器人基本信息。
请求

GET /bot/<TOKEN>/

响应

json
{
    "id": "129f1757-e706-452e-aa1c-4994a95e1092",
    "number": "+15555555552",
    "user_id": "845ae4d0-f2c3-5342-91a2-5b45cb8db57c",
    "token": "8129c0b4-0b96-4486-84fc-c3dd7b03f846",
    "is_verified": true,
    "created_at": "2018-11-02T11:36:24.273Z",
    "updated_at": "2018-11-02T11:36:24.273Z"
}

发送消息

请求

POST /bot/<TOKEN>/send

{
  "recipient": "+15555555552",
  "message": "Hello World!"
}

响应

json
{
  "result": {
    "recipient": "+15555555551",
    "source": "+15555555552",
    "status": "sent",
    "timestamp": "1543420505142"
  }
}

接收消息

timestamp查询参数可选，每个对话最多返回40条消息。
请求

GET /bot/<TOKEN>/receive?timestamp=1541265073783

响应

json
{
  "messages": [
    {
      "source": "+15555555551",
      "timestamp": "1541265073894",
      "message": {
        "body": "Hello World!",
        "profileKey": "XXTXQ=="
      }
    }
  ],
  "bot": {
    "id": "129f1757-e706-452e-aa1c-4994a95e1092",
    "number": "+15555555552",
    "user_id": "845ae4d0-f2c3-5342-91a2-5b45cb8db57c",
    "token": "8129c0b4-0b96-4486-84fc-c3dd7b03f846",
    "is_verified": true,
    "created_at": "2018-11-02T11:36:24.273Z",
    "updated_at": "2018-11-02T11:36:24.273Z"
  }
}

许可证

https://img.shields.io/badge/License-AGPL%203.0-lightgrey.svg](https://gitlab.com/digiresilience/link/quepasa/blob/master/LICENSE.md)
QuePasa是自由软件项目，由数字弹性中心授权使用GNU Affero通用公共许可证v3.0（GNU AGPLv3）。