# Streamloots

## Getting Started

The Streamloots feature allows you to trigger events when a card has been redeemed. To connect to Streamloots, head to your Streamloots dashboard page, click on Alerts on the left-side menu, copy your Alert Overlay URL into the text box, and click Log In. Card redemption alerts can be set up on the [Streamloots Card Commands](/docs/integrations/streamloots#streamloots-card-commands) section.

## Events

### Streamloots Card Redeemed
This event runs whenever a user redeems a Streamloots card. The [User](/docs/reference/special-identifiers#user) Special Identifiers reference the user that redeemed the card. This event provides the same Special Identifiers as [Streamloots Card Commands](/docs/integrations/streamloots#streamloots-card-commands).

### Streamloots Pack Purchased
This event runs whenever a user purchases a pack of Streamloots cards. The [User](/docs/reference/special-identifiers#user) Special Identifiers reference the user that purchased the pack. This event provides the following additional Special Identifiers:
- $streamlootspurchasequantity - The total number of packs purchased. (EX: 3)

### Streamloots Pack Gifted
This event runs whenever a user gifts a pack of Streamloots cards to another user. The [User](/docs/reference/special-identifiers#user) Special Identifiers reference the user that GIFTED the pack, while the [Target User](/docs/reference/special-identifiers#target-user) Special Identifiers reference the user that RECEIVED the pack. This event provides the following additional Special Identifiers:
- $streamlootspurchasequantity - The total number of packs purchased. (EX: 3)

### Streamloots Pack Community Gifted
This event runs whenever a user gifts packs of Streamloots cards to the community, which are randomly given out to viewers. The [User](/docs/reference/special-identifiers#user) Special Identifiers reference the user that gifted the packs. This event provides the following additional Special Identifiers:
- $streamlootspurchasequantity - The total number of packs gifted. (EX: 3)

## Common Troubleshooting Steps

When running into issues, make sure to check the following:

- The name of the card and the name of the command match exactly

- Screen alerts are enabled for the card you are testing:

## Streamloots Card Commands

The Streamloots Cards feature allows you to create commands that can be triggered automatically when specific Streamloots Cards are redeemed in your channel. To set up a command to trigger for a specific card, all you must do is select the option to add a new command and name it EXACTLY the same as your Streamloots Card. In order to see this page, you must have the [Streamloots Service](/docs/integrations/streamloots) already connected on the Services page.

When testing cards for use with commands, you **must** use the Test button in the card editor window specifically to have it properly trigger the response in Mix It Up:

Streamloots Card commands provide the following additional Special Identifiers:
- $streamlootscardname = The name of the card that was redeemed. (EX: "Let's play together!")
- $streamlootscardimage = The image URL of the card that was redeemed. (EX: https://res.cloudinary.com/streamloots/image/upload/f_auto,c_scale,w_250,q_90/static/e19c7bf6-ca3e-49a8-807e-b2e9a1a47524/en_dl_character.png )
- $streamlootscardrarity = The rarity name of the card that was redeemed (EX: "legendary")
- $streamlootscardvideo = The video URL of the card that was redeemed. (EX: https://cdn.streamloots.com/uploads/5c645b78666f31002f2979d1/3a6bf1dc-7d61-4f93-be0a-f5dc1d0d33b6.webm )
- $streamlootscardhasvideo = Whether the redeemed card has a video associated with it. (EX: true )
- $streamlootscardsound = The sound URL of the card that was redeemed. (EX: https://static.streamloots.com/b355d1ef-d931-4c16-a48f-8bed0076401b/alerts/default.mp3 )
- $streamlootscarddescription = The description of the card that was redeemed.
- $streamlootscardalertmessage = The alert message associated with the card that was redeemed.
- $streamlootsmessage = The message the user supplied when they redeemed the card. Only corresponds to the field "message" or "longMessage" on your card redemption. (EX: "Hey there, favorite buddy!")