API概览

本产品(ChatApp消息服务/2020-06-06)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(78410016550),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

流程编辑器

API标题API概述
TriggerChatFlow触发已上线的Flow触发已上线的ChatFlow。

Flow

API标题API概述
PublishFlow发布Flow发布Flow。
UpdateFlowJSONAsset使用JSON更新Flow内容使用JSON更新Flow内容。
ModifyFlow修改Flow基础信息修改Flow基础信息。
ListFlow查询Flow列表查询Flow列表。
GetFlowPreviewUrl获取Flow预览URL获取Flow预览URL。
GetFlowJSONAssest获取Flow的JSON内容获取Flow的JSON格式的内容。
GetFlow获取Flow详细信息获取Flow详细信息。
DeprecateFlow弃用Flow弃用Flow。
DeleteFlow删除Flow删除Flow(只有在DRAFT状态的Flow才允许删除)。
CreateFlow创建Flow创建Flow。

嵌入式相关

API标题API概述
IsvGetAppId获取App IDISV获取App ID。
ChatappBindWaba绑定waba北向接口绑定Waba。
GetPermissionByCode根据嵌入式得到的Code获取授权权限根据嵌入式得到的Code获取授权权限。
ChatappSyncPhoneNumber同步号码信息同步号码信息。
AddChatappPhoneNumber增加Whatsapp号码增加号码到Waba中。
GetPhoneNumberVerificationStatus查询号码验证状态获取号码验证状态。
GetChatappVerifyCode获取号码验证码北向接口获取验证码。
ChatappVerifyAndRegister号码校验并注册北向接口校验验证码并注册。
ChatappPhoneNumberRegister号码注册北向接口注册号码。
ChatappPhoneNumberDeregister取消注册Whatsapp号码从Waba中取消注册号码。
QueryWabaBusinessInfo查询waba商业信息获取Waba账号Business平台信息。
UpdatePhoneWebhook修改号码回调地址信息修改号码回调地址信息。
UpdateAccountWebhook修改账号回调地址信息修改账号回调地址信息。
QueryPhoneBusinessProfile查询号码商业信息查询号码商业信息。
ModifyPhoneBusinessProfile修改号码商业信息修改号码商业信息。
CreateChatappMigrationInitiate创建需要迁移号码新增迁移号码。
GetMigrationVerifyCode获取迁移号码的验证码获取迁移号码的验证码。
ChatappMigrationVerified迁移号码校验迁移号码校验。
ChatappMigrationRegister迁移号码注册迁移号码注册。
GetChatappUploadAuthorization获取上传文件的鉴权信息获取上传文件的鉴权信息。
SubmitIsvCustomerTerms提交Isv客户的协议信息提交Isv客户的协议信息。
GetCommerceSetting获取号码商业设置状态获取号码商业设置状态。
UpdateCommerceSetting修改号码商业设置状态修改号码商业设置状态。
ChatappEmbedSignUp嵌入式入口北向接口嵌入式。 请在调用嵌入式SDK时使用v2版本,此接口即可忽略。

号码管理

API标题API概述
GetWhatsappHealthStatus获取Whatsapp消息发送健康状态获取不同类型的节点发送消息的健康状态。
UpdateConversationalAutomation修改号码欢迎消息、开场白和命令修改号码欢迎消息、开场白和命令。
GetConversationalAutomation获取号码欢迎消息、开场白和命令获取欢迎消息、开场白和命令。
GetPhoneEncryptionPublicKey获取号码的加密公钥获取号码的加密公钥。
UpdatePhoneEncryptionPublicKey更新号码的加密公钥更新号码的加密公钥。
UpdatePhoneMessageQrdl修改消息二维码修改消息二维码。
ListPhoneMessageQrdl查询消息二维码列表查询消息二维码列表数据。
DeletePhoneMessageQrdl删除消息二维码删除消息二维码。
CreatePhoneMessageQrdl创建消息二维码创建消息二维码。
QueryChatappPhoneNumbers查询客户下的所有发送号码及号码状态查询客户下的所有发送号码及号码状态。
QueryChatappBindWaba查询客户绑定的Waba查询客户绑定的WABA。

消息发送

API标题API概述
SendChatappMassMessage批量发送ChatApp消息批量发送ChatApp消息。
SendChatappMessage发送ChatApp消息发送ChatApp消息。

模板管理

API标题API概述
CreateChatappTemplate创建ChatApp模板创建消息模板,模板审核通过后可以发送消息。
ModifyChatappTemplate修改ChatApp模板修改消息模板。只能修改未审核以及审核不通过的模板。
ListChatappTemplate查询ChatApp模板列表获取消息模板列表。
GetChatappTemplateDetail查询ChatApp模板详情获取消息模板的详细信息。
DeleteChatappTemplate删除ChatApp模板删除消息模板。

商品目录

API标题API概述
ListProductCatalog商品目录列表查询Meta Business平台的目录列表。
GetWhatsappConnectionCatalog获取Waba绑定的目录获取Waba关联的目录。
ListProduct商品列表查询目录下的商品列表。

统计指标

API标题API概述
GetChatappPhoneNumberMetric查询号码的发送量指标查询号码的发送量指标。
EnableWhatsappROIMetric开启Whatsapp ROI指标统计开启Whatsapp相关指标统计。
GetChatappTemplateMetric获取Marketing类型模板的相关指标获取Marketing类型模板的相关指标。