---
title: "Como configurar o Widget de pesquisas do CustomerX"
description: "Saiba passo-a-passo como adicionar o widget de pesquisa a sua aplicação."
url: https://ajuda.customerx.com.br/pt-br/articles/84-como-configurar-o-widget-de-pesquisas-do-customerx
collection: "Pesquisas"
updated: 2026-09-14
language: pt-br
---

# Como configurar o Widget de pesquisas do CustomerX

Saiba passo-a-passo como adicionar o widget de pesquisa a sua aplicação.

## **Introdução**

O Widget de pesquisas é uma ferramenta simples que você pode adicionar ao seu site para aumentar a participação nas suas pesquisas de satisfação. Ele é seguro, rápido e não afeta o tempo de carregamento do seu site.

## **Como adicionar o Widget**

Para adicionar o Widget ao seu site, você precisa copiar e colar um pequeno código em todas as páginas onde deseja que o widget apareça. Geralmente, isso pode ser feito incluindo o script no arquivo de template do seu site.

### **Adicionar o script principal**

Cole o seguinte script antes do final da tag "<head>" em suas páginas HTML:

```javascript
<script type="text/javascript">
  (function(i,s,o,g,r,a,m,n){
    i['CustomerXSurveyObject']=r;
    n = r.split('.');
    r = n[n.length - 1], i = n.slice(0, -1).reduce(function(o, p){
        if (!o[p]) {
            o[p] = {};
        }
        return o[p];
    }, i);
    i[r]=i[r]||function() {
        (i[r].q=i[r].q||[]).push(arguments)
    },i[r].l=1*new Date();
    a=s.createElement(o),m=s.getElementsByTagName(o)[0];
    a.async=1;
    a.src=g;
    m.parentNode.insertBefore(a,m)
  })(window,document,'script', 'https://survey-widget.customerx.com.br/embed.js', 'cx.survey');
</script>
```

### **Configurar o Widget para sua empresa**

Após adicionar o script principal, insira o código de configuração logo em seguida para autorizar o uso e identificar sua empresa e o usuário:

```javascript
cx.survey('authorize', 'SEU_TOKEN_DE_AUTORIZAÇÃO');
cx.survey('identify', {external_id_client: 'ID_DO_CLIENTE', email: 'EMAIL_DO_USUÁRIO_LOGADO'});
cx.survey('start', 'nps');
```

### **Identificando o usuário**

-   Existem duas formas de identificar o usuário: 
    
    -   Pelo e-mail, note que a linha é a mesma do código anterior!
        
        -   `cx.survey('identify', {external_id_client: 'ID_DO_CLIENTE', email: 'EMAIL_DO_USUÁRIO_LOGADO'});`
            
    -   ou, pelo código do contato:
        
        -   `cx.survey('identify', {external_id_client: 'ID_DO_CLIENTE', external_id_contact: 'CÓDIGO_DO_USUÁRIO'});`  
            
-   **SEU\_TOKEN\_DE\_AUTORIZAÇÃO:** Substitua pelo token fornecido para sua organização. Você poderá encontrar ele acessando a plataforma CustomerX no Painel de NPS, no menu de mais opções "Widget NPS".  
    
    ![](https://staticfiles.gleap.io/ghelparticle/rHo9qACPgfaBLPJ5KkdRB5rG39Lq62z6atjuQU4hkwJppghok8tQjhlPN6pIQSne0kJe2NbByFQ.png)
    
-   **ID\_DO\_CLIENTE:** Substitua pelo código(external\_id) do seu cliente conforme cadastrado no CustomerX.
    
-   Identificação do contato/usuário (escolha uma das opções):
    
    -   **EMAIL\_DO\_USUÁRIO\_LOGADO:** Substitua pelo email do usuário logado.
        
    -   **CÓDIGO\_DO\_USUÁRIO**: Substitua pelo código do usuário logado.
        

### **Encerrar ou limpar o Widget**

Se precisar desativar o Widget, como em um logoff ou em aplicações de página única, você pode usar os seguintes comandos:

-   **Parar o Widget:** Para interromper a busca por novas pesquisas.
    
    ```javascript
    cx.survey('stop', 'nps');
    ```
    
-   **Limpar o Widget:** Para parar a busca por novas pesquisas e limpar os cookies usados pelo widget.
    
    ```javascript
    cx.survey('clear', 'nps', 'all');
    ```
    
    **Pronto! O Widget de pesquisas agora está integrado ao seu site.**
    

## **Verificar o status do Widget**

Para verificar o status atual do Widget de pesquisas em sua aplicação, você pode utilizar um comando especial que fornece informações detalhadas sobre o estado do widget, incluindo a autorização, identificação do usuário e se há pesquisas ativas ou não.

-   **Como usar o comando de status:** Para executar a verificação de status, você pode inserir o seguinte comando no console do navegador:
    
    ```javascript
    cx.survey('status');
    ```
    
-   Este comando executa uma função que verifica várias condições para garantir que tudo está configurado corretamente:
    
    -   **Verificações realizadas:**
        
        -   **Autorização:** Confirma se a autorização foi configurada corretamente.
            
        -   **Identificação do usuário:** Verifica se o usuário está identificado no Widget.
            
        -   **Modo de espera:** Verifica se o Widget está em modo de espera ou se está ativo.
            
        -   **Estado da pesquisa:** Informa se há uma pesquisa ativa ou se nenhuma pesquisa foi encontrada.
            
    -   Cada condição é verificada e, se algum problema for encontrado, uma mensagem específica será exibida, ajudando você a entender e corrigir possíveis problemas com a configuração do Widget em seu site.
        
        -   **Exemplos de mensagens de status:**
            
            -   **CX - Authorization not found**: Indica que a autorização não foi encontrada.
                
            -   **CX - Identify not set**: Mostra que o usuário não foi identificado corretamente.
                
            -   **CX - User defined, sleep mode**: Indica que o Widget está em modo de espera.
                
            -   **CX - User logged successfully, active survey**: Confirma que o usuário está logado e há uma pesquisa ativa.
                
            -   **CX - User logged successfully, no survey found**: Informa que o usuário está logado, mas não há pesquisas disponíveis no momento.
                
            -   **CX - User defined, waiting surveys**: Avisa que o usuário está esperando por pesquisas.
                

Dúvidas e Suporte  
Caso tenha dúvidas ou precise de ajuda durante o processo de configuração do Widget de pesquisas, entre em contato com nossa equipe de suporte. Estamos aqui para ajudá-lo!
