> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md).

# Personalizar widgets do programa

## Acessar o editor de widgets

1. No menu de navegação à esquerda, selecione ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Conteúdo**.
2. No cartão *Widgets* , selecione **Editar widgets.**
3. No menu lateral deslizante à esquerda, selecione o nome do widget que você quer editar.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F0I1JAhlX9u017vOG1oiM%2FScreenshot%202026-05-18%20at%2009.39.01.png?alt=media&#x26;token=9315e124-9a39-4aa7-9a74-15c1d76cef00" alt="" width="347"><figcaption></figcaption></figure></div>

## Personalizar seus widgets

{% stepper %}
{% step %}

### **Etapa 1: escolher um modelo**

1. No menu lateral deslizante à esquerda, abaixo de *Widget atual*, selecione **Modelos**.
2. Selecione **Aplicar modelo** ao lado do modelo que você quer usar como ponto de partida.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FUprZtBVbqNwCSdeRzWgh%2FScreenshot%202026-05-18%20at%2009.22.47.png?alt=media&#x26;token=ffb2f798-297e-4f6c-a154-30146230482c" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Observação:** Se quiser ver uma prévia do modelo sem confirmar a alteração, selecione ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-190c6a03e6a68d67509d00452b10fd803bee5c87%2F57c7cba09bd1b97dd75b7c245e517c8d1ca0469d7c57bdc13ee6e427b75a860a.svg?alt=media) **\[Pré-visualizar]** antes de salvar. Selecione o botão **Salvar** somente quando estiver tudo pronto para confirmar as alterações feitas.
{% endhint %}
{% endstep %}

{% step %}

### **Etapa 2: ajustar o conteúdo do widget**

Você pode adicionar, editar, mover ou remover componentes para modificar o conteúdo que os defensores da sua marca veem no widget.

{% hint style="success" %}
**Observação:** Para entender os diferentes elementos do editor de widgets, consulte Visão geral do editor de widgets.
{% endhint %}

{% tabs %}
{% tab title="Adicionar" %}

1. No lado direito da página, no menu *Componente* na guia **Adicionar** , selecione um grupo de componentes.
   * Saiba mais sobre os componentes disponíveis e como eles são agrupados.
2. Selecione o componente apropriado.
3. Selecione o botão azul **Adicionar a** no local em que você quer que o componente apareça na tela.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-faf3362b50a4598aeacff4ca831e5dcef8c7ef6e%2F346370cdced07562b504cd2b9bf6bf08b51539060e9551f784f029d4899ffa12.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Editar" %}
As propriedades que você pode editar dependem do tipo de componente selecionado. Por exemplo, se você selecionar o componente *Imagem principal* , poderá selecionar uma nova imagem e alterar a cor de fundo. Se selecionar um elemento somente de texto, como um cabeçalho, poderá modificar a fonte, a cor e o conteúdo do texto.

1. Selecione o componente que você quer editar.
2. Use as opções na guia *Componente* do menu **Editar** para alterar as propriedades do componente.

   * Se quiser inserir um link em um componente de texto, você pode fazer isso editando o HTML do widget.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3e26ab9dbdff4f8e5d3d3e078d965672ade44d45%2F026f0ef0af7421ecfab6535433ea587862ec12c5223e8b393ef1db1228676e1f.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="Mover" %}

1. Na tela de edição, selecione e mantenha pressionado o componente que você quer mover.
2. Arraste o componente até a nova posição na tela de edição e solte-o no lugar desejado.

   * Alguns componentes não podem ser movidos. Se não for possível arrastar um componente, ele não mudará de posição quando você tentar reposicioná-lo.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-7bd9887e9f359c787f834a8344a181d7bb186dd3%2Faadaf737882c59604dcaa6bbed1857c867a32cad8c3dd8ea7975c047c04e6a3f.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="Remover" %}

1. Na tela de edição, selecione o componente que você quer remover.
2. Selecionar ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c5ab8423372b2c345ded634b7aa4cab16c87fe3a%2Fd17a259fe817ff10ea9fd87140a89bd62ece6fa9940e05902574dcf95bed5960.svg?alt=media) **\[Remover]**.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-030ab8fb2f678027aa57af859245968daee6f736%2F987319390fa75c5fb85f94d2d6e0a951fbf4511a72dbd91af4e55c8f39317301.jpg?alt=media" alt="" width="507"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### **Etapa 3: personalize a aparência e o tema do widget**

#### **Adicionar imagens ou logotipos**

1. À direita, no menu *Componente* , na guia **Adicionar** , selecione a categoria **Componentes comuns** .
2. Selecione uma destas opções:
   * **Imagem principal com sobreposição de texto** (uma imagem com texto sobreposto e editável)
   * **Imagem** (uma imagem simples, sem texto sobreposto)
3. Adicione a imagem à tela de edição.
4. Na guia *do menu Componente,* **Editar** , selecione o botão **Escolher arquivo** abaixo do título *Imagem* .

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FlgpOwJZHPh4UAnrEyoZ2%2FScreenshot%202026-05-18%20at%2009.26.52.png?alt=media&#x26;token=6430a500-8532-4fda-9789-1c879854cb67" alt="" width="295"><figcaption></figcaption></figure></div>

#### **Substituir imagens ou logotipos**

1. Na tela de edição, selecione a foto que você quer alterar.
2. No menu **Editar** , selecione ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[Remover]** e depois selecione **Escolher arquivo** para enviar uma nova imagem.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FnLgD9kbzviI0PLgHBwi2%2FScreenshot%202026-05-18%20at%2009.27.57.png?alt=media&#x26;token=f6eddd68-8246-4d60-8470-ab4cf3a66c9a" alt="" width="299"><figcaption></figcaption></figure></div>

3. Envie a imagem usando um destes métodos:
   * Arraste e solte a imagem
   * Procure um arquivo no seu computador
   * Na guia *Endereço da Web* , cole o URL público do arquivo
4. Selecionar **Concluído**.

#### **Ajustar quais botões de compartilhamento são exibidos**

Você pode editar os botões de compartilhamento existentes usando a opção **Editar** menu.

1. Selecione no canvas o botão de compartilhamento que você quer editar.
2. Na **Edição** aba, selecione o nome do site ou serviço na seção *Meio de compartilhamento* .

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNvgjnWp81PZSbXRInnFF%2FScreenshot%202026-05-18%20at%2009.30.34.png?alt=media&#x26;token=a9e03a88-d25c-4f80-a304-a922741ca5d2" alt="" width="296"><figcaption></figcaption></figure></div>

Adicione um novo botão de compartilhamento usando o menu **Adicionar** menu.

1. Na **Adicionar** aba, selecione **Compartilhamento**.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FAjOJfvj8X7nfL0AAJTJK%2FScreenshot%202026-05-18%20at%2009.31.51.png?alt=media&#x26;token=5abcab17-8b61-4df8-892b-41db83253eb3" alt="" width="283"><figcaption></figcaption></figure></div>

2. Selecione o cartão apropriado.
3. Selecione o botão azul **Adicionar a** para inserir o componente no canvas.
   {% endstep %}

{% step %}

### **Etapa 4: visualizar e salvar**

1. Visualize como o widget aparecerá para seus participantes selecionando ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-190c6a03e6a68d67509d00452b10fd803bee5c87%2F57c7cba09bd1b97dd75b7c245e517c8d1ca0469d7c57bdc13ee6e427b75a860a.svg?alt=media) **\[Visualizar]** na barra de menu superior.
   * Você pode alternar entre a visualização da experiência em ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ae8027a26340e35a4d47f2a067cfadc9fc78113f%2F286f2a6c1251052ae82b73cd1c52b622b18f5203ba9cc10fde4d74292ac28d34.png?alt=media) **\[Computador]**, ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-deeb14b0e398d5dbb2dfb280d3fd7d8e9411b26e%2F74c7be4be7f1d77a3793767c29c5bd878acceacf1d2533055231d5110b12dd61.png?alt=media) **\[Tablet]**, ou ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6156958cf5fc18498276161791a0514d9005d7cf%2F906c40a4da5b9c02a51450974f61a71761acc07baff3052b53f708d5b768a9be.png?alt=media) **\[Celular]** para os usuários, selecionando o ícone do dispositivo correspondente.
2. Para voltar à interface de edição, selecione ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-60e9ace573178da411cb3be9c6f3b0f4b7e5b524%2F4094fadf599e544cfc618c18eb22087defdb9be38a580cd0041a242a88294e1e.svg?alt=media) **\[Editar]** na barra de menu superior.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FLtrKm25PXlhbzNvd63Kd%2FScreenshot%202026-05-18%20at%2009.32.48.png?alt=media&#x26;token=6e306358-0acf-4592-bcdd-5122c7fee062" alt="" width="563"><figcaption></figcaption></figure></div>

3. **Salvar** suas alterações.

{% hint style="warning" %}
**Aviso:** O editor de widgets não salva suas alterações automaticamente. Clique em **Salvar** com frequência para garantir que você não perca seu trabalho.
{% endhint %}

Ao selecionar **Salvar**, as alterações serão adicionadas ao rascunho do seu programa.
{% endstep %}
{% endstepper %}

## Opções avançadas de personalização

Os componentes avançados permitem incluir conteúdo condicional com base no *e-mail*, *segmento*, ou *campo personalizado*. Por exemplo, se você quiser exibir um placar apenas para participantes assinantes do nível ouro, o componente **seção condicional por segmento** permitirá que você faça isso.

Você pode adicionar componentes avançados a partir de **Adicionar** aba. Configurá-las exige um pouco mais de trabalho, pois você precisará inserir uma [expressão JSONata](http://docs.jsonata.org/overview.html) na *caixa Condição* que define a lógica para determinar quando a condição é atendida. Entre em contato com nossa [equipe de suporte](mailto:saasquatch-support@impact.com) se precisar de ajuda.

## Saiba mais

* [Edite o HTML do seu widget ou microsite para o Advocate](#access-the-widget-editor-0-0)
* [Instale pacotes NPM personalizados para o Advocate](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/install-custom-npm-packages-for-advocate.md)


---

# 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://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.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.
