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 может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности 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. |
Список разрешённых самовнедрений
Каналы самовнедрения не объявлены.
Связи
Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.
Использует
Эта сущность ничего не использует из каталога.
Используется в
реализует
реализует