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.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:c3a85336d4e5e2ba401facd5f59d077f97bdbeba0bfa7e50747ab88523664963
Published
2026-11-10T10:12:38Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/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

Reference at this version

oci://hub.aggrega.ai/component/core/messaging/vonage:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
modalitystring (voice)voicenoWhich 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.
directionstring (outbound | inbound | bidirectional)outboundnoWhether the application originates calls, answers them, or both.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
endpointstringhttps://api.nexmo.comno—
answer_urlstring—yesThe 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_urlstring—yesThe address the carrier posts call events to.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
endpointstring—yesBase 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_urlstring—yesAddress 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_urlstring—yesAddress 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.
modalitystring—yesWhich 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.
directionstring—yesWhether 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 sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

SlotSelectorRequiredInjectSensitiveDescription
api_keyfeature.aggrega.ai/kind=secretnoenvyesThe API key half of the credential pair the carrier authenticates a request with.
api_secretfeature.aggrega.ai/kind=secretnoenvyesThe API secret half of the credential pair the carrier authenticates a request with.
signature_secretfeature.aggrega.ai/kind=secretnoenvyesThe 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.

Self-inject allowlist

No self-inject pipes declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

This entity uses nothing in the catalog.

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy