API概览

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

IM 群管理

API标题API概述
UpdateChatGroup修改IM群信息修改IM群信息。
ListChatGroupParticipantsIM群成员列表获取IM群成员列表。
ListChatGroupIM群列表获取IM群列表。
DeleteChatGroupParticipants删除IM群成员删除进入IM群的成员。
DeleteChatGroupParticipants删除IM群成员删除进入IM群的成员。
DeleteChatGroupInviteLink删除IM群邀请链接删除IM群邀请链接。
DeleteChatGroup删除IM删除已创建成功的IM群。
AddChatGroup创建IM创建IM群。
AddChatGroupInviteLink添加IM群邀请链接添加IM群邀请链接。

流程编辑器

API标题API概述
ListFlowNodePrototypeV2列举流程组件原型列举流程组件原型。
FlowBindPhone流程绑定号码或商家账号ID流程绑定号码或商家账号ID。
ReadChatFlow获取流程详情获取流程详情。
DeleteChatFlow删除流程删除流程。
FlowUnbindPhone流程解除绑定号码或商家账号ID流程解除绑定号码或商家账号ID。
UpdateChatFlow更新流程基础信息根据流程编码更新流程基础信息。
FlowRebindPhone流程重新绑定号码或商家账号ID流程重新绑定号码或商家账号ID。
ListChatFlow列举流程列举流程。
ReadFlowVersion获取流程版本获取流程版本。
OfflineFlowVersion下线流程版本下线的流程版本。
UpdateFlowVersion更新流程版本DSL数据更新流程版本DSL数据,用于画布更新流程版本。
TriggerChatFlow触发已上线的流程版本触发已上线且触发器类型为手动的流程版本。
DeleteFlowVersion删除流程版本删除流程版本。
CreateFlowVersion创建流程版本通过复制流程版本创建新的流程版本。
ListFlowVersion列举流程版本列举流程版本。
OnlineFlowVersion上线流程版本上线流程版本。
CreateChatFlow创建流程创建流程。
CreateChatFlowByImport创建并导入流程创建并导入流程。
ListBindingRelationsForFlowVersion查询已绑定的号码或商家账号ID列表根据流程编码查询已绑定的手机号码或商家账号ID列表。
ListChatFlowTemplate列举流程模板列举流程模板。
GetChatFlowTemplate查询流程模板详情查询流程模板详情。
UpdateChatFlowLogSetting更新流程日志设置更新流程日志设置。
CreateChatFlowLogSetting创建流程日志设置创建流程日志设置。
ReadChatFlowLogSetting查看流程日志设置查看流程日志设置。
GetChatFlowMetric获取ChatFlow运行数据获取ChatFlow运行数据。

Flow

API标题API概述
PublishFlow发布Flow发布Flow。
UpdateFlowJSONAsset使用JSON更新Flow内容使用JSON更新Flow内容。
ModifyFlow修改Flow基础信息修改Flow基础信息。
ListFlow查询Flow列表查询Flow列表。
GetFlowPreviewUrl获取Flow预览URL获取Flow预览URL。
GetFlowJSONAssest获取FlowJSON内容获取FlowJSON格式的内容。
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模板删除消息模板。
ModifyChatappTemplateProperties修改模板部分属性修改模板上的部分属性。

商品目录

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

统计指标

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