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
- Empreinte du contenu
- sha256:c3a85336d4e5e2ba401facd5f59d077f97bdbeba0bfa7e50747ab88523664963
- Publié
- 2026-11-10T10:12:38Z
- Identité de signature
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officielapplication/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
Référence à cette version
oci://hub.aggrega.ai/component/core/messaging/vonage:1.0.0Paramètres du développeur
Valeurs que le développeur définit dans l’Aggregate.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| modality | string (voice) | voice | non | 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 | non | Whether the application originates calls, answers them, or both. |
Dimensionnement de l’opérateur
Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| endpoint | string | https://api.nexmo.com | non | — |
| answer_url | string | — | oui | 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 | — | oui | The address the carrier posts call events to. |
Contrat de sortie
Valeurs que ce composant publie vers les consommateurs via la topologie uses.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| endpoint | string | — | oui | 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 | — | oui | 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 | — | oui | 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 | — | oui | 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 | — | oui | 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
Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.
Aucun socket uses déclaré.
Emplacements d’attache
Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.
| Emplacement | Sélecteur | Obligatoire | Injection | Sensible | Description |
|---|---|---|---|---|---|
| api_key | feature.aggrega.ai/kind=secret | non | env | oui | The API key half of the credential pair the carrier authenticates a request with. |
| api_secret | feature.aggrega.ai/kind=secret | non | env | oui | The API secret half of the credential pair the carrier authenticates a request with. |
| signature_secret | feature.aggrega.ai/kind=secret | non | env | oui | 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. |
Liste d’autorisation d’auto-injection
Aucun canal d’auto-injection déclaré.
Relations
Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.
Utilise
Cette entité n’utilise rien du catalogue.
Utilisé par
implémente
implémente