> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/recompensas/integrations.md).

# Integrações

Conecte uma campanha de Rewards a uma scene do Decentraland ou a um servidor externo para conceder wearables e emotes automaticamente.

Depois de criar e configurar uma campanha e garantir que tem stock suficiente para atribuir recompensas, o passo seguinte é ligar a campanha a um acionador de recompensas. Este acionador pode ser uma Scene, uma Quest ou um servidor externo. Esta secção explica como fazer diferentes integrações com Rewards.

## Atribuir recompensas a partir de uma scene

É possível integrar Rewards diretamente em scenes de Decentraland, mas esta abordagem acarreta alguns riscos. Como a lógica está incorporada no código da scene, que os utilizadores podem consultar, não é recomendada para criar itens com uma raridade inferior a \[EPIC]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#rarity).

Tenha em conta que utilizadores determinados e com conhecimentos técnicos suficientes podem contornar medidas de segurança, como captchas, alterar os respetivos endereços IP e criar todos os itens disponíveis, que poderão depois vender no Marketplace. A principal proteção contra esta situação é garantir um fornecimento suficiente de itens, para que todos tenham uma oportunidade justa de receber uma recompensa.

### Flags recomendadas para o dispenser

Recomendam-se as seguintes configurações do dispenser para reduzir o risco de exploração nesta situação:

* \[Limitar atribuições]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#limit-assignments)
* \[Assinatura do beneficiário]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#beneficiary-signature)
* \[Proteção por captcha]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#captcha-protection)
* \[Ligado a Decentraland]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#connected-to-decentraland)
* \[Posição dentro de Decentraland]\([Consultar a documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#position-inside-decentraland) (se for aplicável ao seu caso de utilização)

### Exemplo

```tsx
import { getPlayer } from '@dcl/sdk/src/players'
import { signedFetch } from '@decentraland/SignedFetch'
import { getRealm } from '~system/Runtime'

export function main() {
  // 1. Get captcha challenge to show to the user
  const request = await fetch(`https://rewards.decentraland.org/api/captcha`, {
    method: 'POST',
  })
  const captcha = await request.json()

  // 2. Display captcha for player to complete - See example in studios.decentraland.org/resources

  // 3. Get user data
  const user = getPlayer()

  // 4. Get current realm
  const realmInfo = await getRealm({})

  // 5. Send request to assign a wearable/emote
  const assignRequest = await signedFetch('https://rewards.decentraland.org/api/rewards', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      campaign_key: '[DISPENSER_KEY]', // dispenser key
      beneficiary: user.userId, // ethereum address
      catalyst: realmInfo.baseUrl, // catalyst domain
      captcha_id: captcha.data.id, // "9e6b2d07-b47b-4204-ae87-9c4dea48f9b7"
      captcha_value: '[CAPTCHA_VALUE]', // "123456"
    }),
  })

  const reward = await assignRequest.json()
```

## Atribuir recompensas a partir de uma Decentraland Quest

Esta integração antiga remete para a documentação arquivada de Quests.

Pode integrar facilmente Rewards com as [Decentraland Quests](https://github.com/decentraland/documentation/blob/5f8c7f73c67a9a36e85095cb02e72dc6355fa590/content/creator/deprecated/quests/overview.md), o que é ideal se quiser recompensar os utilizadores por concluírem uma quest.

### Flags recomendadas para o dispenser

Recomendam-se as seguintes configurações do dispenser para reduzir o risco de exploração nesta situação:

* \[Limitar atribuições]\([Ver documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#limit-assignments) (se se aplicar ao seu caso de utilização)

Qualquer outra flag fará com que a sua integração falhe; evite utilizá-las.

{% hint style="warning" %}
⚠️ A chave do dispenser deve ser mantida em segredo, por isso nunca a exponha aos utilizadores.
{% endhint %}

### Exemplo

Para integrar a sua Quest com o serviço Rewards, só precisa de uma chave do dispenser e de [configurar um webhook](https://github.com/decentraland/documentation/blob/5f8c7f73c67a9a36e85095cb02e72dc6355fa590/content/creator/deprecated/quests/rewards.md) para atribuir recompensas.

```js
{
    // ...
    "reward": {
        "hook": {
            "webhookUrl": "https://rewars.decentraland.org/api/rewards",
            "requestBody": {
                "campaign_key": "[DISPENSER_KEY]",
                "beneficiary": "{user_address}"
            }
        },
        // ...
    }
}
```

## Atribuir recompensas a partir de um servidor personalizado

Pode integrar o Rewards diretamente a partir do seu servidor, o que é ideal para realizar verificações adicionais antes de criar os itens. Uma vantagem adicional é que, ao contrário do código de uma Scene, o código do seu servidor pode não ser público, tornando mais difícil para os utilizadores descobrirem e explorarem vulnerabilidades.

### Flags recomendadas para o dispenser

Recomendam-se as seguintes configurações do dispenser para reduzir o risco de exploração nesta situação:

* \[Limitar atribuições]\([Ver documentação](https://docs.decentraland.org/creator/content-creator-pt/readme.md)#limit-assignments) (se se aplicar ao seu caso de utilização)

Ativar qualquer uma das outras flags pode complicar a sua integração ou, consoante o seu caso de utilização, fazer com que falhe. Por isso, não é recomendável utilizá-las, a menos que exista uma necessidade específica. No entanto, pode explorar os potenciais benefícios que oferecem.

{% hint style="warning" %}
⚠️ A chave do dispenser deve ser mantida em segredo, por isso nunca a exponha aos utilizadores.
{% endhint %}

### Exemplo

```tsx
const request = await fetch('https://rewards.decentraland.org/api/rewards', {
	method: 'POST',
	headers: {
		'Content-Type': 'application/json',
	},
	body: JSON.stringify({
		campaign_key: '[DISPENSER_KEY]',
		beneficiary: '0x0f5d2fb29fb7d3cfee444a200298f468908cc942', // endereço ethereum
	}),
})

const response = await request.json()
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/recompensas/integrations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
