Developer Garden REST API  4.0
 All Pages
Introduction

The Conference Call service enables program-controlled setting up of phone conferences. Conferences can be started immediatelly or scheduled to a specific time.

It is possible to query the state of a conference at any time, as well as adding, removing or muting participants.

Workflow Diagram

The following diagram shows a common sequence of calls to start, manage and stop a conference.

confcall_workflow.png
Workflow while Managing a Conference

Dial Modes

The dial mode specifies if the call is initiated by the service (dial out) or if the participant has to call on his/her own (dial in). It is set per participant and thus different dial modes in the same conference are supported.

In the latter case, the dial-in number is always +49 6151 8004030 (German landline).

A conference definition contains two 6 to 10 digit PINs:

  • an initiator PIN and
  • a (different) participant PIN.

If PINs are not provided during creation, the service auto-generates random numbers, that are returned in the conference's status subsequently.

The Conference Call service first tries to identify the right conference for a dialing in person by his/her caller ID. If this does not work the caller is asked to provide a PIN, which is then used to find out to which conference the person belongs and as which role he/she should take part. Please note, that it is thus not possible to use the same PIN for different conferences or roles.