Zoom Webhook Integration

edit

Zoom Webhook Integration

edit

Version

1.21.0 (View all)

Compatible Kibana version(s)

8.13.0 or higher

Supported Serverless project types
What’s this?

Security
Observability

Subscription level
What’s this?

Basic

Level of support
What’s this?

Elastic

This integration creates an HTTP listener that accepts incoming webhook callbacks from Zoom.

To configure Zoom to send webhooks to this integration, please follow the Zoom Documentation.

The agent running this integration must be able to accept requests from the Internet in order for Zoom to be able connect. Zoom requires that the webhook accept requests over HTTPS. So you must either configure the integration with a valid TLS certificate or use a reverse proxy in front of the integration.

Compatibility

edit

This integration is compatible with the Zoom Platform API as of September 2020.

Exported fields
Field Description Type

@timestamp

Event timestamp.

date

cloud.image.id

Image ID for the cloud instance.

keyword

data_stream.dataset

Data stream dataset name.

constant_keyword

data_stream.namespace

Data stream namespace.

constant_keyword

data_stream.type

Data stream type.

constant_keyword

dataset.name

Dataset name.

constant_keyword

dataset.namespace

Dataset namespace.

constant_keyword

dataset.type

Dataset type.

constant_keyword

event.dataset

Event dataset

constant_keyword

event.module

Event module

constant_keyword

host.containerized

If the host is a container.

boolean

host.os.build

OS build information.

keyword

host.os.codename

OS codename, if any.

keyword

input.type

Input type.

keyword

zoom.account.account_alias

When an account alias is updated, this is the new value set

keyword

zoom.account.account_name

When an account name is updated, this is the new value set

keyword

zoom.account.account_support_email

When an account support_email is updated, this is the new value set

keyword

zoom.account.account_support_name

When an account support_name is updated, this is the new value set

keyword

zoom.account.email

Email related to the user the action was performed on

keyword

zoom.account.owner_email

Email of the user whose sub account was created/disassociated

keyword

zoom.account.owner_id

UserID of the user whose sub account was created/disassociated

keyword

zoom.account_id

Related accountID to the event

keyword

zoom.chat_channel.id

The ID of the channel that has been added/modified/deleted

keyword

zoom.chat_channel.name

The name of the channel that has been added/modified/deleted

keyword

zoom.chat_channel.type

Type of channel related to the event. Can be 1(Invite-Only), 2(Private) or 3(Public)

keyword

zoom.chat_message.channel_id

ChannelID related to the message

keyword

zoom.chat_message.channel_name

Channel name related to the message

keyword

zoom.chat_message.contact_email

Email address related to the user sending the message

keyword

zoom.chat_message.contact_id

UserID belonging to the user receiving a message

keyword

zoom.chat_message.id

Unique ID of the related chat message

keyword

zoom.chat_message.message

A string containing the full message that was sent

keyword

zoom.chat_message.session_id

SessionID for the channel related to the message

keyword

zoom.chat_message.type

Type of message, can be either "to_contact" or "to_channel"

keyword

zoom.creation_type

Creation type

keyword

zoom.master_account_id

Master Account related to a specific Sub Account

keyword

zoom.meeting.duration

The duration of a meeting in minutes

long

zoom.meeting.host_id

The UserID of the configured meeting host

keyword

zoom.meeting.id

Unique ID of the related meeting

keyword

zoom.meeting.issues

When a user reports an issue with the meeting, for example: "Unstable audio quality"

keyword

zoom.meeting.password

Password related to the meeting

keyword

zoom.meeting.start_time

Date and time the meeting started

date

zoom.meeting.timezone

Which timezone is used for the meeting timestamps

keyword

zoom.meeting.topic

Topic of the related meeting

keyword

zoom.meeting.type

Type of meeting created

keyword

zoom.meeting.uuid

The UUID of the related meeting

keyword

zoom.old_values

Includes the old values when updating a object like user, meeting, account or webinar

flattened

zoom.operator

Username/Email related to the user that triggered the event

keyword

zoom.operator_id

UserID that triggered the event

keyword

zoom.participant.id

Unique ID of the participant related to a meeting

keyword

zoom.participant.join_time

The date and time a participant joined a meeting

date

zoom.participant.leave_time

The date and time a participant left a meeting

date

zoom.participant.sharing_details.content

Type of content that was shared

keyword

zoom.participant.sharing_details.date_time

Timestamp the sharing started

keyword

zoom.participant.sharing_details.file_link

The file link that was shared

keyword

zoom.participant.sharing_details.link_source

Method of sharing with dropbox integration

keyword

zoom.participant.sharing_details.source

The file source that was share

keyword

zoom.participant.user_id

UserID of the participant related to a meeting

keyword

zoom.participant.user_name

Username of the participant related to a meeting

keyword

zoom.phone.answer_start_time

The date and time when the call was answered

date

zoom.phone.call_end_time

The date and time when the call ended

date

zoom.phone.call_id

Unique ID of the related call

keyword

zoom.phone.callee.device_type

Device type used by the callee related to the call

keyword

zoom.phone.callee.extension_number

Extension number of the callee related to the call

keyword

zoom.phone.callee.extension_type

Extension type of the callee number, can be user, callQueue, autoReceptionist or shareLineGroup

keyword

zoom.phone.callee.id

UserID of the callee related to the voicemail/call

keyword

zoom.phone.callee.name

The name of the related callee

keyword

zoom.phone.callee.number_type

The type of number, can be 1(Internal) or 2(External)

keyword

zoom.phone.callee.phone_number

Phone Number of the callee related to the call

keyword

zoom.phone.callee.timezone

Timezone of the callee related to the call

keyword

zoom.phone.callee.user_id

UserID of the related callee of a voicemail/call

keyword

zoom.phone.caller.device_type

Device type used by the caller

keyword

zoom.phone.caller.extension_number

Extension number of the caller

keyword

zoom.phone.caller.extension_type

Extension type of the caller number, can be user, callQueue, autoReceptionist or shareLineGroup

keyword

zoom.phone.caller.id

UserID of the caller related to the voicemail/call

keyword

zoom.phone.caller.name

The name of the related callee

keyword

zoom.phone.caller.number_type

The type of number, can be 1(Internal) or 2(External)

keyword

zoom.phone.caller.phone_number

Phone Number of the caller related to the call

keyword

zoom.phone.caller.timezone

Timezone of the caller

keyword

zoom.phone.caller.user_id

UserID of the person which initiated the call

keyword

zoom.phone.connected_start_time

The date and time when a ringtone was established to the callee

date

zoom.phone.date_time

Date and time of the related phone event

date

zoom.phone.download_url

Download URL for the voicemail

keyword

zoom.phone.duration

Duration of a voicemail in minutes

long

zoom.phone.id

Unique ID for the phone or conversation

keyword

zoom.phone.ringing_start_time

The timestamp when a ringtone was established to the callee

date

zoom.phone.user_id

UserID for the phone owner related to a Call Log being completed

keyword

zoom.recording.duration

Duration of the recording in minutes

long

zoom.recording.host_email

Email address of the host related to the meeting that was recorded

keyword

zoom.recording.host_id

UserID of the host of the meeting that was recorded

keyword

zoom.recording.id

Unique ID of the related recording

keyword

zoom.recording.recording_count

Number of recording files related to the recording

long

zoom.recording.recording_file.recording_end

The date and time the recording finished

date

zoom.recording.recording_file.recording_start

The date and time the recording started

date

zoom.recording.share_url

The URL to access the recording

keyword

zoom.recording.start_time

The date and time when the recording started

date

zoom.recording.timezone

The timezone used for the recording date

keyword

zoom.recording.topic

Topic of the meeting related to the recording

keyword

zoom.recording.total_size

Total size of the recording in bytes

long

zoom.recording.type

Type of recording, can be multiple type of values, please check Zoom documentation

keyword

zoom.recording.uuid

UUID of the related recording

keyword

zoom.registrant.address

Address of the user registering to a meeting or webinar

keyword

zoom.registrant.city

City of the user registering to a meeting or webinar

keyword

zoom.registrant.comments

Comments left by the user registering to a meeting or webinar

keyword

zoom.registrant.country

Country of the user registering to a meeting or webinar

keyword

zoom.registrant.email

Email of the user registering to a meeting or webinar

keyword

zoom.registrant.first_name

First name of the user registering to a meeting or webinar

keyword

zoom.registrant.id

Unique ID of the user registering to a meeting or webinar

keyword

zoom.registrant.industry

Related industry of the user registering to a meeting or webinar

keyword

zoom.registrant.job_title

Job title of the user registering to a meeting or webinar

keyword

zoom.registrant.join_url

The URL that the registrant can use to join the webinar

keyword

zoom.registrant.last_name

Last name of the user registering to a meeting or webinar

keyword

zoom.registrant.no_of_employees

Number of employees choosen by the user registering to a meeting or webinar

keyword

zoom.registrant.org

Organization related to the user registering to a meeting or webinar

keyword

zoom.registrant.phone

Phone number of the user registering to a meeting or webinar

keyword

zoom.registrant.purchasing_time_frame

Choosen purchase timeframe of the user registering to a meeting or webinar

keyword

zoom.registrant.role_in_purchase_process

Choosen role in a purchase process related to the user registering to a meeting or webinar

keyword

zoom.registrant.state

State of the user registering to a meeting or webinar

keyword

zoom.registrant.status

Status of the specific user registration

keyword

zoom.registrant.zip

Zip code of the user registering to a meeting or webinar

keyword

zoom.settings

The current active settings related to a object like user, meeting, account or webinar

flattened

zoom.sub_account_id

Related Sub Account

keyword

zoom.timestamp

Timestamp related to the event

date

zoom.user.client_type

Type of client used by the user. Can be browser, mac, win, iphone or android

keyword

zoom.user.company

User company related to the user event

keyword

zoom.user.dept

The configured departement for the user

keyword

zoom.user.email

User email related to the user event

keyword

zoom.user.first_name

User first name related to the user event

keyword

zoom.user.host_key

Host key set for the user

keyword

zoom.user.id

UserID related to the user event

keyword

zoom.user.language

Language configured for the user

keyword

zoom.user.last_name

User last name related to the user event

keyword

zoom.user.personal_notes

Personal notes for the User

keyword

zoom.user.phone_country

User country code related to the user event

keyword

zoom.user.phone_number

User phone number related to the user event

keyword

zoom.user.pic_url

Full URL to the profile picture used by the user

keyword

zoom.user.pmi

User personal meeting ID related to the user event

keyword

zoom.user.presence_status

Current presence status of user

keyword

zoom.user.role

The configured role for the user

keyword

zoom.user.timezone

Timezone configured for the user

keyword

zoom.user.type

User type related to the user event

keyword

zoom.user.use_pmi

If a user has PMI enabled

boolean

zoom.user.vanity_name

Name of the personal meeting room related to the user event

keyword

zoom.user.version

Version of the client used by the user

keyword

zoom.webinar.agenda

The configured agenda of the webinar

keyword

zoom.webinar.duration

Duration of the webinar in minutes

long

zoom.webinar.host_id

UserID for the configured host of the webinar

keyword

zoom.webinar.id

Unique ID for the related webinar

keyword

zoom.webinar.issues

Any reported issues about a webinar is reported in this field

keyword

zoom.webinar.join_url

The URL configured to join the webinar

keyword

zoom.webinar.password

Password configured to access the webinar

keyword

zoom.webinar.start_time

The date and time when the webinar started

date

zoom.webinar.timezone

Timezone used for the dates related to the webinar

keyword

zoom.webinar.topic

Meeting topic of the related webinar

keyword

zoom.webinar.type

Type of webinar created. Can be either 5(Webinar), 6(Recurring webinar without fixed time) or 9(Recurring webinar with fixed time)

keyword

zoom.webinar.uuid

UUID for the related webinar

keyword

zoom.zoomroom.alert_kind

An integer value showing if the Zoom room alert has been either 1(Triggered) or 2(Cleared)

keyword

zoom.zoomroom.alert_type

An integer value representing the type of alert. The list of alert types can be found in the Zoom documentation

keyword

zoom.zoomroom.calendar_id

Unique ID of the calendar used by the Zoom room

keyword

zoom.zoomroom.calendar_name

Calendar name of the Zoom room

keyword

zoom.zoomroom.change_key

Key used by Microsoft products integration that represents a specific version of a calendar

keyword

zoom.zoomroom.component

An integer value representing the type of equipment or component, The list of component types can be found in the Zoom documentation

keyword

zoom.zoomroom.email

Email address associated with the Zoom room itself

keyword

zoom.zoomroom.event_id

Unique ID of the calendar event associated with the Zoom Room

keyword

zoom.zoomroom.id

Unique ID of the Zoom room

keyword

zoom.zoomroom.issue

Any reported alerts or issues related to the Zoom room or its equipment

keyword

zoom.zoomroom.resource_email

Email address associated with the calendar in use by the Zoom room

keyword

zoom.zoomroom.room_name

The configured name of the Zoom room

keyword

Changelog

edit
Changelog
Version Details Kibana version(s)

1.21.0

Enhancement (View pull request)
Add "preserve_original_event" tag to documents with event.kind set to "pipeline_error".

8.13.0 or higher

1.20.1

Bug fix (View pull request)
Use triple-brace Mustache templating when referencing variables in ingest pipelines.

8.13.0 or higher

1.20.0

Enhancement (View pull request)
Update the kibana constraint to ^8.13.0. Modified the field definitions to remove ECS fields made redundant by the ecs@mappings component template.

8.13.0 or higher

1.19.0

Enhancement (View pull request)
Set sensitive values as secret.

8.12.0 or higher

1.18.1

Bug fix (View pull request)
Fix ingest pipeline conditional field handling.

8.9.0 or higher

1.18.0

Enhancement (View pull request)
ECS version updated to 8.11.0.

8.9.0 or higher

1.17.0

Enhancement (View pull request)
ECS version updated to 8.10.0.

8.9.0 or higher

1.16.0

Enhancement (View pull request)
The format_version in the package manifest changed from 2.11.0 to 3.0.0. Removed dotted YAML keys from package manifest. Added owner.type: elastic to package manifest.

8.9.0 or higher

1.15.0

Enhancement (View pull request)
Add tags.yml file so that integration’s dashboards and saved searches are tagged with "Security Solution" and displayed in the Security Solution UI.

8.9.0 or higher

1.14.0

Enhancement (View pull request)
Update package to ECS 8.9.0.

8.9.0 or higher

1.13.0

Enhancement (View pull request)
Update package to pkg-spec 2.9.0 and fix setting of event.type creation.

8.9.0 or higher

1.12.0

Enhancement (View pull request)
Ensure event.kind is correctly set for pipeline errors.

8.9.0 or higher

1.11.0

Enhancement (View pull request)
Update package to ECS 8.8.0.

8.9.0 or higher

1.10.0

Enhancement (View pull request)
Make CRC validation configurable.

8.9.0 or higher

1.9.0

Enhancement (View pull request)
Add CRC validation support.

8.9.0 or higher

1.8.0

Enhancement (View pull request)
Update package to ECS 8.7.0.

7.14.0 or higher
8.0.0 or higher

1.7.1

Enhancement (View pull request)
Added categories and/or subcategories.

7.14.0 or higher
8.0.0 or higher

1.7.0

Enhancement (View pull request)
Update package to ECS 8.6.0.

7.14.0 or higher
8.0.0 or higher

1.6.0

Enhancement (View pull request)
Update package to ECS 8.5.0.

7.14.0 or higher
8.0.0 or higher

1.5.0

Enhancement (View pull request)
Update package to ECS 8.4.0

7.14.0 or higher
8.0.0 or higher

1.4.1

Enhancement (View pull request)
Update package name and description to align with standard wording

7.14.0 or higher
8.0.0 or higher

1.4.0

Enhancement (View pull request)
Update package to ECS 8.3.0.

7.14.0 or higher
8.0.0 or higher

1.3.1

Bug fix (View pull request)
Fix content-type handling.

7.14.0 or higher
8.0.0 or higher

1.3.0

Enhancement (View pull request)
Update to ECS 8.2

1.2.1

Enhancement (View pull request)
Add documentation for multi-fields

7.14.0 or higher
8.0.0 or higher

1.2.0

Enhancement (View pull request)
Update to ECS 8.0

7.14.0 or higher
8.0.0 or higher

1.1.0

Enhancement (View pull request)
Add 8.0.0 version constraint

7.14.0 or higher
8.0.0 or higher

1.0.3

Enhancement (View pull request)
Uniform with guidelines

7.14.0 or higher

1.0.2

Enhancement (View pull request)
Update Title and Description.

1.0.1

Bug fix (View pull request)
Fix logic that checks for the forwarded tag

1.0.0

Enhancement (View pull request)
make GA

0.6.0

Enhancement (View pull request)
Update to ECS 1.12.0

0.5.1

Enhancement (View pull request)
update to ECS 1.11.0

0.5.0

Enhancement (View pull request)
Update integration description

0.4.0

Enhancement (View pull request)
Set "event.module" and "event.dataset"

0.3.1

Enhancement (View pull request)
update to ECS 1.9.0

0.3.0

Enhancement (View pull request)
Add changes to use ECS 1.8 fields.

0.1.0

Enhancement (View pull request)
initial release