CasperVend 2/Bot Delivery: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
Line 2: Line 2:


We're very proud to introduce this feature, yet again we're pushing the boundaries and are the first in Second Life to offer this.
We're very proud to introduce this feature, yet again we're pushing the boundaries and are the first in Second Life to offer this.
{|align=right
  |__TOC__
  |}


==Why?==
= '''<span style="color:#00528c">Why Deliver With a Bot?</span>''' =


Unless you are Linden Lab, the only scriptable option available to deliver items in Second Life is llGiveInventory. Unfortunately, this function is horribly flawed - it provides no feedback to us about whether a delivery was successful.
Unless you are Linden Lab, the only scriptable option available to deliver items in Second Life is llGiveInventory. Unfortunately, this function is horribly flawed - it provides no feedback to us about whether a delivery was successful.


In addition, thanks to the stupid design of the V2 / V3 viewers, inventory offer dialogs disappear within a few seconds, and many users don't know that they can check the message stack in the top right to look for deliveries.
In addition, thanks to the "streamlined" design of the V2 / V3 viewers, inventory offer dialogs disappear within a few seconds, and many users don't know that they can check the message stack in the top right (or bottom right, depending on their viewer) to look for deliveries.


Using a bot to send items brings two major advantages:
Using a bot to send items brings two major advantages:
Line 14: Line 17:
* If a user doesn't receive (or doesn't see) the inventory offer dialog, the item will STILL appear in their inventory.
* If a user doesn't receive (or doesn't see) the inventory offer dialog, the item will STILL appear in their inventory.


==What do I need?==
= '''<span style="color:#00528c">What Do I Need?</span>''' =


You need a [http://www.smartbots2life.com/docs/Register_SmartBots_Personal_Bot SmartBots Personal Bot], which costs L$479 per week. The L$79 per week group inviter service is NOT sufficient.
You will need a [http://www.smartbots2life.com/docs/Register_SmartBots_Personal_Bot SmartBots Personal Bot], which costs L$479 per week. This has '''extra''' capabilities beyond the basic group inviter service, so the L$79/week inviter service will not be sufficient.


==Can I use ____ bot?==
= '''<span style="color:#00528c">Can I Use (_other_) Bot Service?</span>''' =


Currently, SmartBots is the only service which provides the HTTP interface we need to ensure reliable delivery. While bots such as PikkuBot can deliver items, they don't provide the callbacks we need to ensure that the delivery was successful.
Currently, SmartBots is the '''only''' service which provides the HTTP interface we need to ensure reliable delivery. While bots such as PikkuBot can deliver items, they don't provide the scripted callbacks we need to ensure that the delivery was successful.


==What if my bot is offline?==
= '''<span style="color:#00528c">What If My Bot is Offline?</span>''' =


If the bot cannot deliver the item, the DropBox will be used.
If the bot cannot deliver the item, the DropBox will be used.


==How do I set this up?==
= '''<span style="color:#00528c">How Do I Set This Up?</span>''' =


Simply edit or create a new product.
: 1. Simply edit or create a new product.


Set an item to deliver (from your dropbox) - there must always be a dropbox item set to use as a fallback.
: 2. Set an item to deliver (from your dropbox) - there must always be a dropbox item set to use as a fallback.


Once you've set an item to deliver, a box will pop up offering the new service. Simply follow the instructions on screen to configure the product for SmartBots delivery.
: 3. Once you've set an item to deliver, a box will pop up offering the new service.  


==Limitations==
: 4. Simply follow the instructions on screen to configure the product for SmartBots delivery.
 
= '''<span style="color:#00528c">Limitations</span>''' =
 
* Folders cannot '''currently''' be delivered, this is due to technical limitations at SmartBots.


* Folders cannot currently be delivered, this is due to technical limitations at SmartBots.
* There's a bug at SmartBot's side which means that permissions checks are not performed - if you try to assign a "no transfer" item for delivery, the delivery will appear to succeed but the recipient will get an error.
* There's a bug at SmartBot's side which means that permissions checks are not performed - if you try to assign a "no transfer" item for delivery, the delivery will appear to succeed but the recipient will get an error.
* Delivering no-copy items is possible, however it will only deliver once and then will fall back to the dropbox method.
* Delivering no-copy items is possible, however it will only deliver once and then will fall back to the dropbox method.

Revision as of 06:20, 13 January 2014

As of the 12th of January, 2014, CasperVend can now use a SmartBots Personal Bot to deliver inventory, with the dropbox remaining as a backup.

We're very proud to introduce this feature, yet again we're pushing the boundaries and are the first in Second Life to offer this.

Why Deliver With a Bot?

Unless you are Linden Lab, the only scriptable option available to deliver items in Second Life is llGiveInventory. Unfortunately, this function is horribly flawed - it provides no feedback to us about whether a delivery was successful.

In addition, thanks to the "streamlined" design of the V2 / V3 viewers, inventory offer dialogs disappear within a few seconds, and many users don't know that they can check the message stack in the top right (or bottom right, depending on their viewer) to look for deliveries.

Using a bot to send items brings two major advantages:

  • If a user "declines" an inventory offer, it will go to their trash rather than disappearing forever.
  • If a user doesn't receive (or doesn't see) the inventory offer dialog, the item will STILL appear in their inventory.

What Do I Need?

You will need a SmartBots Personal Bot, which costs L$479 per week. This has extra capabilities beyond the basic group inviter service, so the L$79/week inviter service will not be sufficient.

Can I Use (_other_) Bot Service?

Currently, SmartBots is the only service which provides the HTTP interface we need to ensure reliable delivery. While bots such as PikkuBot can deliver items, they don't provide the scripted callbacks we need to ensure that the delivery was successful.

What If My Bot is Offline?

If the bot cannot deliver the item, the DropBox will be used.

How Do I Set This Up?

1. Simply edit or create a new product.
2. Set an item to deliver (from your dropbox) - there must always be a dropbox item set to use as a fallback.
3. Once you've set an item to deliver, a box will pop up offering the new service.
4. Simply follow the instructions on screen to configure the product for SmartBots delivery.

Limitations

  • Folders cannot currently be delivered, this is due to technical limitations at SmartBots.
  • There's a bug at SmartBot's side which means that permissions checks are not performed - if you try to assign a "no transfer" item for delivery, the delivery will appear to succeed but the recipient will get an error.
  • Delivering no-copy items is possible, however it will only deliver once and then will fall back to the dropbox method.