How-to guide

Easy Steps to Integrate Video Call on Your Website

Q: What credentials do I need to access the API endpoint?

Once you create a Digital Samba account, you’ll get a Team ID, Developer Key, and API Key — all required to use our video call API.

Q: Can I use Digital Samba in an HTML5-based hybrid app?

Yes. Digital Samba supports integration into HTML5 hybrid apps, making it ideal for modern mobile frameworks like Ionic, Cordova, and Capacitor.

by Digital Samba

15 min read

January 22, 2024

Adding video conferencing to your website is no longer a luxury — it’s essential for creating a real-time human connection. Whether you’re building a virtual classroom, supporting remote teams, or hosting online events, a reliable video conferencing API lets you embed video calls directly into your website or app.

This guide walks you through how to embed video conferencing using Digital Samba’s video API, SDK, and WordPress plugin. You’ll learn how to customise the experience, stay GDPR-compliant, and go live in minutes.

Table of Contents

Why add video conferencing to your website?
Video conferencing API vs SDK: what’s the difference?
Step-by-step guide: Embed video call on your website with Digital Samba API
Customising the embedded video conferencing experience using Digital Samba SDK
Using SDK events and methods to manage events in real-time
Digital Samba embedded WordPress plugin: Effortless WebRTC integration
Maximise your website's potential by integrating Digital Samba video conferencing
FAQs: Everything you need to know on how to embed video chat to your website

It's also crucial to remember that you can integrate Digital Samba video conferencing into your website or app using our API for developers or our WordPress Plugin for WordPress websites. The API allows for effortless integration with a few lines of HTML code. At the same time, the WordPress Plugin offers simple, GDPR-compliant video conferencing and webinars with various features such as screen sharing, text chat, closed captioning, and virtual background.

Let’s explore why embedded video conferencing is a must-have feature for websites across education, healthcare, customer support, and more.

Why add video conferencing to your website?

Adding video conferencing functionality to your website is more than a feature — it's a powerful way to drive engagement and build real-time human connection. Whether you're offering live support, virtual events, or online learning, embedding video calls creates a more interactive and personal experience.

With the rise of remote work, online classrooms, and telehealth, video conferencing integration has become critical for businesses and platforms looking to stay relevant and competitive.

For businesses, embedding video calls into a website allows for face-to-face customer engagement without third-party tools. This deeper connection improves support, increases trust, and boosts conversion rates.

In healthcare, embedding secure video calls enables remote consultations and follow-ups, making telemedicine more accessible while maintaining data privacy.

Similarly, it enables telemedicine in healthcare, providing patients with easy access to medical consultations. By leveraging video conferencing, you can successfully add real-time video conferencing capabilities to your website, enhancing your students' or patients' engagement and interaction during online events.

Moreover, internally, video conferencing strengthens team communication, especially in remote setups, ensuring clearer and more empathetic exchanges than text-based communications.

Embedding video conferencing on your website is no longer optional — it’s essential for creating modern, human-centric digital experiences. Whether you're in education, healthcare, sales, or support, real-time video elevates connection, communication, and trust.

Video conferencing API vs SDK: what’s the difference?

When it comes to adding live video to a website or app, developers usually work with two tools: APIs and SDKs. While they sound similar, they serve different purposes, and choosing the right one depends on your project needs.

A Software Development Kit (SDK) is a bundle of tools, libraries, and code samples that helps developers build custom video experiences.
In the context of video conferencing, SDKs make it easier to design and control how the video call looks and behaves — ideal for apps where you want full UI control.

An API (Application Programming Interface) lets your app talk to a video conferencing platform.
It’s like a set of instructions your software can use to create rooms, manage participants, or start calls, without needing to rebuild complex infrastructure from scratch.

In most cases, developers combine the video API with an SDK to get both backend control and frontend flexibility when embedding video conferencing into a website.

How to embed video calls on your website using Digital Samba

You can add live video conferencing to your website in a few simple steps using Digital Samba.

Whether you’re looking for a quick HTML embed or full control via our API, this section walks you through your options, from basic to advanced.

Set up a Digital Samba account

First, sign up for a free Digital Samba account.

Once you’re in, head to the “Team” section to find your API Key, Team ID, and Developer Key — these are the credentials you'll use to authenticate your requests.

get the API keys by logging into your account and navigating to the Team tab-1

Let's look at how you can embed Digital Samba video conferencing on your website.

Understanding Digital Samba integration options

1. Using the Digital Samba API

You can use it to create rooms, assign roles, and manage video sessions programmatically. This is best if you’re building a custom integration or need to connect video calls with other tools.

2. The HTML iframe embed

If you’re looking for the simplest solution, use an HTML iframe to embed video conferencing directly into your site.

No need for heavy development — just copy, paste, and go live.

This iframe embeds the video conferencing room into your website, enabling live video conferencing capabilities.

3. Digital Samba SDK

For more advanced customisation, use the Digital Samba SDK. It lets you interact with in-room events, control layout, and deeply integrate the video call experience into your frontend code.

Creating a video conferencing room

To create a new video room, you can either use our REST API or do it directly from the dashboard.

The Digital Samba REST API involves executing a POST request to the /room endpoint with your Team ID and Developer Key. Here's an example of a POST request:

curl --request POST \

--header "Content-Type: application/json" \

--url https://digitalsamba.com/api/v1/rooms \

--user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY \

--data '{

"privacy": "public",

"roles": ["moderator", "speaker", "attendee"],

"default_role": "attendee"

This request creates a room and sets its privacy state and available roles.

The privacy settings determine who can access the video conferencing room.

Public: A public room is accessible to anyone with the link, allowing for broader participation without specific invitations.
Private: A private room restricts access to only those explicitly invited or with the necessary credentials, ensuring a more controlled and secure environment.

Conversely, Roles define the level of access and control participants have in the room. Remember that a single moderator role is the simplest way to create a room.

Moderator: Has the highest level of control, including managing participants and room settings.
Speaker: Can actively participate and present in the room, with some controls over their segment of the session.
Attendee: Generally has view-only access, with limited interaction capabilities, ideal for general participants in a larger audience.

The dashboard, on the other hand, provides a more visual and less technical method to accomplish the same task as illustrated below.

Create image with dashboard

You will then be presented with the Create a new room window, where you can customise your room according to your preference.

Create room settings dashboard-1

Once your room is created, you can embed it on your website using either an iframe or our SDK, depending on how much control you want.

Customise your video call experience with the

The Digital Samba SDK offers a more sophisticated and flexible approach to embedding video conferencing than the basic HTML iframe embed. While the simple HTML embed is excellent for quick integrations, the SDK provides enhanced control and customisation options, allowing for a deeper integration into your website or application.

What are some of the advantages of using the Digital Samba SDK?

Extended customisation: The SDK allows for more detailed customisation of the video conferencing experience. You can tailor the look and feel of the video conferencing frame to match your website's design and user interface.
Advanced control: With the SDK, you can access additional controls and features that are unavailable through the basic HTML embed. This includes manipulating room settings programmatically and responding to in-room events in real-time.
Integration flexibility: The SDK is designed for seamless integration with your existing frontend code, offering a more integrated experience for users and smoother interactions within your application.

For more detailed information and comprehensive documentation on using the Digital Samba SDK, please refer to our SDK Documentation.

Customising the embedded video conferencing experience using Digital Samba SDK

The Digital Samba SDK gives you more control over how your video calls look and feel. From layout and language to in-room behaviour, you can tailor the experience to match your brand and user needs.

Initialisation of the DigitalSambaEmbedded class

Start by initialising the DigitalSambaEmbedded class — this is the core of the SDK. You can either load the room immediately or use the createControl method if you prefer to manage when and how the room appears.

Setting initialisation options (InitOptions)

InitOptions let you configure how the video room is embedded.
You can control the room’s iframe location, pass in the URL or team/room names, and add a JWT token for private rooms. Some of the options include:

root: Specifies the HTML element where the video frame will be created.
frame: Allows loading the room in your website's existing iframe element. If not specified, an iframe is automatically created.
url: The full room URL for the iframe's src attribute.
team and room: Used for specifying the team and room names instead of the URL.
token: An optional JWT string for authentication, commonly used for private rooms that make use of roles.

Configuring room settings

Use roomSettings to define what happens when a user joins a room.
These settings include:

Enabling or disabling video and audio devices upon entering the room.

disabled camera and audio on join

Configuring initial media devices (video input, audio input, audio output).

Setting the app language, user name and custom initials for user tiles and choosing the layout mode (e.g., auto or tiled).

Setting the visibility of the toolbar and captions panel.

Toolbar panel

Setting up virtual backgrounds.
Muting the frame on join for the local user.

Here is a JSON code example of how to achieve this:

{

//Configures if user's video device will be enabled on entering the room

videoEnabled: boolean,

//Configures if user's audio device will be enabled on entering the room

audioEnabled: boolean,

//Configures initial video and audio devices to use on entering the room

mediaDevices: {

videoinput: 'id of camera',

audioinput: 'id of microphone',

audiooutput: 'id of speaker device'

//Language for the user. Use language code - e.g. en, de, es

appLanguage: string,

//Configures name of the user on entering the room

username: string,

//Configures custom initials (max 2 letters) for the user tile

initials: string,

//Configures if 'auto' or 'tiled' layout mode will be used

layoutMode: string,

//Configures if the toolbar will be visible or not

showToolbar: boolean,

//Configures if the captions panel will be visible or not

showCaptions: boolean,

//Configures the virtual background

virtualBackground: VirtualBackgroundOptions,

//Configures if the frame will be muted on join for the local user

muteFrame: boolean

}

These SDK settings help you create a clean, branded video call setup that feels like a natural part of your site or app.

Loading the room

After setting the InitOptions and roomSettings, the room is loaded using the load method. This final step embeds the custom video conference room into your website, providing a tailored user experience.

Here's a basic example to illustrate the customisation process:

import DigitalSambaEmbedded from '@digitalsamba/embedded-sdk';

// Initialize with InitOptions specifying the target element for embedding

const sambaFrame = DigitalSambaEmbedded.createControl({

url: 'https://[TEAM_NAME_HERE].digitalsamba.com/[ROOM_NAME_HERE]',

initOptions: {

targetElement: 'YOUR_TARGET_ELEMENT_ID' // Specify the ID of the HTML element or iframe where the room will be embedded

}

});

// Optional: Configure room settings

const roomSettings = {

videoEnabled: true,

audioEnabled: true,

layoutMode: 'auto',

// other settings...

};

// Load the room with settings

sambaFrame.load(roomSettings);

This example demonstrates how to use the Digital Samba SDK to embed a video conferencing room into a specific element on your website, enhancing customisation and user experience. The initOptions are crucial for defining the exact location on the webpage where the video conference will appear.

For more detailed examples and information on the possible initOptions combinations, please refer to the Digital Samba SDK Documentation.

Using SDK events and methods to manage events in real-time

The Digital Samba SDK gives you access to real-time events and control methods, so you can make your video calls interactive and responsive.
From detecting when users join to handling mic access or hand raises, these tools help you manage everything live, directly from your frontend.

Let's explore some examples:

Subscribing to events

You can subscribe to various events to monitor different activities within a video conferencing room. The SDK offers a range of events such as userJoined, userLeft, handRaised, handLowered, audioEnabled, audioDisabled and many others.

You can use the on() method to subscribe to an event and off() to unsubscribe. The once() method is also available for one-time subscriptions. Here's a template for subscribing and unsubscribing to an event:

const myCallback = (event) => {

// Custom logic here

}

// Subscribe to an event

sambaFrame.on('eventNameHere', myCallback);

// Unsubscribe from an event

sambaFrame.off('eventNameHere', myCallback);

Handling specific events

Want to show a message when someone leaves the call? Just use the userLeft event.

Here’s a basic example of how to handle that scenario in your app.

sambaFrame.on('userLeft', (event) => {

// Logic to handle user leaving

});

You can also track when users turn their audio on or off using audioEnabled and audioDisabled.

This can be helpful if you're managing roles or want to trigger UI updates based on user activity.

sambaFrame.

on('audioEnabled', (event) => {

// Logic when audio is enabled

});

sambaFrame.on('audioDisabled', (event) => {

Debugging with events

For debugging, you can listen to all SDK events by subscribing to '*'.

This helps log everything in the room — great for testing or development environments.

sambaFrame.on('*', (event) => {

console.log(event);

});

By utilising these events and methods, you can create a dynamic and responsive video conferencing environment, adapting in real-time to the actions and needs of the participants. This allows for a more controlled and interactive experience during your Digital Samba video conferences.

Using SDK methods to control the call

Besides events, the SDK includes methods to control the video call experience. You can start or stop a camera, end a session, or ask a user to unmute — all from your code.

However, before using any methods, you must initialise the SDK and load the room. It is important to subscribe to the userJoined event to ensure the user is present in the room before calling other methods.

Once the room is initialised and the SDK is loaded, you can utilise various SDK methods to manage the video call. Here's a look at some key methods:

The enableVideo() method turns on the user's camera.
The endSession() ends the session for everyone, removing all users from the room.
The requestUnmute() method requests a remote user to unmute their microphone. The user ID is passed as a parameter, and the remote user will receive a pop-up to accept or deny the request.

Here’s a quick example of how you might use some of these methods in your app.

// Initialize the Digital Samba SDK

const initOptions = { team: 'myTeamNameHere', room: 'myRoomNameHere' };

const sambaFrame = DigitalSambaEmbedded.createControl(initOptions);

// When the user joins the room

sambaFrame.on('userJoined', (event) => {

if (event.data.type === 'local') {

console.log('You have joined the room');

// Enable the user's camera

sambaFrame.enable video();

} else {

console.log(event.data.user.name, 'has joined the room');

}

});

// Function to request a remote user to unmute their microphone

function requestUserToUnmute(userId) {

sambaFrame.requestUnmute(userId);

}

// Function to end the session for all users

function endTheSession() {

sambaFrame.endSession();

}

// Load the room when needed according to your application logic

sambaFrame.load();

// Example usage - call the method at some point later during the call

const remoteUserId = 'user_id_here'; // Replace with the actual user ID

requestUserToUnmute(remoteUserId);

// To end the session (e.g., after a specific event or condition)

// endTheSession(); // Uncomment to use

These methods provide significant control over the video conferencing experience, allowing for dynamic interaction and management of the call. They are essential for creating a custom and responsive video conferencing environment using Digital Samba's SDK.

Add video conferencing to WordPress with the Digital Samba plugin

If you’re using WordPress, you can easily embed GDPR-compliant video calls with the Digital Samba plugin — no coding required. It includes features like screen sharing, live chat, virtual backgrounds, and closed captions, all powered by secure WebRTC video technology.

How to use the plugin

Installation and setup:

To get started, install the free Digital Samba Embedded WordPress plugin from the WordPress Plugin Directory..

Once activated, you’ll need your Developer Key and Team ID — all found in your Digital Samba dashboard.

acquire your Developer Key and Team ID from Team tab - Digital Samba-1

Go to the plugin settings in WordPress and enter your Team ID, Developer Key, and domain name. Hit “Save Changes” to connect your account.

Plugin Credentials - Digital Samba

Save your settings and confirm the connection to your Digital Samba Embedded account.

Creating a room:

To create a room, click Add New Room in the plugin menu.
Provide a title for the WordPress post for easy reference.
Name your room within the plugin interface.
Customise room colours and other parameters according to your design preference (helpful descriptions are available for each option).

Digital Samba Embedded WordPress plugin - Add New Room

Click Publish to create your room.

Embedding the room

Each room you create gets a unique shortcode. You can use this to display the room on any page or post — just paste it into the WordPress editor.

Want to show the room only to logged-in users? You can control that in the plugin settings.

[digitalSamba_room id="add_your_Id_here" width="100%" height="100%" withtoken="false"]

You can either use the room immediately via its permalink or embed it into other WordPress pages using the generated shortcode. Here is an example of a published room on the WordPress website.

This flexibility allows you to control room visibility, whether for logged-in users or based on specific content restrictions. You can explore more on how to use shortcodes on the WordPress documentation.

The WordPress plugin is perfect for course creators, therapists, coaches, or teams that need fast, compliant video chat embedded directly into their site.

Take your website further with embedded video conferencing

In this guide, you’ve learned how to add secure, high-quality video conferencing to your website using Digital Samba. Whether you’re a developer looking to work with our API and SDK or a WordPress user wanting a no-code solution, integration is fast, flexible, and fully GDPR-compliant.

With features like screen sharing, closed captions, and virtual backgrounds, Digital Samba gives you everything you need to deliver a seamless video experience — right inside your app or site.

Ready to bring real-time video to your platform?
Start building with Digital Samba today, or talk to our team about the best way to integrate video conferencing into your website.

FAQs: Everything you need to know about how to embed video chat on your website

1. Can I set the audience to have broadcast permission by default?

Yes. You can configure default participant roles — including broadcast permissions — when creating rooms via the Digital Samba API or dashboard.

2. Does Digital Samba have API documentation?

Absolutely. You can explore our full developer docs at docs.digitalsamba.com for detailed info on our video conferencing API and SDK.

3. What credentials do I need to access the API endpoint?

Once you create a Digital Samba account, you’ll get a Team ID, Developer Key, and API Key — all required to use our video call API.

4. Can I preview the Digital Samba API before paying?

Yes. You can start with a free plan and test the API and video SDK without any upfront cost. It’s the easiest way to try embedding video calls before scaling.

5. Can I use Digital Samba in an HTML5-based hybrid app?

Yes. Digital Samba supports integration into HTML5 hybrid apps, making it ideal for modern mobile frameworks like Ionic, Cordova, and Capacitor.

6. Can I pre-fill the nickname field and skip the join screen in an iframe?

Yes. When embedding a room with an iframe, you can use query parameters to pass the user’s name and bypass the join screen for a smoother experience.

7. What’s the fastest way to embed video chat into my website?

The quickest method is to use our iframe embed. Just generate the room link and paste the iframe code into your HTML — no development required.

8. What’s the difference between the API and the SDK?

The video API helps you manage backend tasks like creating rooms and setting roles. The SDK handles the frontend, letting you control how the video call looks and behaves on your site.

9. Can I embed a video call directly into a WordPress site?

Yes. With our official WordPress plugin, you can add fully functional video conferencing rooms using shortcodes — no coding needed.

10. Is Digital Samba GDPR-compliant?

Yes. We host all data on EU servers, offer end-to-end encryption, and comply fully with GDPR. Perfect for privacy-focused apps in healthcare, education, and enterprise.

11. How many users can join a Digital Samba video meeting?

Depending on your plan, you can host large group calls with hundreds of participants and up to 49 video streams on screen at once.

12. Can I brand the embedded video chat interface?

Yes. With our white-labelling options, you can customise logos, colours, fonts, and even the domain. Use the SDK for deeper branding control.

Request a free consultation with our dev team

Embed video call on your website with Digital Samba

Get a consultation

← Video Bitrate: How to Boost Video Quality and Streaming Performance

Enhancing Your Video Conferencing Experience with Digital Samba's Reliable Support →