# Bluetooth

### Introduction

The **Bluetooth Nodes** provide a means for the user to perform several actions within the *Bluetooth* standard. *Bluetooth* allows for communication between wireless and fixed devices in the short range, like when a car connects to a mobile phone. More information can be found [*here*](https://en.wikipedia.org/wiki/Bluetooth).

### Bluetooth Guideline

These are the guidelines for incorporating **Bluetooth Communication** into a **Project**.

* Unless a device's *Bluetooth* address is already known or has been previously retrieved through other means, one should use the [**Scan For Bluetooth Devices Node**](/incari-studio/2023.2/toolbox/communication/bluetooth/scanforbluetoothdevices.md) to discover any devices in the nearby vicinity. This will return all pairable devices in range as well as their Bluetooth addresses.
* Once a **Bluetooth** device has been discovered, it is possible to attempt pairing. Use [**Pair Bluetooth Device**](/incari-studio/2023.2/toolbox/communication/bluetooth/pairbluetoothdevices.md) to initiate the pairing. Separately, use [**On Bluetooth Device Paired**](/incari-studio/2023.2/toolbox/communication/bluetooth/events/onbluetoothdevicepaired.md) to execute any following **Logic** after pairing. This is to make sure pairing is successfully finished being established before doing anything. Only then is it possible to use the several **Nodes** that cover important functions of **Bluetooth Communication**.
  * [**Is Bluetooth Device Paired**](/incari-studio/2023.2/toolbox/communication/bluetooth/ispaired.md) returns *true* or *false* if a device has been paired with (even if it is out of range), or an error message if there is an error.
  * [**Retrieve Call History**](/incari-studio/2023.2/toolbox/communication/bluetooth/retrievecalhistory.md) returns the call history of a **Bluetooth** device (or devices), or an error message if there is an error.
  * [**Retrieve Phonebook**](/incari-studio/2023.2/toolbox/communication/bluetooth/retrievephonebook.md) returns the phonebook of a **Bluetooth** device (or devices), or an error message if there is an error.
  * [**Scan For Bluetooth Devices**](/incari-studio/2023.2/toolbox/communication/bluetooth/scanforbluetoothdevices.md) searches for **Bluetooth** devices in the general vicinity and returns **Dictionary** of them on success, or an error message if there is an error.
* To revoke access rights to a device (essentially removing it as a possibility for interacting with), use the [**Unpair Bluetooth Device Node**](/incari-studio/2023.2/toolbox/communication/bluetooth/unpairbluetoothdevices.md) to start unpairing. Separately, use the **On Bluetooth Device Unpaired Node** to execute any following **Logic**. This is to make sure the device is removed properly before doing anything.

### Contents

* [**Events**](/incari-studio/2023.2/toolbox/communication/bluetooth/events.md)
  * [**On Bluetooth Device Paired**](/incari-studio/2023.2/toolbox/communication/bluetooth/events/onbluetoothdevicepaired.md)
  * [**On Bluetooth Device Unpaired**](/incari-studio/2023.2/toolbox/communication/bluetooth/events/onbluetoothdeviceunpaired.md)
* [**Is Bluetooth Device Paired**](/incari-studio/2023.2/toolbox/communication/bluetooth/ispaired.md)
* [**Pair Bluetooth Device**](/incari-studio/2023.2/toolbox/communication/bluetooth/pairbluetoothdevices.md)
* [**Retrieve Call History**](https://github.com/cgi-studio-gmbh/incari-doc/blob/2023.2/toolbox/communication/bluetooth/retrievecallhistory.md)
* [**Retrieve Phonebook**](/incari-studio/2023.2/toolbox/communication/bluetooth/retrievephonebook.md)
* [**Scan For Bluetooth Devices**](/incari-studio/2023.2/toolbox/communication/bluetooth/scanforbluetoothdevices.md)
* [**Unpair Bluetooth Device**](/incari-studio/2023.2/toolbox/communication/bluetooth/unpairbluetoothdevices.md)

## External Links

* More about *Bluetooth* on [*Wikipedia*](https://en.wikipedia.org/wiki/Bluetooth).


---

# 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.incari.com/incari-studio/2023.2/toolbox/communication/bluetooth.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.