conferencecall

Conferencecall

{
    "id": "<string>",
    "customer_id": "<string>",
    "conference_id": "<string>",
    "reference_type": "<string>",
    "reference_id": "<string>",
    "status": "<string>",
    "tm_create": "<string>",
    "tm_update": "<string>",
    "tm_delete": "<string>"
}

id (UUID): The conferencecall’s unique identifier. Returned when a participant joins a conference or when listing via GET /conferencecalls.
customer_id (UUID): The customer who owns this conferencecall. Obtained from GET /customers.
conference_id (UUID): The conference this participant belongs to. Obtained from GET /conferences.
reference_type (enum string): The type of the referenced resource. See Reference type.
reference_id (UUID): The ID of the referenced resource (e.g., a call ID). Obtained from GET /calls/{id} when reference_type is call.
status (enum string): The conferencecall’s current status. See Status.
tm_create (String, ISO 8601): Timestamp when the conferencecall was created.
tm_update (String, ISO 8601): Timestamp of the last update to any conferencecall property.
tm_delete (String, ISO 8601): Timestamp when the conferencecall was deleted.

Note

AI Implementation Hint

Timestamps set to 9999-01-01 00:00:00.000000 indicate the event has not yet occurred. For example, tm_delete with this value means the participant record still exists. To remove a participant from a conference, use DELETE /conferencecalls/{id}.

Example

{
    "id": "b8aa51f6-5cc1-40ba-9737-45ca24dab153",
    "customer_id": "5e4a0680-804e-11ec-8477-2fea5968d85b",
    "conference_id": "99accfb7-c0dd-4a54-997d-dd18af7bc280",
    "reference_type": "call",
    "reference_id": "7cb70145-a20a-4070-8b23-9131410d301d",
    "status": "leaved",
    "tm_create": "2022-08-06 16:57:12.247946",
    "tm_update": "2022-08-06 19:09:47.349667",
    "tm_delete": "9999-01-01 00:00:00.000000"
}

Reference type

The type of resource participating in the conference (enum string).

Type	Description
call	The participant is a call. The `reference_id` is a call ID obtainable from `GET /calls`.

Status

The conferencecall’s current status (enum string). States only move forward, never backward.

Status	Description
joining	The call is connecting to the conference. Pre-conference flow actions may be executing (e.g., greeting message).
joined	The call is active in the conference. Audio is flowing. The participant can hear and speak with others.
leaving	The call is being disconnected from the conference. Triggered by hangup or `DELETE /conferencecalls/{id}`.
leaved	The call has fully left the conference. This is the final state. No further changes are possible.