WhatsApp & App userid Mapping

ID Mapping为一次性付费服务,如有意向请咨询飞书深诺商务。

一、生成唤起WA链接

格式

https://wa.me/{phone_number}?text={content}
phone_number使用国际格式的完整电话号码,即注册在Meetbot平台的商户WhatsApp。
在添加国际格式的电话号码时,请省略 0、方括号或破折号。
content:是预先填好且经过网址编码的文字内容,在用户点击链接唤起WhatsApp该内容会出现在输入框中。

内容

content值需要参考下面案例,当前规则是英语“[xxx]”,xxx为参数值,后续会解析回传给品牌方;当前只有第一个值(source)和第三个值(user_id)进行回传。
  • 案例1:我是来自[R01]的[app昵称][uid_645d7e34027af8d7cb8f75bd],我要领取50书币的奖励。(!!请不要修改,直接发送参与活动)
  • 案例2:我是来自[A12]的[app昵称][cid_645d7e34027af8d7cb8f75bd],我有问题需要帮助。(!!请不要修改,直接发送,这能让我们更好为您服务)
如:https://wa.me/8612345678910?text=[source_name]this is [app_name/user_name][user_id] , >>Please send this sentence to receive a reward. <<:-) ☺

二、webhook推送

  1. 需要品牌方提供一个POST请求的接口;
  2. 品牌方提前将需要内容解析的商户WhatsApp手机号(提供店铺bot id)以及webhook推送地址给到Meetbot CSM; 
  3. webhook推送格式
1 { 2 "source": "R01", // 品牌方生成文案中的来源 3 "user_id": "uid_645d7e34027af8d7cb8f75bd", // 品牌方生成文案中的品牌的用户ID 4 "wa_id": "XXXXXX", // 品牌方用户绑定的WhatsApp手机号 5 "wa_nickname": "XXXXXX", // 品牌方用户绑定的WhatsApp昵称 6 "timestamp": "XXXXXX" // 品牌方用户绑定WhatsApp时间戳(毫秒) 7 }
注意:
  1. 品牌方接收到推送消息时,响应状态码为200,Meetbot认为推送成功;
  2. 当Meetbot调用品牌方webhook地址推送失败,后续会间隔5分钟推送一次,直到推送成功;
2024-12-04
0