在 Aircall 中设置 webhook 触发器允许您根据关键事件(例如创建用户、关闭号码、发送消息或代理呼叫响铃时)将数据无缝传递到外部系统。
当联系人被修改或生成新的“对话智能”事件(如情绪分析)时, Webhook还可以触发更新。
本指南将指导您使用 Aircall 仪表板和 API 设置 Aircall webhook,以实现高效的数据传输和事件管理。
通过仪表板在 Aircall 中设置 webhook
要在 Aircall 仪表板中直接配置 webhook:
1. 在集成页面,点击“Webhook集成”。
2. 然后点击“安装”。
3. 在集成名称(自定义)字段中,您可以设置一个名称,以便在集成列表中轻松识别您的 webhook。(可选)
4. 接下来,在 URL 字段中,设置您在 Web 服务器上创建的端点的 URL。只有一个 URL 可用,并且不允许更改标头。
5. 切换需要接收的事件开关,默认事件都是开启的。
6.最后“保存”完成配置。
带有绑定事件的集成设置屏幕
使用 Aircall 公共 API 创建 Webhook
Aircall 公共 API 可让您获取、创建、更新 阿富汗电话号码数据 和删除 Aircall 帐户的 Webhook。对于身份验证,如果您是 Aircall 的技术合作伙伴,则可以使用 OAuth,它将访问权限限制为仅链接到您的令牌的 Webhook。
如果您是 Aircall 客户,您可以使用 Basic Auth,允许访问通过 Aircall 仪表板和 Basic Auth API 请求创建的 webhook。
让我们看看更通用的方式:使用 Basic Auth 调用 Aircall API。
1)获取您的api_id和api_token以进行授权。
转到您公司的设置页面。
单击 API 密钥部分中的“添加新 API 密钥”以获取您的 api_id 和 api_token。
在 Basic Auth 格式中,api_id 将是您的用户名。api_token 将是您的 api_token。
2)调用 Aircall API 创建新的 webhook
转到 Postman 并创建一个新的 HTTP 请求。
选择 POST 操作。
将 URL 字段设置为“ https://api.aircall.io/v1/webhooks ”。
输入标题“Content-Type”:application/json。
输入api_id作为用户名,api_token作为密码的授权。
使用以下内容输入 POST 请求正文
url:目的地的 URL。
events:您想要触发的事件
3.发送API请求,一旦收到201响应状态,配置就完成。
在 Aircall 中管理 webhook 的最佳实践
正确处理 Aircall 中的 webhook 有助于简化系统之间的通信并提高整体工作流程效率。实施这些最佳实践将带来更顺畅、更可靠的集成。
使用 HTTPS webhook URL。
始终返回 200 HTTP 代码。
以异步方式处理大任务。
在本地主机上测试您的应用程序。
自动重新启用已停用的 webhook。
call.hungup 和 call.ended 事件之间的主要区别
通话结束时,即使通话数据尚未准备好,也会立即触发 all.hungup 事件。此事件可用于构建实时仪表板和其他需要对通话终止做出快速反应的应用程序。
当收集到与通话相关的所有数据(例如通话记录文件、通话时长和其他详细信息)时,会触发 call.ended 事件。此事件通常在通话实际结束后约 30 秒触发。此事件可以将完整的通话数据存储在您的服务器上以供进一步处理或存档。
如何在 Aircall 中设置 webhook 触发器以实现无缝数据集成?
-
- Posts: 1
- Joined: Mon Dec 02, 2024 9:39 am