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.
Proveniência
- Digest do conteúdo
- sha256:c3a85336d4e5e2ba401facd5f59d077f97bdbeba0bfa7e50747ab88523664963
- Publicado
- 2026-11-10T10:12:38Z
- Identidade de assinatura
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Assinatura
- Oficialapplication/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
Referência nesta versão
oci://hub.aggrega.ai/component/core/messaging/vonage:1.0.0Parâmetros do programador
Valores que o programador define no Aggregate.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| modality | string (voice) | voice | não | 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 | não | Whether the application originates calls, answers them, or both. |
Dimensionamento do operador
Dimensionamento da infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| endpoint | string | https://api.nexmo.com | não | — |
| answer_url | string | — | sim | 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 | — | sim | The address the carrier posts call events to. |
Contrato de saída
Valores que este componente publica para os consumidores através da topologia uses.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| endpoint | string | — | sim | 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 | — | sim | 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 | — | sim | 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 | — | sim | 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 | — | sim | 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. |
Sockets uses
Os sockets de dependência através dos quais este componente se liga. O destino de cada ligação estabelecida através de um socket tem de satisfazer o respetivo seletor de etiquetas, e cada ligação pode transportar um acoplamento nos slots que o socket declara. Cada ligação que o Aggregate ou a Release estabelece através do socket tem de preencher os slots obrigatórios.
Nenhum socket uses declarado.
Slots de acoplamento
Pontos de vinculação com nome nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual a Feature que o pode preencher, e a respetiva lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório tem de estar vinculado em cada instância, por um acoplamento na instância ou num âmbito acima dela, e um slot sensível é declarado para tratar material secreto. Uma Feature também se pode acoplar com um nome que nenhum slot declara.
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| api_key | feature.aggrega.ai/kind=secret | não | env | sim | The API key half of the credential pair the carrier authenticates a request with. |
| api_secret | feature.aggrega.ai/kind=secret | não | env | sim | The API secret half of the credential pair the carrier authenticates a request with. |
| signature_secret | feature.aggrega.ai/kind=secret | não | env | sim | 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. |
Lista de autorizações de autoinjeção
Nenhum canal de autoinjeção declarado.
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.
Usa
Esta entidade não usa nada do catálogo.
Usado por
implementa
implementa