TenkaTenka
登录

Tenka 帮助中心 › 平台与安全 › Webhook(出站集成)

Webhook(出站集成)

当这里发生事情时通知你自己的系统:发票已付款、提案已接受、交易已成交、需求已创建、线索已创建——通过带签名的HTTP方式发送。

🕒 更新于 2026年9月30日📖 ~2 分钟阅读

这个页面有什么

直接从页面读取的写照——页面变了,这里也会变。

可用操作

发送测试事件

列表显示

事件状态尝试何时

表单字段

DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo

从这里开始

用途是什么
无需轮询的实时集成:注册您自己的URL并选择事件。事件发生时,我们会发送一个包含该事件JSON数据的POST请求。
Webhook 以列表展示,投递在顶部
列表显示每个 webhook 的描述、URL、事件、遮蔽后的密钥以及是否启用。顶部是最近投递 — 事件、状态、HTTP 代码、尝试次数和时间 — 以及“发送测试”按钮,它会向所有启用的订阅排队一个 ping。

规则

安全性(HMAC签名)
每个订阅都有一个密钥(whsec_...)。每次发送都带有X-Tenka-Signature头(消息体的HMAC-SHA256)——在信任内容之前,请在您的服务器上验证该签名。
投递与重发
发送失败了吗(超时/5xx)?队列会以递增的间隔重试。最新的投递记录会连同状态显示在屏幕上——使用"测试"按钮来验证您的URL。
可用事件
fatura.paga、proposta.aceita、negocio.ganho、demanda.criada 和 lead.criado。目录只显示实际会触发的事件——没有空头承诺。
详情中的密钥和事件
在详情中,密钥为每次投递的正文签名(X-Tenka-Signature 头,HMAC):请在您这一侧校验以确认来源。留空时 Tenka 会自动生成;旁边的按钮可重新生成。在“事件”中保持“全部”或选择要触发的事件 — 至少一个。
删除即移除订阅
Webhook 不会进入回收站:删除会移除订阅,您的系统会立即停止接收事件。若想暂停而不丢失配置,请取消勾选“启用”。

常见问题

最佳实践
快速返回2xx响应(在您那边异步处理);通过事件id处理重复(重试时投递可能会重复)。
这篇文章有帮助吗?

同一模块中: 平台与安全38

Tenka 学院

针对您行业的分步学习路径,就在平台内。

了解学院