Cisco Unity Connection Notification Interface (CUNI) API

From DocWiki

(Difference between revisions)
Jump to: navigation, search
m (1 revision)
(Introduction)
(2 intermediate revisions not shown)
Line 3: Line 3:
|align="center"|'''CUNI Guide Contents'''
|align="center"|'''CUNI Guide Contents'''
|-
|-
-
|[[Cisco Unity Connection Notification Interface (CUNI) API|API Overview ]]<br>[[Cisco Unity Connection Notification Interface (CUNI) API -- CUNI Event Schema|CUNI Event Schema]]<br>[[Cisco Unity Connection Notification Interface (CUNI) API -- Subscribing to and Processing Notification Events|Subscribing to and Processing Notification Events]]
+
|[[Cisco Unity Connection Notification Interface (CUNI) API|API Overview ]]<br>[[Cisco Unity Connection Notification Interface (CUNI) API -- CUNI Event Schema|CUNI Event Schema]]<br>[[Cisco Unity Connection Notification Interface (CUNI) API -- Subscribing to and Processing Notification Events|Subscribing to and Processing Notification Events]]<br>[[Cisco Unity Connection Notification Interface (CUNI) API -- CUNI FAQs|CUNI FAQs]]
|}
|}
Line 19: Line 19:
* Subscribe for message events
* Subscribe for message events
* Subscribe for one or many users on a single channel
* Subscribe for one or many users on a single channel
 +
 +
Note: All the above functions associated with CUNI API&nbsp;support both the IPv4 and IPv6 addresses. However, the IPv6 address works only when Connection platform is configured in Dual (IPv4/IPv6) mode.
 +
 +
For more information see the chapter “Adding or Changing the IPv6 Addresses of Cisco Unity Connection 8.5 and Later Servers” at the following link [http://www.cisco.com/en/US/docs/voice_ip_comm/connection/8x/upgrade/guide/9xcucrug051.html http://www.cisco.com/en/US/docs/voice_ip_comm/connection/9x/upgrade/guide/9xcucrug051.html].
 +
Note that CUNI is intended for use in server-to-server applications where receiving notifications for many users over a single connection is required. As such, it is designed to handle a small number of clients that are each subscribing for notifications on a large set of subscribers. It also requires Administrative credentials, making it inappropriate for browser applications to use directly.
Note that CUNI is intended for use in server-to-server applications where receiving notifications for many users over a single connection is required. As such, it is designed to handle a small number of clients that are each subscribing for notifications on a large set of subscribers. It also requires Administrative credentials, making it inappropriate for browser applications to use directly.
CUNI is composed of two parts: a SOAP interface for subscribing, and an asynchronous piece (the Notifier) that delivers events as XML over HTTP.
CUNI is composed of two parts: a SOAP interface for subscribing, and an asynchronous piece (the Notifier) that delivers events as XML over HTTP.
-
 
== Technical Details ==
== Technical Details ==
Line 62: Line 66:
[[Cisco Unity Connection APIs -- Troubleshooting |Troubleshooting (applies to all Connection APIs)]]
[[Cisco Unity Connection APIs -- Troubleshooting |Troubleshooting (applies to all Connection APIs)]]
 +
[[Category:Cisco Unity Connection Notification Interface (CUNI) API]]
[[Category:Cisco Unity Connection Notification Interface (CUNI) API]]

Revision as of 10:44, 27 November 2012

Links to Other API pages: Cisco_Unity_Connection_APIs

CUNI Guide Contents
API Overview
CUNI Event Schema
Subscribing to and Processing Notification Events
CUNI FAQs

Contents


Introduction

The Cisco Unity Connection Notification Interface (CUNI) API is a web service interface for managing subscriptions to events from Cisco Unity Connection systems. It provides a way to get asynchronous notifications when voice mail messages are received, deleted, or changed. CUNI can be used to integrate Connection into an existing enterprise-wide portal.

CUNI is designed to provide a simple, stable method of accessing the notification functionality on Connection systems through a standards based interface using XML and HTTPS.

Through CUNI, you can do the following:

  • Subscribe for message events
  • Subscribe for one or many users on a single channel

Note: All the above functions associated with CUNI API support both the IPv4 and IPv6 addresses. However, the IPv6 address works only when Connection platform is configured in Dual (IPv4/IPv6) mode.

For more information see the chapter “Adding or Changing the IPv6 Addresses of Cisco Unity Connection 8.5 and Later Servers” at the following link http://www.cisco.com/en/US/docs/voice_ip_comm/connection/9x/upgrade/guide/9xcucrug051.html.


Note that CUNI is intended for use in server-to-server applications where receiving notifications for many users over a single connection is required. As such, it is designed to handle a small number of clients that are each subscribing for notifications on a large set of subscribers. It also requires Administrative credentials, making it inappropriate for browser applications to use directly.

CUNI is composed of two parts: a SOAP interface for subscribing, and an asynchronous piece (the Notifier) that delivers events as XML over HTTP.

Technical Details

  • CUNI is standards-based: it implements a standard SOAP-based interface for managing subscriptions. Message events are sent as standard XML over HTTP.
  • CUNI is easy to use: as a web-based interface, CUNI is independent of operating systems and programming languages, and does not require any client libraries to use.


Getting Started with CUNI

In order to begin developing with CUNI, you need to obtain the following:

Hardware

Software

  • Cisco Unity Connection Software Ordering
  • Not for Resale Kits (Must for eligible to purchase)
  • Select Unified Communications System Release Kit

Discounts for some of the above hardware and software may be available for participants in the Cisco Technology Developer Program.

We recommend that all developers have an up-to-date Cisco Developer Services support agreement. This provides the developer with access to professional support and assistance for application development.

Other CUNI Resources

Additional information about CUNI is also available on the Cisco Developer Network (link to CDN). Note, however, that the documentation here on the DocWiki is the most up-to-date documentation available for CUNI.

To participate in the CUNI forum, see the CUNI forum on CDN.


Troubleshooting

See the following for information on troubleshooting all Connection APIs:

Troubleshooting (applies to all Connection APIs)

Rating: 0.0/5 (0 votes cast)

Personal tools