Component
core/messaging/vonage
A voice carrier reached over Vonage's Voice API, so an application places and answers calls without operating telephony infrastructure. The modality is calls; the developer names the direction, outbound, inbound or both. The operator supplies the API base address and the two addresses the carrier calls back on, for instructions and for events. Wire here rather than to a broker: a broker delivers inside the Release, a carrier onto the public telephone network. Consumers read the base address, both callback addresses, the modality and direction. Realized by reference: no compute runs here.
来源
- 内容摘要
- sha256:c3a85336d4e5e2ba401facd5f59d077f97bdbeba0bfa7e50747ab88523664963
- 发布时间
- 2026-11-10T10:12:38Z
- 签名身份
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
签名
- 官方application/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:86ea32ef8aa26b4fed6096423b210e53ff59d97c4715aefa4dda5b88b2e60055
此版本的引用
oci://hub.aggrega.ai/component/core/messaging/vonage:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| modality | string (voice) | voice | 否 | Which of the carrier's channels this wiring addresses. Pinned to calls, because the webhook contract and the credential shape declared here are the Voice API's. |
| direction | string (outbound | inbound | bidirectional) | outbound | 否 | Whether the application originates calls, answers them, or both. |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| endpoint | string | https://api.nexmo.com | 否 | — |
| answer_url | string | — | 是 | The address the carrier fetches a call's instructions from, read when the application places a call and when the carrier answers one on its behalf. |
| event_url | string | — | 是 | The address the carrier posts call events to. |
输出契约
此组件通过 uses 拓扑向使用方发布的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| endpoint | string | — | 是 | Base URL of the carrier's Voice API an application calls to place a call. The Release supplies it, so an operator may point it at a different host without the application changing. |
| answer_url | string | — | 是 | Address the carrier fetches a call's instructions from. A consumer must serve that address itself, so it reads this to know which of its own routes the carrier will call. |
| event_url | string | — | 是 | Address the carrier posts call events to. A consumer must serve that address itself, so it reads this to know where its own event handler has to answer. |
| modality | string | — | 是 | Which of the carrier's channels this wiring addresses, carried through from the value the Aggregate declared. A consumer reads it to pick the request shape it sends. |
| direction | string | — | 是 | Whether the application originates calls on this wiring, answers them, or both, carried through from the value the Aggregate declared. A consumer reads it to know whether it must also stand up an answering path. |
uses 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
未声明 uses 套接字。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
| 槽位 | 选择器 | 必需 | 注入 | 敏感 | 描述 |
|---|---|---|---|---|---|
| api_key | feature.aggrega.ai/kind=secret | 否 | env | 是 | The API key half of the credential pair the carrier authenticates a request with. |
| api_secret | feature.aggrega.ai/kind=secret | 否 | env | 是 | The API secret half of the credential pair the carrier authenticates a request with. |
| signature_secret | feature.aggrega.ai/kind=secret | 否 | env | 是 | The separate secret the carrier signs an inbound webhook with, which the application verifies the signature against. Distinct from the API secret and not interchangeable with it. |
自注入允许列表
未声明自注入管道。
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
此实体未使用目录中的任何内容。
被使用
实现
实现