# Setting up bot greeter

[Personal Bot](/doc/e59a06a3-4c30-4082-b5ba-523fef7ae733) service includes a free **Greeter** application you can use to greet visitors. Below you can read how to set this up!

## Setting up & configuration

To start setting up, click **Edit settings** on your **Greeter dashboard** and enable the according checkmark. (Below is explained the setup process for each)

Check below how to setup each option:

* Group Invite
* Local Chat greeting
* IM Greeting
* Inventory Offer

### Setting up group invitations

 ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/27059c12-c904-4924-9380-d88116eadbd3/Invite_to_group_option_greeter.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=64c332acdc935654e20667f1d563c976e17318e87d99e69d46dd6cf10ef0c36b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =650x329")

**Limits** define how many times an avatar should be invited:

* **Once:** Visitor is invited only once
* **Twice:** Visitor is invited on first and second visits only
* **Always:** Visitor is invited on every visit

**1 hour delay** is in place for all the **Limits** in-order to prevent same avatars being invited on every visit.

### Selecting the group & role

**BE ADVISED:**

* In-order to function properly, your bot requires **Group invite permissions.** Read more details on [Setting up bot for invitations](/doc/cbeec85e-7a5c-45f1-8bc3-68985222cc2d)
* If your bot must invite to **Custom role** (other than "Everyone"). Your bot requires following abilities: *Assign to assigner's role, Assign to any role, Remove members from roles*

Click the drop-down menu under **To group** and select which group bot should invite to. Under **Invite to role** - select the role.

You can also click **add another group** to invite in multiple groups.

### Setting up Local Chat Greeter

 ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/75a51fc6-5fe4-4ecb-a264-be1d874b0712/Local_Chat_greeting.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=ed3ba80004bbce805bea157bbc498eb1e166e475d32038e3048c9ea1db3e718c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =650x402")

**Limits** define how many times an avatar should be greeted:

* **Once:** Visitor is greeted only once
* **Twice:** Visitor is greeted on first and second visits only
* **Always:** Visitor is greeted on every visit

**1 hour delay** is in place for all the **Limits** in-order to prevent same avatars being greeted on every visit.

The drop-down menu allows you to select local chat **message type**: Say, shout, whisper.

### Variables you can use & Examples

There are several **variables** you can insert into **greeting text**.

* **%FIRST_NAME%** is converted into **avatar's first name** when executed. *Example: Glaznah Gassner will be obstructed into "Glaznah"*
* **%SL_NAME%** is converted into **avatar's full SL name** (Including **Resident**).
* **%VISITOR_SLURL%** is converted into **visitor's location URL** (Where visitor currently is located)
* **%BOT_SLURL&** is converted into **bot's location URL** (Where bot is currently located)

### Setting up IM Greeting

 ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/faf03cee-fff6-4815-afc6-e42fc6b8dbe0/IM_Greeter_checkmark.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=5e05a112761408c695db4338948250dbe51029222de684f24258c11393bf5dff&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =650x401")

**Limits** define how many times an avatar should be greeted:

* **Once:** Visitor is greeted only once
* **Twice:** Visitor is greeted on first and second visits only
* **Always:** Visitor is greeted on every visit

**1 hour delay** is in place for all the **Limits** in-order to prevent same avatars being greeted on every visit.

The drop-down menu allows you to select local chat **message type**: Say, shout, whisper.

### Variables you can use & Examples

There are several **variables** you can insert into **greeting text**.

* **%FIRST_NAME%** is converted into **avatar's first name** when executed. *Example: Glaznah Gassner will be obstructed into "Glaznah"*
* **%SL_NAME%** is converted into **avatar's full SL name** (Including **Resident**).
* **%VISITOR_SLURL%** is converted into **visitor's location URL** (Where visitor currently is located)
* **%BOT_SLURL&** is converted into **bot's location URL** (Where bot is currently located)

### Setting up inventory offer

 ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/52f3d9d1-677c-484c-a898-9652047515e6/Inventory_offer_checkmark.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=0ffeeb7a48418fb2f646fbc6c5889204cb39364f66a43f1f39db93b6ba2a4a04&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =650x373")

Your bot additionally (or separately) can send an **inventory offer**.

**Limits** define how many times an avatar receive an inventory offer:

* **Once:** Visitor is greeted only once
* **Twice:** Visitor is greeted on first and second visits only
* **Always:** Visitor is greeted on every visit

**1 hour delay** is in place for all the **Limits** in-order to prevent same avatars being greeted on every visit.

To select an inventory offer, click **add item to offer** - this will open the **Inventory Browser** where you can select an item of your choice. It's also possible to add multiple items by repeating the same process.

### Assigning Copy + Transfer permissions

In-order to send an inventory offer: Object **must be copy+trans**, you can set next user permissions using the [Personal Bot Inventory Browser](/doc/54b3b812-ed80-461b-a0a2-e5b95e917606)

Alternatively, you can login to your bot **using Viewer** and set the next user permissions from **avatar's inventory**.

## Ignoring avatars & Delay

 ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/df5808d9-2dff-4867-bb2e-5aa22144da59/Ignore_avatars_greeter.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=3078f5de7bd4fbcde199f786e601bc85ee247e128107b475bf668bdda0496b03&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =650x133")

Additionally, you can set a **delay** (in seconds) before greeting is executed and **ignore unwanted avatars**. This will affect on **every option** provided by **Bot Greeter**