Bothub.AI 用户手册简体中文版
Primary version
Primary version
  • 概览
  • 介绍
    • 什么是 Messenger Bot 🤔
  • 快速入门
    • 5分钟创建一个机器人
  • BotHub 基础知识
    • Messenger 机器人的基本功能
    • 多用户管理功能
    • 数据分析
      • 内容分析
      • 流量来源
    • 内容管理
      • 内容结构介绍
      • 文本、图片和视频卡片
      • 菜单卡片及各类按钮
      • 橱窗卡片以及快捷回复
      • 列表卡片
      • 系统设置介绍
      • 标签化内容
      • 广告消息
    • 受众人群
      • 查看历史消息
      • 推送事件
    • 消息群发
      • 广播消息
      • 订阅消息
      • 多时区支持
      • 问卷调研
    • Handover Protocol
    • 人工智能
      • 对话管理
      • 识别优先级
  • BotHub高级工具
    • 高级插件
      • Messenger 网页插件
      • RSS Feed插件
      • 用户输入插件
      • Google搜索插件
      • 订阅管理插件
      • 订阅插件“加入受众”和“移出受众”
      • 商品选取插件
      • 商品搜索插件
      • 购物车展示插件
      • Json Api组件
      • 条件跳转插件
      • 属性设置插件
      • 随机回复插件
      • Typing插件
      • 计数器
      • 语境跳转插件
    • 数据集成
      • 知识库-自动获取Gitbook的文档数据
    • API介绍
      • 开始使用API
      • 关联账号
      • Messenger内的登录按钮
      • 交易信息通知
      • 发送消息API
      • 发送模板消息
      • 生成优惠券的接口的写法
      • 发送知识库条目
      • 参数设置API
      • 呼叫人工
      • whatsapp消息入口
      • 发送whatsapp消息
      • 发送liveChat请求
    • 推广
      • 推广工具
      • 广告管理
      • 再营销SDK的集成
      • 评论回复功能
      • 砍价免费拿
      • Messenger 广告
    • 电商机器人
      • 电商机器人功能介绍
      • 配置你的电商机器人
      • 顾客查询
      • 商家推送
      • 场景应用:顾客查询订单 & 包裹
      • 场景应用:推送订单回执
      • 场景应用:推送订单回执(旧版SDK)
      • 场景应用:包裹更新提醒
      • 场景应用:购物车召回配置
      • 场景应用:购物车召回配置(旧版SDK)
    • 商品管理
      • 商品Feed-Facebook商品数据集成
      • 自定义商品-手动创建活动商品
  • WhatsApp相关说明
    • whatsapp消息入口
    • 发送Whatsapp消息
    • 发送liveChat请求
  • FAQ常见问题
    • Bot 配置常见问题
    • Bot 操作流程问题
      • 如何授权新的FB Page 至Bot平台
      • 首次登录 messenger.bothub.ai 邮箱验证流程
      • 设置仅工作时间段人工客服有效
    • Facebook平台政策问题
      • FB 平台政策
      • Messenger page禁封影响&解封流程
      • 24小时窗口期与24+1 政策解读
Powered by GitBook
On this page
  • 推送消息给所有接收者
  • 限制
  • 发送请求
  • 请求样例
  • 请求返回值
  • 错误码列表
  1. BotHub高级工具
  2. API介绍

发送whatsapp消息

推送消息给所有接收者

Previouswhatsapp消息入口Next发送liveChat请求

Last updated 5 years ago

推送消息给所有接收者

当whatsapp公众号发送消息时相当于bot发送消息。需后才能推送消息,即当天发送过消息的用户才能进行消息的推送。whatsapp把需要推送的消息推送给所有,消息类型可以为文字、图片、文档等。

限制

1、一个调用whatsapp接口的频率常态不能超过20 request per second,瞬时值不能超过60 request per second。落实到发消息的层面,发一条消息需要一个request,并且在给用户消息之前还需要有一个request来确认是否可以发push notification给这个用户。因此发消息给新用户的频率限制就是10 users per second。

2、每天可以发送push notification的用户数的限制:

限制分为三个tier,tier1:每天可以最多发notification到1000个用户。tier2:每天可以最多发notification到10000个用户。tier3:每天可以最多发notification到10万个用户。

升级方式:tier1->tier2:需满足在不超过7天内发送notification到2000个用户。 tier2->tier3:需满足在不超过7天内发送notification到20000个用户。

发送请求

您可以用任意一个已经启用的API Key() 向手机号用户发送消息,消息可以是文字、图片、文档等。这个请求的说明如下:

请求属性

属性名

说明

地址

请求方式

POST

Header

APIKEY

您的API KEY.

Header

Content-Type

application/json

Form Data

id

由WhatsApp分配的消息ID

Form Data

to

channel的手机号

Form Data

timestamp

信息发送的时间戳

Form Data

source

消息来源 (botchat/livechat )

Form Data

type

消息类型(text/image/document/audio)

Form Data

text

当type=text 时显示。形式如下方Text message样例。

Form Data

image

当type=image 时显示。形式如下方Image message样例。

Form Data

document

当type=document 时显示。形式如下方Document message样例。

Form Data

audio

当type=audio 时显示。形式如下方Audio message样例。

请求样例

Text message
{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "text",
    "text": {
        "body": "Hello world"
    }
}
Image message
{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "image",
    "image": {
        "url": "your-media-url",
        "caption": "your-image-caption",
        "extension": "<see the list of available extensions>"
    }
}
Document message
{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "document",
    "document": {
        "url": "your-document-url",
        "caption": "your-document-caption",
        "extension": "<see the list of available extensions>"
    }
}
Audio message
{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "document",
    "audio": {
        "url": "your-audio-url",
        "caption": "your-audio-caption",
        "extension": "<see the list of available extensions>"
    }
}

请求返回值

  • 成功返回值样例

{
    "result": true,
    "data": {}
}
  • 失败返回值样例

{
    "error": {
        "code": 10011,
        "error_subcode": 0,
        "type": "",
        "message": "Request already processed",
        "request_id": 35122312158
    }
}

错误码列表

返回值

内容

10000

内部错误

10001

未指定API KEY

10002

无效的API KEY

10003

未指定Request id

10004

未指定调用API的种类

10005

无效的API种类

10005

无效的API种类

10006

Bot不存在或者已经被删除

10011

Request id与之前的重复

10100

参数无效

18000

内部错误

19000

回调超时

41006

未指定id

41007

未指定to

41008

未指定type

41009

未指定timestamp

41010

未指定image

41011

未指定document

41012

未指定text

41013

未指定audio

41014

无效的type

41015

未指定text内的body

41016

未指定document内的caption

41017

未指定document内的url

41018

未指定document内的extension

41019

未指定image内的caption

41021

未指定image内的url

41022

未指定image内的extension

41023

未指定audio内的caption

41024

未指定audio内的url

41025

未指定audio内的extension

41035

未指定source

41036

source值不正确

80001

BSP错误

80002

network error

opt-in
接收者
怎样申请APIKey
https://api.moto-me.com
/channels/{
bot_phone
}/messages