4 Provisioning and Managing Social Voice Communicator Services

This chapter explains how to provision and manage Oracle Communications Service Broker Social Voice Communicator (SVC) subscriber services data.

About the SVC API

You use the SVC RESTful API to create, provision, configure, and manage the SVC services that you offer to your subscribers.

You typically create a self-administered web portal (or add to an existing portal) that you subscribers use to self-administer their accounts. You can design the user portal any way that meets your requirements, using any tools at your disposal, if they can use the RESTful API.

About Creating Subscriber Accounts with the SVC API

Before subscribes can access their accounts and access SVC services, an administrator must create their accounts. The SVC API operations, including the "Creating Accounts and Services by Using the SVC API" operation, operate on one record at a time.

Your administrator may need to create or alter multiple accounts at the same time, for example to:

• Create accounts to have ready for your subscribers to configure.

• Make large-scale changes to your SVC subscriber base for changes in policy.

• Load a test database full of accounts to test new functionality.

Administrators use the Service Broker Batch Loader program to create or alter groups of SVC subscriber accounts. See "Provisioning Multiple Accounts by Using the Batch Loader Tools" for more information.

Understanding the SVC Data Model

Figure 4-1 shows the SVC data objects and their relationships.

Figure 4-1 SVC Data Model

Description of "Figure 4-1 SVC Data Model"

Creating Accounts and Services by Using the SVC API

SVC is designed primarily to allow subscribers to administer their own accounts individually once you set up a user portal with the API operations. Your administration staff can also use these operations on individual subscriber accounts. The following sections explains the available API operations.

Managing Subscriber Accounts for SVC Services

Perform operations in Table 4-1 to create, change, or delete SVC subscriber accounts for all SVC services.

Table 4-1 Subscriber Account Management Operations

Operation	Description
Create Subscriber Accounts	Creates subscriber accounts. Administrator-only.
Modify a Subscriber Password or Social Circle One Number Preference	Changes subscriber account details.
Delete a Subscriber Account	Removes a subscriber account from the database.
Get Subscriber Accounts	Returns a list of all subscriber account names and locations. Administrator-only.
Get Subscriber Account Details	Returns all details for a subscriber account.

Managing Subscriber Account Personal Contacts

Perform the operations in Table 4-2 to add, change, delete, or obtain information for personal contacts.

Table 4-2 Managing Personal Contact Operations

Operation	Description
Create Personal Contacts in a Subscriber Account	Populates a subscriber's account with the personal contacts contained in the array submitted with this operation.
Modify a Personal Contact Details and/or Default Status	Modifies a personal contact with the new status (toggles default on or off) and number that you submit with this operation.
Get a Subscriber's Personal Contact List	Returns an array of personal contact names and access URIs for a subscriber.
Get a Personal Contact and its Default Status	Returns the personal contact number and status (default or not) for a single personal contact.
Delete a Social Circle Contact	Deletes the personal contact that you submit with this operation.
Delete All Personal Contacts	Removes all personal contacts for a subscriber.

Managing Subscriber Personal Social Circle Accounts

Perform the operations in Table 4-3 to manage the SVC Social Circle one numbers and the routing policy rules for those numbers.

Table 4-3 Social Voice Service Management API Operations

Operation	Description
Create a Social Circle One Number	Adds an SVC Social Voice service to a subscriber account. Administrator-only.
Get All Social Circle One Number Contacts for a Subscriber	Retrieves the list of SVC Social Voice contacts for a subscriber's SVC Social Circle.
Get Details for a Social Circle Contact	Retrieves the SVC Social Voice name, type (group or personal), and any policies applied to a SVC Social Voice contact.
Delete a Social Circle Contact	Removes a SVC Social Voice service from a subscriber's account.
Delete All Social Circle Contacts	Removes all SVC Social Voice contacts for a subscriber's account.
Create a Policy Rule for a Social Circle Contact	Applies call routing policies to a single SVC Social Voice contact, that are based on the time of day and day of week.
Get a Social Circle Policy Rule Details	Retrieves details of a policy object.
Modify a Social Circle Policy Rule	Makes changes to a subscriber's SVC Social Voice policy, by replacing the policy object in the database.
Delete a Social Circle Policy Rule	Removes a SVC Social Circle policy rule.

Managing Public and Private Groups

Each SVC Social Voice account can have any number of group and group members. There are two types of groups: public, which any subscriber can join, and private, which can be more exclusive. Typical private groups include family and friends; typical public groups include sports teams or hobby clubs. Two default groups are supplied: personal and business. Use the operations Table 4-4 to administer SVC Social Voice private groups, and the operations in Table 4-5 to administer SVC Social Voice public groups.

Table 4-4 Social Voice Private Group Management Operations

Operation	Description
Create a Private Group	Adds a SVC Social Voice private group to a subscriber's account.
Add a Private Group Contact	Adds a new member to a private group.
Get All Private Group Memberships for a Subscriber	Returns details for all private groups that a subscriber owns or is a member of.
Get Private Group Details	Sets the name, SVC Social Voice group number, and URI of a subscriber's contact group.
Modify a Private Group's One Number	Changes a private group's one number value.
Get All Contacts for a Private Group	Returns an array of private group member.
Get Details for a Private Group Contact	Returns the name, number, and active status for a private group member.
Modify a Private Group Contact	Changes a private group contact details.
Delete a Private Group Contact	Removes a subscriber from a private group.
Delete a Private Group	Deletes a contact group and all its members from a subscriber's account.

Table 4-5 Social Voice Public Group Management

Operation	Description
Create a Public Group	Creates an SVC Social Voice public group.
Add a Public Group Member	Adds a member to a Social Voice public group.
Delete a Public Group Contact	Removes a member from a public group.
Get All Public Groups for a Subscriber	Returns an array of the types, URIs, and names of all groups that a subscriber owns.
Get All Public Group Memberships for a Subscriber	Returns an array of all group names and group owners that a subscriber is a member of.
Get All Contacts for a Public Group	Returns an array of the active status, name, contact name, contact number, and group type for each contact in a public group.
Delete a Public Group	Removes an SVC Social Voice public group.

Making a Click-to-Dial Call

Perform the "Make a Click-to-dial Call" operation to initiate a call from a web interface.

Note that ACR messages are sent after the call is connected, rather than before.

Managing Social Voicemail Access

Each SVC subscriber is eligible for access to a voice-mail system. Perform the operations in Table 4-6 to manage voice-mail access.

See "Configuring Voice-Mail for SVC Services" for details on configuring SVC voice-mail services.

Table 4-6 Voice-Mail Subscriber Management Operations

Operation	Description
Activate Social Voicemail for Subscribers	Grants subscribers access to SVC Social Voicemail features.
Activate/Deactivate Social Voicemail Access	Adds or removes SVC Social Voicemail access for a subscriber, but does not affect the subscriber's data. This operation is intended for temporary service suspension. Administrator-only. To permanently remove a voice-mail access perform the "Delete Social Voicemail Access and Data for a Social Circle" operation.
Delete Social Voicemail Access and Data for a Social Circle	Deactivates a subscriber's SVC Social Voicemail access and removes all data. This operation permanently removes voice-mail access and data. Administrator-only. To temporarily suspend voice-mail access, perform the "Activate/Deactivate Social Voicemail Access" operation.
Get All Social Voicemail Subscriber Accounts	Returns a list of all SVC Social Voicemail accounts and their status (active/inactive). Administrator-only.

Managing Social Voicemail Service

After granting access to SVC Social Voicemail services, perform the operations in Table 4-7 to manage subscriber's SVC Social Voicemail services.

Table 4-7 Voice-Mail Box Management Operations

Operation	Description
Get Social Voicemail Settings	Changes the SVC Social Voicemail settings.
Delete a Social Voicemail Personal Greeting Message	Deletes the personal greeting WAV file. The default greeting file is used instead.
Modify Social Voicemail Message Public/Private Setting	Sets a voice-mail message as either public or private.
Deactivate a Social Voicemail Name Message	Deactivates a name message WAV file.
Get Social Voicemail Message Settings	Returns the voice-mailbox settings, such as password, maximum number of allowed messages, and so on.
Get Social Voicemail Name Message Settings	Returns the location and status of a a subscriber's voice name message WAV file.
Create Social Voicemail Greeting Message	Sets a WAV file as the personalgreeting.wav file in a subscriber's greeting folder.
Create Social Voicemail Box Name Message	Sets a WAV file as a voice-mailbox name message.

Managing Social Voicemail Messages

Perform the operations in Table 4-8 to manage SVC Social Voicemail messages.

Table 4-8 Voice-Mail Message Management Operations

Operation	Description
Delete a Social Voicemail Message	Removes a voice-mail message.
Get a List of Social Voicemail Messages	Retrieves a list of voice-mail messages.
Get a Social Voicemail Message File	Retrieves the WAV file containing a voice-mail message.
Get Details for a Social Voicemail Message	Retrieves the message type, date and time created, caller name and number, file location, and public/private setting for a voice-mail message.
Get Personal Greeting Message Settings	Retrieves the location and status of a voice-mailbox greeting message.
Send a Social Voicemail Message to Other Subscribers	Sends a voice-mail message from one subscriber to another.
Create sentMessage Voice Message	Uploads a WAV file.
Get a List of the Public Social Voicemail Messages in a Mailbox	Retrieves a list of the publicly-accessible voice-mail message in a subscriber's mailbox.

Provisioning Multiple Accounts by Using the Batch Loader Tools

The SVC API creates or alters records in one account at a time, often by the subscribers themselves. During the course of creating or administering your SVC implementation, you will probably need to create or alter multiple accounts at the same time.

You use the Service Broker batch loader tools to make bulk changes to multiple SVC accounts in the same database at the same time. For more information, see the discussion on using the batch operation tools in Oracle Communications Service Broker VPN Implementation Guide.

The batch loader tools require system administration-level permission to use, and require you to specify the user name and password of an API administrator. The program is located in Oracle_home/ocsb61/admin_server/utils/bulkloader.

The batch loader tools accept input in the form of comma-separated value files.

See "Batch Loader SVC Data Files" for more information on the input data files.