# Moodle : Using Digital Samba as an LTI external tool

### Adding Digital Samba as an external tool

*On your Digital Samba Dashboard* :&#x20;

* &#x20;The LTI external tool will use your[ default room settings](https://dashboard.digitalsamba.com/default-room-settings).
* &#x20;You should set available roles to **Teachers** & **Students** & make **Students** default role.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXebJse5aRRW8JYt1Lu7o_6oaofwysDGzXafPAI1e07CFg3bkITP8UAbmRD7GyB6hV1CqR_iDUANdU8fPUj76hel-4g39rzo473yFKCfTKyAFxk7jdm-Qe14cLEfzSoAAcmeGNpEF3z5Nn0-Sd2QkINOH0ut?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Digital Samba default room settings</p></figcaption></figure>

* You can configure the rest of your default room settings to suit your requirements.

*On Moodle :*

* Log into your Moodle LMS instance as an Admin.
* Navigate to ***Site Administration*** > ***Plug-ins*** > ***Activity modules*** > ***External Tool*** > ***Manage tools***
* In the ***Add tool*** area – enter **<https://lti.digitalsamba.com/lti/1.3/register>** and click the ***Add LTI Advantage*** button.
* This will dynamically register Digital Samba as an LTI external tool on your LMS.
* Once this is done – you will see the Digital Samba tool in a pending state.
* Click on the three lines ( Tool Configuration details ) and send this information back to us so that we can enable your LMS on our side.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdBb5jINMMhmuYdtX_h1K-_AQip-DOwJeCL-Avl_mO-IFlqvQtraMt4bSkQH6tDC_ejh9VQZ3x9GMvkUPVU2x_O_wQFde5AKbMo7uMS0CcvGYoBYYB-cUUuSrJst8SoH1o0U9g3dpjgH2nC4wVRNMeEhJtC?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Moodle tool configuration details</p></figcaption></figure>

* Once you have confirmation back from us that your LMS is enabled, click the Activate button.
* You may want to adjust a couple of settings within the tool to make best use of it.
* To access these click the Settings cog :

1. Make the **Digital Samba** tool available in the moodle **Activity chooser** :

   * For *Tool configuration usage* > Select the ‘*Show as preconfigured tool when adding an external tool*’ option.

   <figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXeeZvNJgunabaM2ALZjQpM3Bx6cRFjGR36XxKdZCMbtDD_MXBhBbPZ-3TAzUxNiR4xmB5KHywY6WHoWFtVXOSZoGfXQbwzSPCXjk2iriv3_Xtlom6fiHrG2Nwi2CPuXG5qY7RzWBYK5sLFj-iunvL5tDdl9?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Tool configuration usage</p></figcaption></figure>

2. Use LMS users names in Digital Samba rooms

   * In the **Privacy** section :
   * For *Share launcher's name* with tool select *Always*

   <figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXfPqs7oejKE3rDrdHLFboM8D4xuO4mIcj1ybTR0FJwwSuXTvXVIV714-pUewfpYnJX9zGhGcMvtd5w8yMFIGQDAErA83hKrWqPXA0U6zUuuMEKWwDnRrz2kT0laWzp64Lm18ueQ-s_zdW2t1V6_pLJBdP5c?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Share LMS name in external tool</p></figcaption></figure>

Congratulations! You are now ready to use Digital Samba rooms in your LMS course!

***

### Using Digital Samba as an external tool in an LMS course&#x20;

* Go to **My courses.**
* Enter ‘***Edit Mode***’ and click on the three dots to create a new course.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXc6t51DMq0Xg1cy65i6QL5XrCtnVIB6ZORr25ys9NKZRjFhg7wNDpVRIprzqC8HHUIo5DobIY3VmWxOkPmLI-RxtOW3Muh9o1eYNiF9g3URtuwpKv3Tl3U4ned0ygs9rwpPa5Sk421pPAmsFipHS7-oTftJ?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>New course</p></figcaption></figure>

* Fill in Course details as per your usual process and click **Save and display.**
* In desired section of your couse click on the ***Add an Activity or resource button.***

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXfROtx1JCLHWVPZ1t2rL12Sti3avIwSz3WQFeIIYnIgVYXuRnxEfJR9yCLdlzNALletKhu50lDNe_TJMAwVQ-GIUu0jFQHCuniko3FVzIWyoH3kOdPVoXrj4zIo4sdlTpTEencyP5WdpqUXPBZS6rdaOBi7?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Add activity or resource</p></figcaption></figure>

* Select **Digital Samba** from the activity/resource chooser

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdJu5YdrshV3lpDRqLS9uPVY8jp3vnp3Yq97HwDRblyHtz51i8OfEGlEi61iosXJKNk71nOHQBpKaWGYepobglbThurhJgIhR-A6WxNbtAHxNIw_34MKl3ZyAnSLrpdsQW2v6irQ2ReEF9T3WD3qKgt53Ai?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Activity and resource chooser</p></figcaption></figure>

* Give the Activity a name and fill out any other settings as per your normal processes.
* Click **Save and return to course.**
* You can then enroll users in the course.
* Roles assigned here will be reflected in the room with the[ permissions assigned to the Student and Teacher roles](https://docs.digitalsamba.com/dashboard/adding-moderation-to-your-rooms-with-roles/permissions) in your[ Digital Samba Dashboard](https://dashboard.digitalsamba.com/).

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXcHgw2GlZZKIBwf9hQ7D9oWmhFsdRJsU_uk-kuC1XJi-oPnskXJDbUVJPZ4GV8voaJgd5NdJoltQySAhCvwHk59CTXnl7RAG8lB23pS68zfU2jqrrLlOp46A_t6HEJr-M0-vJAyMHA0WYD8FBgkoIXFnJk?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Enroll users in course</p></figcaption></figure>

* Your teachers and students will then be able to join the room whenever it is time for class!

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdq7fTzHCTmyW93mJ7HP4RXDkrRQMmixVAvT1OO7uZOrbWYIRSDB79S8vP24sneyCQipie1_vUS1vOmOQ5FR63xc5uw0oauL0ii_7I1Ng0qenK6WfmD4xoiE1ZmeetH6nqaRxEFgPLQbLE-viZSFLmM70sp?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Join the Digital Samba class</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalsamba.com/lti/moodle-using-digital-samba-as-an-lti-external-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
